_{🌐 <b>中文</b> · <a href="README.en.md">English</a>}

<div align="center">

Huashu Design

「打字。回车。一份能交付的设计。」 "Type. Hit enter. A finished design lands in your lap."

<br>

在你的 agent 里打一句话，拿回一份能交付的设计。

<br>

3 到 30 分钟，你能 ship 一段产品发布动画、一个能点击的 App 原型、一套能编辑的 PPT、一份印刷级的信息图。

不是「AI 做的还行」那种水平——是看起来像大厂设计团队做的。给 skill 你的品牌资产（logo、色板、UI 截图），它会读懂你的品牌气质；什么都不给，六张缩略图里挑出的三个真实方向 + 84 种带样张的风格库也能兜底到不出 AI slop。

你看到这篇 README 里的每一页设计，都是 huashu-design 自己做的。 不是 Figma，不是 AE，就是一句话 prompt + skill 跑通。下次产品发布要做宣传片？现在你也能做。

npx skills add alchaincyf/huashu-design

跨 agent 通用——Claude Code、Cursor、Codex、OpenClaw、Hermes 都能装。

📣 已改为 MIT 协议。 自 2026-05-14 起本 skill 完全开源（MIT License），个人和商用都免费，无需事先授权。原「个人使用免费、企业商用需授权」的条款已作废。(查看变更)

🆕 3.0：三个方向更敢，项目之间也不再长一个样。 先出六张缩略图再挑三版做成真稿；风格库扩到 84 种（新增 App、中文与东亚两个分区），每种都有样张；参照作品先截图再动手；带一个只量事实的设计体检，和一本记住你做过什么样子的外观账本。详见核心机制

看效果 · 安装 · 能做什么 · 核心机制 · 和 Claude Design 的关系

</div>

---

<p align="center"> <img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/launch-3.0.gif" alt="huashu-design 3.0 发布片" width="100%"> </p> <p align="center">_{▲ 3.0 发布片 · 32 秒 · 片里每一页设计都是 3.0 自己做的，剪辑用的是 <a href="https://github.com/alchaincyf/huashu-motion">huashu-motion</a><br> 👉 <a href="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/launch-3.0.mp4">下载 MP4（1080p · 含配乐 · 24MB）</a> · <a href="https://www.huasheng.ai/huashu-design-hero/">2.0 的带音效 HTML 互动版</a>}</p>

---

3.0 案例

下面这些都是 3.0 跑出来的。前五个是从发布时新跑的 6 道题里挑的，每道只给一句话需求，方向是 agent 自己挑的，作者没插手；后两个一个是第三轮盲选赢下来的那版，一个是发布后作者拿它做的真实项目。

网页 · 《富岳三十六景》线上展

「给葛饰北斋的《富岳三十六景》做一个线上展览网站」

三版分别是 Rijksmuseum 官网式的暗场展厅、田中一光式的三角窗、民国书衣式的题签框。设计体检报过一次撞车：两版首屏都用了《神奈川冲浪里》，它就把暗场那版换成了《山下白雨》。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-hokusai-hero.jpg" width="100%" alt="富岳三十六景线上展首屏：暗场满屏《山下白雨》"></p>

往下一章讲普鲁士蓝，依据是大都会博物馆的光谱研究；全 46 幅都来自芝加哥艺术博物馆和大都会的开放馆藏。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-hokusai-prussian-blue.jpg" width="100%" alt="一种进口的蓝：普鲁士蓝章节"></p> <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-hokusai-all-46.jpg" width="60%" alt="全四十六幅作品墙"></p>

App · 鸣迹（观鸟记录）

「做一个观鸟记录 App 的原型」

现实参照找的是拿了 2025 年苹果设计奖的 CapWords，ref_board.py 先把它截成参考板，agent 亲眼看过再动手。借来的是「从照片里撕下一张贴纸」：每只鸟都从 Wikimedia 的真实照片里分割出来，贴进一年的本子里，叫声波形是拿真实录音算的。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-mingji-birding-app.jpg" width="75%" alt="鸣迹：听到一只鸟，撕下一张贴纸"></p>

App · 今晚吃啥（家常菜谱）

「做一个家常菜谱 App」

秒数轮盘恰好抽到吕敬人书籍设计，最后做成了一本菜谱：一道菜一页方子，切口旁边留一条旁注栏，写「擦干再煎才不溅油」「老抽只要几滴」，朱砂只给「开做」这一方印。外观账本看到最近 6 个交付里 5 个是无衬线标题，这一版挑了宋体。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-recipe-app.jpg" width="75%" alt="今晚吃啥：一道菜一页方子"></p>

PPT · 《千里江山图》讲座

走的是最佳设计师 Abbott Miller 式的暗场展柜，暗底取的是绢地最暗处的颜色。封面底下那条细长的位置条就是整卷缩略图，框出这一页在 11.9 米长卷的哪一段。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-qianli-cover.jpg" width="100%" alt="千里江山图讲座封面"></p> <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-qianli-pages.jpg" width="100%" alt="一张多大的画、希孟年十八岁、小如豆、颜色来自石头"></p>

PPT · 黑洞的照片是怎么拍出来的

现实参照是 Jonathan Corum 的讲座幻灯片：黑底、照片做主角、标注直接写在图上。每页都标了出处，事实先过核查再上页面。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-blackhole-pages.jpg" width="100%" alt="黑洞科普 PPT 四页"></p>

App · 绿拇指（第三轮盲选赢的那版）

把植物当成会呼吸的生命体征来读。App 原型做成一张有构图的展示板，几台手机错落排开。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-plant-health-app.jpg" width="75%" alt="绿拇指：把植物当成会呼吸的生命体征来读"></p>

网页 · 旅居档案（作者自己的项目）

三年里所有旅行照片的地图。选的是葛西薰式的白纸明朝体长卷，开头一张卫星地图串起所有旅程，往下一段旅程一章。选完作者顺口说了句「尽量不要遗漏」，它就记进了经验：个人回忆类档案照片要全，而且注明只适用于照片档案，不外溢到产品界面。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-travel-archive.jpg" width="100%" alt="旅居档案"></p>

---

📺 新手教程（花叔亲录）

不知道怎么用？看花叔录的 huashu-design 上手教程：

<p align="center"> <a href="https://www.youtube.com/watch?v=m-_BlUdcIvw"><img src="https://img.youtube.com/vi/m-_BlUdcIvw/maxresdefault.jpg" alt="huashu-design 使用教程" width="70%"></a> </p> <p align="center">_{👉 <a href="https://www.youtube.com/watch?v=m-_BlUdcIvw">在 YouTube 观看完整教程</a>}</p>

---

装上就能用

npx skills add alchaincyf/huashu-design

装完先自检：这个 skill 不只是 SKILL.md 一个文件，references/、assets/、scripts/、demos/ 四个子目录里有 99 处被引用的配方、脚本、素材，缺一不可。装完看一眼安装目录（如 ~/.claude/skills/huashu-design/），如果只有 SKILL.md、没有那几个子目录，说明你的 skills CLI 版本太旧（≤1.5.15 有个只同步单文件的 bug，已在 1.5.19 修复）。升级后再装一次即可：

npm i -g skills@latest        # 或 npx skills@latest add alchaincyf/huashu-design

升级后仍异常，就用 git clone 兜底安装，把仓库克隆到任意 skills 目录即可：

git clone https://github.com/alchaincyf/huashu-design.git ~/.claude/skills/huashu-design

然后在 Claude Code / Codex / Cursor 等任意支持 skills 的 agent 里直接说话：

「做一份 AI 心理学的演讲 PPT，推荐 3 个风格方向让我选」
「做个 AI 番茄钟 iOS 原型，4 个核心屏幕要真能点击」
「把这段逻辑做成 60 秒动画，导出 MP4 和 GIF」
「帮我对这个设计做一个 5 维度评审」

没有按钮、没有面板、没有 Figma 插件。

---

Star 趋势

<p align="center"> <a href="https://star-history.com/#alchaincyf/huashu-design&Date"> <img src="https://api.star-history.com/svg?repos=alchaincyf/huashu-design&type=Date" alt="huashu-design Star History" width="80%"> </a> </p>

---

能做什么

| 能力 | 交付物 | 典型耗时 | |------|--------|----------| | 交互原型（App / Web） | 单文件 HTML · 真 iPhone bezel · 可点击 · Playwright 验证 | 10–15 min | | 演讲幻灯片 | HTML deck（浏览器演讲）+ 可编辑 PPTX（文本框保留） | 15–25 min | | 时间轴动画 | MP4（25fps / 60fps 插帧）+ GIF（palette 优化）+ BGM | 8–12 min | | 设计变体 | 3+ 并排对比 · Tweaks 实时调参 · 跨维度探索 | 10 min | | 信息图 / 可视化 | 印刷级排版 · 可导 PDF/PNG/SVG | 10 min | | 设计方向顾问 | 三套逻辑各出两个候选（最佳设计师 + 同媒介获奖作品 + 秒数轮盘）· 六张缩略图挑三版真实视觉，另三张作备选 | 10 min | | 5 维度专家评审 | 雷达图 + Keep/Fix/Quick Wins · 可操作修复清单 | 3 min |

---

Demo 画廊

设计方向顾问

模糊需求时的 fallback：三套互补逻辑各出两个候选——最佳设计师（预算无上限时最适合的设计师）+ 现实参照（同媒介的获奖作品，先截图亲眼看）+ 秒数轮盘（从风格库随机抽，打破惯性）。六个候选先画成一页缩略图，挑最强、最不一样的三版做成真实视觉让你看着选，另外三张作为备选一起给你。背后是 84 种 HTML 原生风格库（网页 20 + PPT 20 + 信息图 20 + App 12 + 中文与东亚 12，纯 CSS 无需生图），每种都有一张样张。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/w3-fallback-advisor.gif" width="100%"></p> <p align="center">_{动图为 2.0 流程（三套逻辑直接各出一版）}</p>

3.0 新增的两个分区，每格都是一张样张（全部纯 HTML/CSS，题材与数字虚构）：

<p align="center"><img src="assets/style-specimens/sheet-east.jpg" width="100%" alt="中文与东亚设计 12 种：吕敬人书籍设计、宋刻本版式、民国书衣、上海摩登、中文实验字体、香港街招、传统色节气、杉浦康平、田中一光、服部一成、佐藤可士和、日式杂志密排"></p> <p align="center"><img src="assets/style-specimens/sheet-app.jpg" width="100%" alt="App 风格 12 种：硬件面板、液态玻璃、玩味 3D、友好金融、专业相机、户外地形、内容瀑布流、命令面板、健康数据、原生精修、柔和鼓励、编辑式阅读"></p>

iOS App 原型

iPhone 15 Pro 精确机身（灵动岛 / 状态栏 / Home Indicator）· 状态驱动多屏切换 · 真图从 Wikimedia/Met/Unsplash 取 · Playwright 自动点击测试。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c1-ios-prototype.gif" width="100%"></p>

Motion Design 引擎

Stage + Sprite 时间片段模型 · useTime / useSprite / interpolate / Easing 四 API 覆盖所有动画需求 · 一条命令导出 MP4 / GIF / 60fps 插帧 / 带 BGM 的成片。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c3-motion-design.gif" width="100%"></p>

HTML Slides → 可编辑 PPTX

HTML deck 浏览器演讲 · html2pptx.js 读 DOM 的 computedStyle 逐元素翻译成 PowerPoint 对象 · 导出的是真文本框，PPT 里双击即可编辑。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c2-slides-pptx.gif" width="100%"></p>

Tweaks · 实时变体切换

配色 / 字型 / 信息密度等参数化 · 侧边面板切换 · 纯前端 + localStorage 持久化 · 刷新不丢。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c4-tweaks.gif" width="100%"></p>

信息图 / 数据可视化

杂志级排版 · CSS Grid 精准分栏 · text-wrap: pretty 排印细节 · 真数据驱动 · 可导 PDF 矢量 / PNG 300dpi / SVG。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c5-infographic.gif" width="100%"></p>

5 维度专家评审

哲学一致性 · 视觉层级 · 细节执行 · 功能性 · 创新性 各 0–10 分 · 雷达图可视化 · 输出 Keep / Fix / Quick Wins 清单。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c6-expert-review.gif" width="100%"></p>

Junior Designer 工作流

不闷头做大招：先写 assumptions + placeholders + reasoning，尽早 show 给你，再迭代。理解错了早改比晚改便宜 100 倍。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/w2-junior-designer.gif" width="100%"></p>

品牌资产协议 5 步硬流程

涉及具体品牌时强制执行：问 → 搜 → 下载（三条兜底）→ grep 色值 → 写 brand-spec.md。

<p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/w1-brand-protocol.gif" width="100%"></p>

---

Showcase · 2.0 时期的真实案例

鹦鹉进化史网站 · 设计方向顾问三套逻辑实战（2.0）

Live demo · https://www.huasheng.ai/parrots/

一句「做个介绍鹦鹉进化史的网站」、零额外要求，skill 自动跑完整 2.0 顾问流程：先判断图片是内容必需 → 抓公共领域博物插画（Edward Lear / John Gould 的鹦鹉图录）→ 三套逻辑并行（秒数轮盘 + 现实参照获奖站 + 原研哉「白」哲学）各出一版真实视觉。素材齐了再设计，不是边设计边用色块占位。

「聊聊 skill」 · PM after-party 演讲 deck

Live demo · https://skill-huasheng.vercel.app

13 页 HTML deck，全部用 huashu-design 完成：

• 黑底极简衬线视觉系统（cover / about / hook / what / why / closing）
• 2 个带 BGM + SFX 的 22 秒 cinematic demo（Nuwa skill workflow + Darwin skill workflow），各采用完全独立的视觉语言：
  • Nuwa：3D 知识 orbit + Pentagon 提炼 + SKILL.md typewriter + 「21 分钟」hero reveal
  • Darwin：autoresearch loop spin + v1/v5 并列 diff + Hill-Climb 全屏曲线 + Ratchet gear lock
• 每个 cinematic 默认显示完整静态 workflow dashboard（观众随时能看清 skill 怎么跑），点 ▶ 才触发动画，跑完自动 fade 回 dashboard
• 嵌入 huasheng.ai 的 25 秒 hero 动画（iframe 本地化兜底）
• 真实数据：14,495 stargazers 真实曲线（gh API 拉取）+ DeepSeek V4 真实 specs（WebSearch 验证）
• 真实 AI 素材：用 huashu-gpt-image 跑 4×2 grid 大图，extract_grid.py 抠出 8 张独立透明 PNG，做 3D orbit 漂浮

适合参考的页面：

• /slides/slide-04b-nuwa-flow.html · 静态 dashboard + cinematic overlay 双层架构
• /slides/slide-06b-darwin-flow.html · 完全独立视觉语言的对照案例
• /slides/slide-03b-deepseek-cover.html · AI slop vs 真实设计师视角的对比页

详细 cinematic patterns 见 references/cinematic-patterns.md。

---

核心机制

品牌资产协议

skill 里最硬的一段规则。涉及具体品牌（Stripe、Linear、Anthropic、自家公司等）时强制执行 5 步：

| 步骤 | 动作 | 目的 | |------|------|------| | 1 · 问 | 用户有 brand guidelines 吗？ | 尊重已有资源 | | 2 · 搜官方品牌页 | <brand>.com/brand · brand.<brand>.com · <brand>.com/press | 抓权威色值 | | 3 · 下载资产 | SVG 文件 → 官网 HTML 全文 → 产品截图取色 | 三条兜底，前一条失败立刻走下一条 | | 4 · grep 提取色值 | 从资产里抓所有 #xxxxxx，按频率排序，过滤黑白灰 | 绝不从记忆猜品牌色 | | 5 · 固化 spec | 写 brand-spec.md + CSS 变量，所有 HTML 引用 var(--brand-*) | 不固化就会忘 |

A/B 测试（v1 vs v2，各跑 6 agent）：v2 的稳定性方差比 v1 低 5 倍。稳定性的稳定性，这是 skill 真正的护城河。

设计方向顾问（Fallback）

当用户需求模糊到无法着手时触发（3.0 重做）：

• 先对话澄清 + 主动索要参考（名字 / logo / 品牌色 / 喜欢的参考站），只问一轮
• 取齐内容必需的真图（公共领域 / 免版权，脚本一键抓），再开工
• 三套逻辑各出两个候选，共六个：① 最佳设计师（两位气质不同的设计师，用他们的思维从头做）② 现实参照（两件同媒介的获奖作品——做 App 找 App、做 deck 找出版物；scripts/ref_board.py 先截图亲眼看，再拆网格、字号比和色彩比例）③ 秒数轮盘（date +%S 取秒，在产出形态对应的分区和中文东亚分区各抽一号，先看样张再动手）
• 六张缩略图 → 挑三版做完整稿：单看够好、彼此不一样、不撞你最近的项目；没选上的三张作为备选一起给你，看中哪张再做
• 绝不让你在没看到视觉时盲选风格——摆出来就停，看着选
• 底层是 84 种 HTML 原生风格库，每种配一张样张和源码（assets/style-specimens/），作弹药，不是教条

为什么这样做：我们拿固定题目做了三轮改前改后盲选（内部测试）。第一轮强制每版套一个大隐喻，页面被做成道具，4 题只赢 1 题；第二轮为了躲 AI 默认外观加了一堆禁令，三版一起变得「太规整，太无聊」，2 题全输；第三轮改成加选项、不加禁令——多出候选、给看得见的样张、看真参考——同两道题都赢了。

越用越懂你：经验、外观账本与设计体检

• 经验：scripts/learn.py 开工前带出你说过的品味原话（「太素了」「A 的结构加 C 的颜色」）和过去的教训，收工时把值得记的记下来；记录前会告诉你，不想记可以拒绝
• 外观账本：