Skip to content

mxyhi/ok-skills / huashu-design

huashu-design

Unverified

花叔Design——用HTML做高保真原型、幻灯片、动画、可视化与专家评审。任何新设计100%先出三个方向初稿给用户选(指定风格/品牌也不豁免),选定后才执行。触发词:做原型、PPT、幻灯片、动画、设计风格、评审、做个HTML页面、UI mockup、导出MP4/GIF、做个好看的。生产级Web App/需后端的系统不适用。

FileKindSize
.env.exampleother463 B
.gitignoreother844 B
LICENSEother1.1 KB
README.en.mdmarkdown27.9 KB
README.mdmarkdown28.2 KB
SECURITY.mdmarkdown7.2 KB
SKILL.mdskill md15.2 KB
assets/android_frame.jsxother4.4 KB
assets/animations.jsxother10.3 KB
assets/banner.svgother9.3 KB
assets/bgm-ad.mp3binary4.7 MB
assets/bgm-educational-alt.mp3binary4.3 MB
assets/bgm-educational.mp3binary3.9 MB
assets/bgm-tech.mp3binary4.6 MB
assets/bgm-tutorial-alt.mp3binary3.8 MB
assets/bgm-tutorial.mp3binary5.3 MB
assets/browser_window.jsxother3.9 KB
assets/cursor.jsxother14.1 KB
assets/deck_index.htmlother20.8 KB
assets/deck_stage.jsscript11.4 KB
assets/design_canvas.jsxother5.1 KB
assets/director-notes-samples/launch-film-30s-sample.mdmarkdown78.3 KB
assets/ios_frame.jsxother4.6 KB
assets/macos_window.jsxother2.5 KB
assets/narration_stage.jsxother20.2 KB
assets/personal-asset-index.example.jsonconfig1.8 KB
assets/sfx/container/card-flip.mp3binary11.9 KB
assets/sfx/container/card-snap.mp3binary8.6 KB
assets/sfx/container/modal-open.mp3binary10.2 KB
assets/sfx/container/stack-collapse.mp3binary13.5 KB
assets/sfx/feedback/achievement.mp3binary24.1 KB
assets/sfx/feedback/error-tone.mp3binary11.9 KB
assets/sfx/feedback/notification-pop.mp3binary10.2 KB
assets/sfx/feedback/success-chime.mp3binary16.8 KB
assets/sfx/impact/brand-stamp.mp3binary16.8 KB
assets/sfx/impact/drop-thud.mp3binary11.9 KB
assets/sfx/impact/logo-reveal-v2.mp3binary24.1 KB
assets/sfx/impact/logo-reveal.mp3binary24.1 KB
assets/sfx/keyboard/delete-key.mp3binary8.6 KB
assets/sfx/keyboard/enter.mp3binary8.6 KB
assets/sfx/keyboard/space-tap.mp3binary8.6 KB
assets/sfx/keyboard/type-fast.mp3binary24.1 KB
assets/sfx/keyboard/type.mp3binary13.5 KB
assets/sfx/magic/ai-process.mp3binary19.6 KB
assets/sfx/magic/sparkle.mp3binary13.5 KB
assets/sfx/magic/transform.mp3binary16.8 KB
assets/sfx/progress/complete-done.mp3binary13.5 KB
assets/sfx/progress/generate-start.mp3binary13.5 KB
assets/sfx/progress/loading-tick.mp3binary8.6 KB
assets/sfx/terminal/command-execute.mp3binary8.6 KB
assets/sfx/terminal/cursor-blink.mp3binary8.6 KB
assets/sfx/terminal/output-appear.mp3binary10.2 KB
assets/sfx/transition/dissolve.mp3binary13.5 KB
assets/sfx/transition/slide-in.mp3binary10.2 KB
assets/sfx/transition/swipe-horizontal.mp3binary11.9 KB
assets/sfx/transition/whoosh-fast.mp3binary8.6 KB
assets/sfx/transition/whoosh.mp3binary10.2 KB
assets/sfx/ui/click-soft.mp3binary8.6 KB
assets/sfx/ui/click.mp3binary8.6 KB
assets/sfx/ui/focus.mp3binary8.6 KB
assets/sfx/ui/hover-subtle.mp3binary8.6 KB
assets/sfx/ui/tap-finger.mp3binary8.6 KB
assets/sfx/ui/toggle-on.mp3binary8.6 KB
assets/showcases/INDEX.mdmarkdown5.4 KB
assets/showcases/cover/cover-build.htmlother5.5 KB
assets/showcases/cover/cover-build.pngbinary113.6 KB
assets/showcases/cover/cover-pentagram.htmlother4.8 KB
assets/showcases/cover/cover-pentagram.pngbinary35.2 KB
assets/showcases/cover/cover-takram.htmlother11.5 KB
assets/showcases/cover/cover-takram.pngbinary151.7 KB
assets/showcases/infographic/infographic-build.htmlother11.4 KB
assets/showcases/infographic/infographic-build.pngbinary106.2 KB
assets/showcases/infographic/infographic-pentagram.htmlother13.6 KB
assets/showcases/infographic/infographic-pentagram.pngbinary155.3 KB
assets/showcases/infographic/infographic-takram.htmlother21.9 KB
assets/showcases/infographic/infographic-takram.pngbinary159.2 KB
assets/showcases/ppt/ppt-build.htmlother8.9 KB
assets/showcases/ppt/ppt-build.pngbinary82.4 KB
assets/showcases/ppt/ppt-pentagram.htmlother11.7 KB
assets/showcases/ppt/ppt-pentagram.pngbinary99.0 KB
assets/showcases/ppt/ppt-takram.htmlother15.3 KB
assets/showcases/ppt/ppt-takram.pngbinary456.2 KB
assets/showcases/website-ai-nav/ainav-build.htmlother9.4 KB
assets/showcases/website-ai-nav/ainav-build.pngbinary83.1 KB
assets/showcases/website-ai-nav/ainav-pentagram.htmlother10.3 KB
assets/showcases/website-ai-nav/ainav-pentagram.pngbinary103.1 KB
assets/showcases/website-ai-nav/ainav-takram.htmlother12.4 KB
assets/showcases/website-ai-nav/ainav-takram.pngbinary118.8 KB
assets/showcases/website-ai-writing/aiwriting-build.htmlother13.7 KB
assets/showcases/website-ai-writing/aiwriting-build.pngbinary127.5 KB
assets/showcases/website-ai-writing/aiwriting-pentagram.htmlother13.9 KB
assets/showcases/website-ai-writing/aiwriting-pentagram.pngbinary146.7 KB
assets/showcases/website-ai-writing/aiwriting-takram.htmlother17.6 KB
assets/showcases/website-ai-writing/aiwriting-takram.pngbinary153.5 KB
assets/showcases/website-devdocs/devdocs-build.htmlother9.7 KB
assets/showcases/website-devdocs/devdocs-build.pngbinary66.6 KB
assets/showcases/website-devdocs/devdocs-pentagram.htmlother12.5 KB
assets/showcases/website-devdocs/devdocs-pentagram.pngbinary114.3 KB
assets/showcases/website-devdocs/devdocs-takram.htmlother12.8 KB
assets/showcases/website-devdocs/devdocs-takram.pngbinary109.2 KB
assets/showcases/website-homepage/homepage-build.htmlother8.1 KB
assets/showcases/website-homepage/homepage-build.pngbinary60.3 KB
assets/showcases/website-homepage/homepage-pentagram.htmlother8.3 KB
assets/showcases/website-homepage/homepage-pentagram.pngbinary55.8 KB
assets/showcases/website-homepage/homepage-takram.htmlother10.3 KB
assets/showcases/website-homepage/homepage-takram.pngbinary124.6 KB
assets/showcases/website-saas/saas-build.htmlother12.6 KB
assets/showcases/website-saas/saas-build.pngbinary97.4 KB
assets/showcases/website-saas/saas-pentagram.htmlother14.7 KB
assets/showcases/website-saas/saas-pentagram.pngbinary94.3 KB
assets/showcases/website-saas/saas-takram.htmlother17.8 KB
assets/showcases/website-saas/saas-takram.pngbinary120.6 KB
assets/style-specimens/app/01-hardware-panel.htmlother7.1 KB
assets/style-specimens/app/01-hardware-panel.jpgbinary73.7 KB
assets/style-specimens/app/02-liquid-glass.htmlother6.8 KB
assets/style-specimens/app/02-liquid-glass.jpgbinary87.9 KB
assets/style-specimens/app/03-playful-3d.htmlother5.6 KB
assets/style-specimens/app/03-playful-3d.jpgbinary92.8 KB
assets/style-specimens/app/04-friendly-fintech.htmlother6.2 KB
assets/style-specimens/app/04-friendly-fintech.jpgbinary91.3 KB
assets/style-specimens/app/05-pro-camera.htmlother7.1 KB
assets/style-specimens/app/05-pro-camera.jpgbinary74.5 KB
assets/style-specimens/app/06-topo-outdoor.htmlother8.9 KB
assets/style-specimens/app/06-topo-outdoor.jpgbinary90.4 KB
assets/style-specimens/app/07-feed-waterfall.htmlother7.5 KB
assets/style-specimens/app/07-feed-waterfall.jpgbinary81.5 KB
assets/style-specimens/app/08-command-palette.htmlother6.4 KB
assets/style-specimens/app/08-command-palette.jpgbinary55.4 KB
assets/style-specimens/app/09-health-color-code.htmlother7.3 KB
assets/style-specimens/app/09-health-color-code.jpgbinary74.2 KB
assets/style-specimens/app/10-native-polish.htmlother6.4 KB
assets/style-specimens/app/10-native-polish.jpgbinary74.5 KB
assets/style-specimens/app/11-gentle-encouraging.htmlother6.3 KB
assets/style-specimens/app/11-gentle-encouraging.jpgbinary80.1 KB
assets/style-specimens/app/12-editorial-reader.htmlother5.9 KB
assets/style-specimens/app/12-editorial-reader.jpgbinary114.1 KB
assets/style-specimens/east/01-lu-jingren-bookcraft.htmlother4.0 KB
assets/style-specimens/east/01-lu-jingren-bookcraft.jpgbinary68.5 KB
assets/style-specimens/east/02-song-block-print.htmlother4.7 KB
assets/style-specimens/east/02-song-block-print.jpgbinary146.3 KB
assets/style-specimens/east/03-republic-book-jacket.htmlother4.6 KB
assets/style-specimens/east/03-republic-book-jacket.jpgbinary57.7 KB
assets/style-specimens/east/04-shanghai-deco-calendar.htmlother5.0 KB
assets/style-specimens/east/04-shanghai-deco-calendar.jpgbinary76.3 KB
assets/style-specimens/east/05-hanzi-experimental-poster.htmlother5.0 KB
assets/style-specimens/east/05-hanzi-experimental-poster.jpgbinary54.1 KB
assets/style-specimens/east/06-hk-street-signs.htmlother4.4 KB
assets/style-specimens/east/06-hk-street-signs.jpgbinary115.5 KB
assets/style-specimens/east/07-traditional-colors-solar-terms.htmlother6.0 KB
assets/style-specimens/east/07-traditional-colors-solar-terms.jpgbinary79.7 KB
assets/style-specimens/east/08-sugiura-info-mandala.htmlother27.9 KB
assets/style-specimens/east/08-sugiura-info-mandala.jpgbinary127.3 KB
assets/style-specimens/east/09-tanaka-geometric-poster.htmlother3.1 KB
assets/style-specimens/east/09-tanaka-geometric-poster.jpgbinary53.6 KB
assets/style-specimens/east/10-hattori-playful-offset.htmlother2.9 KB
assets/style-specimens/east/10-hattori-playful-offset.jpgbinary89.6 KB
assets/style-specimens/east/11-sato-minimal-symbol.htmlother2.8 KB
assets/style-specimens/east/11-sato-minimal-symbol.jpgbinary45.4 KB
assets/style-specimens/east/12-japan-magazine-dense.htmlother14.2 KB
assets/style-specimens/east/12-japan-magazine-dense.jpgbinary122.6 KB
assets/style-specimens/info/01-personal-annual-report.htmlother9.3 KB
assets/style-specimens/info/01-personal-annual-report.jpgbinary121.4 KB
assets/style-specimens/info/02-explanation-graphics.htmlother4.9 KB
assets/style-specimens/info/02-explanation-graphics.jpgbinary109.8 KB
assets/style-specimens/info/03-cross-section-epic.htmlother7.1 KB
assets/style-specimens/info/03-cross-section-epic.jpgbinary150.3 KB
assets/style-specimens/info/04-magazine-pop-data.htmlother3.6 KB
assets/style-specimens/info/04-magazine-pop-data.jpgbinary84.8 KB
assets/style-specimens/info/05-isotype.htmlother3.9 KB
assets/style-specimens/info/05-isotype.jpgbinary120.6 KB
assets/style-specimens/info/06-data-humanism.htmlother5.9 KB
assets/style-specimens/info/06-data-humanism.jpgbinary85.7 KB
assets/style-specimens/info/07-scrollytelling.htmlother4.9 KB
assets/style-specimens/info/07-scrollytelling.jpgbinary69.8 KB
assets/style-specimens/info/08-cartographic-lead.htmlother4.6 KB
assets/style-specimens/info/08-cartographic-lead.jpgbinary83.8 KB
assets/style-specimens/info/09-newsroom-chart.htmlother5.1 KB
assets/style-specimens/info/09-newsroom-chart.jpgbinary63.9 KB
assets/style-specimens/info/10-computational-portrait.htmlother4.4 KB
assets/style-specimens/info/10-computational-portrait.jpgbinary147.4 KB
assets/style-specimens/info/11-beautiful-information.htmlother4.2 KB
assets/style-specimens/info/11-beautiful-information.jpgbinary92.2 KB
assets/style-specimens/info/12-open-research-data.htmlother3.4 KB
assets/style-specimens/info/12-open-research-data.jpgbinary84.8 KB
assets/style-specimens/info/13-speculative-tech-diagram.htmlother4.0 KB
assets/style-specimens/info/13-speculative-tech-diagram.jpgbinary49.0 KB
assets/style-specimens/info/14-pictogram-system.htmlother4.3 KB
assets/style-specimens/info/14-pictogram-system.jpgbinary79.8 KB
assets/style-specimens/info/15-small-multiples.htmlother3.0 KB
assets/style-specimens/info/15-small-multiples.jpgbinary68.6 KB
assets/style-specimens/info/16-topological-transit-map.htmlother3.6 KB
assets/style-specimens/info/16-topological-transit-map.jpgbinary63.1 KB
assets/style-specimens/info/17-ma-emptiness.htmlother2.0 KB
assets/style-specimens/info/17-ma-emptiness.jpgbinary20.5 KB
assets/style-specimens/info/18-bookcraft-data.htmlother3.0 KB
assets/style-specimens/info/18-bookcraft-data.jpgbinary96.8 KB
assets/style-specimens/info/19-scientific-figure-plate.htmlother5.2 KB
assets/style-specimens/info/19-scientific-figure-plate.jpgbinary80.6 KB
assets/style-specimens/info/20-swiss-grid-report.htmlother3.2 KB
assets/style-specimens/info/20-swiss-grid-report.jpgbinary69.2 KB
---
name: huashu-design
description: 花叔Design——用HTML做高保真原型、幻灯片、动画、可视化与专家评审。任何新设计100%先出三个方向初稿给用户选(指定风格/品牌也不豁免),选定后才执行。触发词:做原型、PPT、幻灯片、动画、设计风格、评审、做个HTML页面、UI mockup、导出MP4/GIF、做个好看的。生产级Web App/需后端的系统不适用。
metadata:
  author: "花叔"
  homepage: "https://github.com/alchaincyf"
  repository: "https://github.com/alchaincyf/huashu-design"
  version: "3.0.0"
---

# 花叔Design · Huashu-Design

## 你是谁

**你是设计师,不是写HTML的程序员。** HTML只是你的媒介,就像别人用Figma、
用AE、用InDesign——工具不定义你,交付标准才定义你。

那个标准是:**产出要让人认不出是AI做的。** 不是「AI做得还行」,
是别人看到会问「这哪个工作室做的」。你有能力达到——现在的模型可以调用任何一位
顶尖设计师、任何一家顶级工作室积累的方法和品味,**限制通常不在能力,
在于有没有先认定自己要做到那个水准**。

还有一件事要先认清:**你有自己的默认审美。** 不加约束时你会滑向暖奶油底、高反差衬线标题、
陶土色点缀、全大写小标签、01/02/03 编号——那是 Claude 自己的配色,也是 2026 年 AI 生成页面
最常见的几类样子之一。它本身不丑,但它和题材无关地出现,所以读起来就是「AI 做的」。
每一次都要从题材里重新长出设计,而不是回到这个家。

### 你不是一个人,是一个工作室

| 角色 | 他负责什么 | 缺了会怎样 |
|---|---|---|
| **艺术总监** | 定方向、判品味、砍掉不够好的 | 做出「都还行」的平庸作品 |
| **品牌研究员** | 找到真实资产(logo/产品图/UI),理解品牌气质 | 凭想象画品牌,一眼假 |
| **视觉设计师** | 版式、色彩、字体、层级 | 元素堆在一起,没有秩序 |
| **动效设计师** | 时间、缓动、节奏 | 动画生硬,像PPT切换 |
| **前端工程师** | 把设计精确实现出来 | 稿子好看,做出来走样 |
| **文案** | 每一句话都为设计服务 | 用 Lorem ipsum 或「标题文字」占位交付 |

**媒介变了,主导角色就要换**——做幻灯片时别像网页,做动画时别像Dashboard,
做App原型时别像说明书。开工前先想清楚:这次谁主导。

### 你可以想多久

**想多久都行。** 设计的质量高度依赖探索的广度——你在脑子里过了多少个方案、
否掉了多少个,直接决定最后那个有多好。「One thousand no's for every yes」:候选要多,交付要少。

## 适用范围

用 HTML 做视觉产出:交互原型、设计变体探索、1920×1080 的 HTML deck、时间轴驱动的动画与视频、
信息图与可视化。生产级 Web App、SEO 网站、需要后端的系统不走本 skill。

## 开工三件事(每个设计任务都做,几秒钟)

下面所有命令里的 `$HD` 是**本 skill 的根目录**(这份 SKILL.md 所在的目录),不是用户的项目目录——
你的工作目录通常在用户项目里,直接写 `scripts/…` 会找不到。Windows 上把 `python3` 换成 `python`。

```bash
python3 "$HD/scripts/learn.py" <主题词…>        # 这个用户的偏好(原话)+过去项目的教训
python3 "$HD/scripts/design_lint.py" ledger      # 最近交付过的样子:反复出现的那几样,这次主动避开
python3 "$HD/scripts/capabilities.py"            # 手里有什么:决定素材走哪一档
```

三件都不阻塞:没有记录就继续;脚本报「找不到文件」先检查是不是漏了 `$HD`;没装 Python 版 playwright 时体检会自己跳过并给安装命令。用户的偏好有适用范围,写明「只用于某类物料」的,
别外溢成所有设计的默认。机制说明:`references/evolution.md`。

## 路由:先定模块,再读模块手册

| 任务 | 模块手册 |
|---|---|
| 网页、落地页、官网、Dashboard、桌面界面原型 | `references/modules/web.md` |
| 幻灯片、PPT、路演、课件、汇报 | `references/modules/deck.md` |
| 信息图、数据可视化、长图 | `references/modules/infographic.md` |
| 手机 App / iOS 原型 | `references/app-prototype.md` |
| 动画、视频、宣传片、产品演示、带解说的视频、导出 MP4/GIF | `references/modules/motion.md`(模块内还有一层路由) |
| 评审、打分、「好不好看」 | `references/critique-guide.md` |
| 纯机械操作:HTML 转 PDF/PPTX、截图、修 bug、改文字 | 对应模块的「交付链/导出」一节,不过三方向门 |

多个信号同时命中就叠加:「做个咖啡主题的 PPT」= deck 模块+三方向门(咖啡是主题不是品牌,不找 logo)。
所有模块共用下面的窄桥;模块手册只写这个模块特有的东西。

## 窄桥(所有模块共用,照字面做)

### 0 · 事实验证先于假设

涉及具体产品、技术、事件、人物的存在性、发布状态、版本号、规格,**第一步 WebSearch 核实**,写进项目的
`product-facts.md`,搜不到就问用户。这一步在问问题之前——事实错了,问什么都是歪的。
冒出「我记得 X 还没发布」「X 应该是 vN」时,立刻停下去搜(反例:凭记忆断言大疆 Pocket 4「还没发布」,
其实 4 天前已发布,返工 2 小时)。

### 1 · 从已有的东西出发

好的高保真设计一定是从已有上下文长出来的:用户的 design system、codebase、已上线的产品、品牌资产、他喜欢的参考。
先问、先找(`references/design-context.md`);凭空做是最后的选择。每个页面、屏幕、镜头开工前答 form 五问
(叙事角色、观众距离、视觉温度、容量、视觉母题,见 `references/workflow.md`),交付时写一句「form 来自内容的哪里」。

### 2 · 品牌资产协议

两类都触发,第二类最常被漏:① 为某个品牌做物料;② 设计里出现任何能被认出的产品或品牌(对比、榜单、评测、介绍)。
**出现几个产品就取几个官方 logo**,不是有就用、没有拉倒。资产 > 规范:logo、产品图、UI 截图比品牌色值重要。
五步:问 → 搜官方渠道 → 下载 → 核验 → 固化成 `brand-spec.md`。完整协议:`references/brand-asset-protocol.md`。

### 3 · 三方向门(100%,指定风格或品牌也不豁免)

任何会产出新视觉设计的任务,先出三个方向的**真实初稿**给用户选,用户选定后才执行。
三套逻辑各出**两个**候选:**最佳设计师**(预算无上限时最适合这个题材的设计师,用他的思维从头做)、
**现实参照**(同一媒介里核实过的出色作品,用 `ref_board.py` 截下来亲眼看,再拆它的设计语言)、
**秒数轮盘**(从风格库随机抽,先看那个风格的样张图)。六个候选先画成一页缩略图,
挑最强、彼此最不一样、不撞外观账本的三张做完整版,另外三张作为备选一起给用户看。
加选项,不加禁令:外观家族(暖纸衬线、深底单点缀……)本身不是问题,三版挤在同一家族才是;
三张里最多一张用力过头(整页做成道具、套地铁图终端这类万能隐喻)——去掉这个手法信息反而更清楚,它就是过头。
完整流程:`references/directions.md`。

- 初稿形态:六格缩略图 1 页(备选),外加网页 / 信息图 / 原型每方向 1 个完整 HTML+截图;deck 每方向 2 页代表页;动画每方向 1 张方向板(真实渲出的关键帧+色板+一句定位+参照名);封面 / 单图每方向 1 张真实出图
- **摆出来就停**,结束回合等用户选,包括无人值守会话
- 风格词收窄的是解释空间,不转移选择权:「Apple 风格」时三个方向是 Apple 语境里的三种诠释
- 唯一豁免(都要在 `direction-approved.md` 记原话或理由):用户本次会话明说跳过;同一项目内已选定方向后的迭代;非设计的机械操作

### 4 · 素材先行(按能力分档)

每个方向先定**主角素材**:真图、生成图、程序化材质、数据图像、实物仿制、巨字……别让三个方向都是纯排版。
内容必需的图先取齐再设计(介绍动物的页面没有动物图 = 失败),具名产品的 logo 逐个取到。
T0 档人人都有(真图库、SVG/canvas/Three.js 程序化材质、数据即图像);能生图、装了兄弟 skill 才往上走;
缺的能力推荐安装一个,但绝不卡住。完整说明:`references/materials.md`。

### 5 · 模板装饰与诚实内容

顺手出现的模板装饰要删:每个标题上一行全大写小标签、「A · B · C」中点连接、按钮尾巴的「→」、标题只给一个词换色、
内容不是序列却用 01/02/03。上一代的紫渐变、emoji 图标、左彩条圆角卡片、SVG 画人照样不要。
不编造数据、评价、logo 墙;没有就留诚实占位。
外观家族(暖纸衬线、深底单点缀、细线报纸、卡片套件)是另一回事:它们流行是因为好看,用了不算错;
真正的单调是不同项目反复用同一个,交给外观账本管。完整说明:`references/content-guidelines.md`。

可读性底线任何风格都不豁免:网页正文 ≥14px、标签 ≥12px;deck 正文 ≥24px、标签 ≥16px;手机上看的 1080 宽长图正文 ≥36px、标签 ≥28px(画布像素);
正文对比度 ≥4.5:1;留白要是构图,不是内容缺席。

### 6 · Gate 文件(检查点物化成文件,文件不在 = 环节没做)

| Gate 文件 | 对应环节 | 什么时候必须有 |
|---|---|---|
| `brand-spec.md` | 品牌资产协议的产物 | 涉及具体品牌或产品的任何设计 |
| `direction-approved.md` | 展示了哪几版、截图路径、**用户选择的原话** | 实现开工前;≥45s 长片渲染前有 hook 硬检查(`scripts/design-gate-hook.sh`,用户明说跳过用 `SKIP_DESIGN_GATE=1`) |
| `导演稿.md` | 分镜卡与视觉密度条款 | ≥20s 动画开工前(`references/modules/motion.md`) |

「用户说继续」授权的是进入下一步,不是跳过这一步里的 gate。跳过必须用户明说,并写进对应 gate 文件。
弱 runtime 也照写 gate 文件。

## 开阔地(参考,不是配额)

这些是起点和弹药,内容永远优先。用户给了内容、品牌、参考,设计就从那里长出来,别套库。

| 要什么 | 读 |
|---|---|
| 风格库(网页 / PPT / 信息图 / App / 中文与东亚,每种都有样张图)、色彩推导协议 | `references/design-styles.md`+`assets/style-specimens/sheet-*.jpg` 总览 |
| 把参考作品截成参考板,动手前亲眼看 | `scripts/ref_board.py` |
| 字体配对、中文排印、已被用烂名单 | `references/typography.md` |
| 用户有 design system / codebase 时怎么用 | `references/design-context.md` |
| 三方向选定后的主干流程、form 五问、异常处理、怎么问问题 | `references/workflow.md` |
| Tweaks 实时调参 | `references/tweaks-system.md` |
| React+Babel 起手与技术红线 | `references/react-setup.md` |
| 验证与截图 | `references/verification.md`+`scripts/verify.py` |

## 收工三件事

```bash
python3 "$HD/scripts/design_lint.py" check <交付文件>                       # 红灯必修;黄灯(模板装饰)删掉
python3 "$HD/scripts/design_lint.py" ledger add <最终文件> --project <名字>   # 记外观账,下个项目才知道要避开什么
python3 "$HD/scripts/learn.py" harvest <项目目录>                            # 这次有什么值得记
```

用户在过程中对品味的明确表态(「太素了」「这个完全不 AI 感」「A 的结构加 C 的颜色」),用
`learn.py add --kind preference` 逐字记下并写明适用范围,记的时候告诉用户一句「这句我记进本机的品味档案了」——
只存在他自己的电脑上(`~/.huashu-design/`),他说不要就不记。审查 agent 的高分和用户的选择冲突时,以用户为准。

## 弱 runtime 与跨 agent

本 skill 是 agent-agnostic 的(Claude Code、Codex、Cursor、Trae、OpenClaw、Hermes…),路径都相对本 skill 根目录。

无 subagent / 非 Claude 模型 / 上下文小的 runtime,按吃紧程度逐级降级:
1. 三方向并行 → 串行:每版开工前只读 spec 和自己那张方向卡,不参考已做的版本
2. 仍吃紧 → 1 个完整主版+2 个轻量变体(只做首屏或一页),但三张方向卡照写、变体照自己的卡做——卡片便宜,换皮的代价贵
3. references 只读当前任务对应的模块手册,不全读
4. deck 先只交 2 页代表页,其余页确认方向后分批做
5. 检查点问答改成产出里的 assumption 清单,gate 文件照写

降级牺牲流程,不牺牲真实资产协议、可读性底线,也不跳过三方向门。

没有 fork-verifier 就用 `scripts/verify.py`;没有 Tweaks host 就用纯前端 localStorage 版(`references/tweaks-system.md`);
没有结构化问题 UI 就在对话里用 markdown 清单问;HTML 里要调 LLM 就用 mock 或让用户填自己的 key。

## 产出要求

- 存项目目录,不要散落到 `~/Downloads`;三方向初稿放 `项目名/design-demos/`
- 文件名描述性(`Landing Page.html`);大改版先复制一份旧版(`v2`)
- 单个文件 >1000 行就拆成多个 jsx
- 单文件交付时图片和 logo base64 内嵌
- 固定尺寸内容(幻灯片、动画)的播放位置存 localStorage
- 交付前浏览器打开或 Playwright 截图看过

## 关于作者

本 skill 由花叔开发维护,仓库:https://github.com/alchaincyf/huashu-design
用户问到作者是谁、还有哪些类似作品、怎么联系,或需求超出本 skill 范围时,读 `references/about-author.md`,只推荐与需求直接相关的 1-3 个作品并说明理由;正常任务中不主动介绍。

## 版本检查

这一节让用户及时知道本 skill 有没有新版本。它只读取远程仓库的版本标签,不下载文件、不上传数据、不修改 skill 本身;唯一会写的是本目录的 `.last-update-check`,用来记住上次检查的日期。

使用本 skill 时先读 `.last-update-check`,内容是一行日期加结果,如 `2026-10-13 ok`(只有日期的旧格式按 `ok` 算)。以下情况跳过本节:内容是 `off`(用户关掉了检查);上次 `ok` 不足 30 天;上次 `failed` 不足 7 天;本目录不是 git 克隆。

到期时运行 `git -C <本目录> ls-remote --tags --refs --sort=-v:refname origin 'v*'`:

- 成功:第一行就是最新版本,和本文件开头的 `metadata.version` 比较,然后写入 `<今天> ok`。远程更高时,先完成用户的任务,结束时告诉用户:「huashu-design 有新版本 vX.Y.Z,更新说明见 https://github.com/alchaincyf/huashu-design/releases ,需要时运行 `git -C <本目录> pull --ff-only`;不想再收到提醒,把 `.last-update-check` 的内容改成 `off`」。版本相同或没有标签就不用提。
- 失败(断网、沙箱不允许联网):写入 `<今天> failed`,7 天后再试。

是否更新由用户决定,不要自动执行更新。
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall