Claude Skill

huashu-design

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

LLM Mart · 0 points · 3 views 0 listing impressions 0 install-command copies
Download mxyhi-ok-skills-huashu-design-3ae9eb9.zip · 20366 KB

Install

skills CLI npx skills add https://github.com/mxyhi/ok-skills/tree/main/huashu-design
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install mxyhi-ok-skills@llmmart
Git git clone https://github.com/mxyhi/ok-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole mxyhi/ok-skills collection as a plugin from our marketplace. Git is the plain clone.

README

🌐 中文 · English

Huashu Design

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

License Agent-Agnostic Skills


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


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 的关系


huashu-design 3.0 发布片

▲ 3.0 发布片 · 32 秒 · 片里每一页设计都是 3.0 自己做的,剪辑用的是 huashu-motion
👉 下载 MP4(1080p · 含配乐 · 24MB) · 2.0 的带音效 HTML 互动版


3.0 案例

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

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

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

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

富岳三十六景线上展首屏:暗场满屏《山下白雨》

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

一种进口的蓝:普鲁士蓝章节

全四十六幅作品墙

App · 鸣迹(观鸟记录)

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

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

鸣迹:听到一只鸟,撕下一张贴纸

App · 今晚吃啥(家常菜谱)

「做一个家常菜谱 App」

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

今晚吃啥:一道菜一页方子

PPT · 《千里江山图》讲座

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

千里江山图讲座封面

一张多大的画、希孟年十八岁、小如豆、颜色来自石头

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

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

黑洞科普 PPT 四页

App · 绿拇指(第三轮盲选赢的那版)

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

绿拇指:把植物当成会呼吸的生命体征来读

网页 · 旅居档案(作者自己的项目)

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

旅居档案


📺 新手教程(花叔亲录)

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

huashu-design 使用教程

👉 在 YouTube 观看完整教程


装上就能用

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 趋势

huashu-design Star History


能做什么

能力 交付物 典型耗时
交互原型(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 无需生图),每种都有一张样张。

动图为 2.0 流程(三套逻辑直接各出一版)

3.0 新增的两个分区,每格都是一张样张(全部纯 HTML/CSS,题材与数字虚构):

中文与东亚设计 12 种:吕敬人书籍设计、宋刻本版式、民国书衣、上海摩登、中文实验字体、香港街招、传统色节气、杉浦康平、田中一光、服部一成、佐藤可士和、日式杂志密排

App 风格 12 种:硬件面板、液态玻璃、玩味 3D、友好金融、专业相机、户外地形、内容瀑布流、命令面板、健康数据、原生精修、柔和鼓励、编辑式阅读

iOS App 原型

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

Motion Design 引擎

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

HTML Slides → 可编辑 PPTX

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

Tweaks · 实时变体切换

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

信息图 / 数据可视化

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

5 维度专家评审

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

Junior Designer 工作流

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

品牌资产协议 5 步硬流程

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


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 的颜色」)和过去的教训,收工时把值得记的记下来;记录前会告诉你,不想记可以拒绝
  • 外观账本:每次交付记一笔「长什么样」(底色、色板、字体、版式骨架,连同项目名和所在路径),下个项目主动避开——单个项目看都不错、放在一起却长得像,这种单调靠它管
  • 设计体检:scripts/design_lint.py 只量能核对的事实——图裂了、字小到读不了、对比度不够、控制台报错是红灯;全大写小标签、「A · B · C」这类顺手的模板装饰是黄灯;三版是不是换皮、和最近的项目撞没撞,compare 和 ledger check 来查。好不好看归你判断,它不打分
  • 这些记录只存在你本机的 ~/.huashu-design/,不随 skill 分发,删掉文件夹就全部忘记

Junior Designer 工作流

默认工作模式,贯穿所有任务:

  • 开工前 show 问题清单一次性发给用户,等批量答完再动手
  • HTML 里先写 assumptions + placeholders + reasoning comments
  • 尽早 show 给用户(哪怕只是灰色方块)
  • 填充实际内容 → variations → Tweaks 这三步分别再 show 一次
  • 交付前用 Playwright 肉眼过一遍浏览器

反 AI slop 规则

避免一眼 AI 的视觉最大公约数:紫渐变、emoji 图标、圆角+左 border accent、SVG 画人脸、Inter 做 display,以及 2026 年的新一代模板装饰(每个标题上一行全大写小标签、「A · B · C」中点连接、按钮尾巴的「→」、标题只给一个词换色)。不编造数据、评价和 logo 墙。

暖纸衬线、深底单点缀这类「外观家族」不在禁令里:盲选里被用户认可的几版,恰好就有这两类。真正要避免的是三版挤在同一个家族、每个项目都长一个样——那交给外观账本。


和 Claude Design 的关系

我大方承认:品牌资产协议的哲学是从 Claude Design 流传出来的提示词里偷师的。那份提示词反复强调好的高保真设计不是从白纸开始,而是从已有的设计上下文长出来。这个原则是 65 分作品和 90 分作品的分水岭。

定位差异:

Claude Design huashu-design
形态 网页产品(浏览器里用) skill(Claude Code 里用)
配额 订阅 quota API 消耗 · 并行跑 agent 不受 quota 限
交付物 画布内 + 可导 Figma HTML / MP4 / GIF / 可编辑 PPTX / PDF
操作方式 GUI(点、拖、改) 对话(说话、等 agent 做完)
复杂动画 有限 Stage + Sprite 时间轴 · 60fps 导出
跨 agent 专属 Claude.ai 任意 skill 兼容 agent

Claude Design 是更好的图形工具,huashu-design 是让图形工具这层消失。两条路,不同受众。


安全与数据流

核心链路(设计→渲染→MP4/PDF/PPTX导出)100%本地运行,零网络零key。云能力(豆包TTS配音、AI看片评审)全部隔离在 scripts/cloud/,完全可选:用你自己的key、只发对应厂商官方API、首次调用需 --yes 显式确认。无telemetry,没有任何数据发往作者服务器。3.0 新增的本机记录(品味经验、外观账本)只写在 ~/.huashu-design/,从不上传;参考板只在你让 agent 截参考作品时访问那些网址。全部出站域名、密钥处理、删除边界的穷举声明见 SECURITY.md,欢迎用你的agent对着代码逐条核验。


Limitations

  • 不支持图层级可编辑的 PPTX 到 Figma。产出 HTML,可截图、录屏、导图,但不能拖进 Keynote 改文字位置。
  • Framer Motion 级别的复杂动画不行。3D、物理模拟、粒子系统超出 skill 边界。
  • 完全空白的品牌从零设计质量会掉到 60–65 分。凭空画 hi-fi 本来就是 last resort。

这是一个 80 分的 skill,不是 100 分的产品。对不愿意打开图形界面的人,80 分的 skill 比 100 分的产品好用。


仓库结构

huashu-design/
├── SKILL.md                 # 主文档(给 agent 读)
├── README.md                # 中文 README(默认,本文件)
├── README.en.md             # 英文 README
├── assets/                  # Starter Components
│   ├── animations.jsx       # Stage + Sprite + Easing + interpolate
│   ├── ios_frame.jsx        # iPhone 15 Pro bezel
│   ├── android_frame.jsx
│   ├── macos_window.jsx
│   ├── browser_window.jsx
│   ├── deck_stage.js        # HTML 幻灯片引擎
│   ├── deck_index.html      # 多文件 deck 拼接器
│   ├── design_canvas.jsx    # 并排变体展示
│   ├── showcases/           # 24 个预制样例(8 场景 × 3 风格)
│   ├── style-specimens/     # 84 种风格的样张(html 源码 + jpg)与分区总览
│   └── bgm-*.mp3            # 6 首场景化背景音乐
├── references/              # 按任务深入读的子文档
│   ├── animation-pitfalls.md
│   ├── directions.md        # 三方向:六个候选 → 缩略图 → 挑三版
│   ├── design-styles.md     # 84 种 HTML 原生风格库(网页 20 + PPT 20 + 信息图 20 + App 12 + 中文与东亚 12)
│   ├── modules/             # 网页 / deck / 信息图 / 动画 四个模块手册
│   ├── slide-decks.md
│   ├── editable-pptx.md
│   ├── critique-guide.md
│   ├── video-export.md
│   └── ...
├── scripts/                 # 导出工具链
│   ├── render-video.js      # HTML → MP4
│   ├── convert-formats.sh   # MP4 → 60fps + GIF
│   ├── add-music.sh         # MP4 + BGM
│   ├── export_deck_pdf.mjs
│   ├── export_deck_pptx.mjs
│   ├── html2pptx.js
│   ├── design_lint.py       # 设计体检、三版撞色撞骨架、外观账本
│   ├── learn.py             # 品味经验的读写
│   ├── ref_board.py         # 把参考作品截成参考板
│   ├── capabilities.py      # 探测本机能力(生图、兄弟 skill、Node、ffmpeg)
│   └── verify.py
└── demos/                   # 9 个能力演示 (c*/w*),中英双版 GIF/MP4/HTML + hero v10

起源

Anthropic 发布 Claude Design 那天我玩到凌晨四点。几天之后发现自己再也没点开过它,不是它不好——它是这个赛道目前最成熟的产品——是我宁愿让 agent 在终端里帮我干活,也不愿意打开任何图形界面。

于是让 agent 拆解 Claude Design 本身(包括社区流传的系统提示词、品牌资产协议、组件机制),蒸馏成结构化 spec,再写成 skill 装进自己的 Claude Code。

感谢 Anthropic 把 Claude Design 的提示词写得清晰。这种基于其他产品灵感的二次创作,是开源文化在 AI 时代的新形态。


用 huashu-design 做的产品

FanBox · Coding Agent 的驾驶舱 的三套界面皮肤,就是用 huashu-design 设计的。指挥 Claude Code / Codex 干活,看清它碰过的每个文件、每一行改动。

FanBox · Coding Agent 的驾驶舱


社区翻译版本

社区维护的翻译版本。翻译质量与各版本 license 条款由对应维护者负责,使用前请先确认。

语言 维护者 仓库
English @namandhakad712 namandhakad712/huashu-design-en
한국어(韩语) @ktkarchive ktkarchive/ktk-design
Tiếng Việt(越南语) @letrquan letrquan/huashu-design

想加你的语言?fork 仓库、翻译 SKILL.md + README.md,然后回这边开个 issue,我会把链接加进来。


License

2026-05-14 起改为 MIT 协议。 此前版本采用「个人使用免费、企业商用需授权」的 Personal Use License,对商用做了限制——现在这层限制完全解除。

按 MIT License,你可以自由使用、修改、分发本 skill,包括商业用途——公司内部用、客户商单交付、做成付费产品对外卖,都没问题。无需事先授权、无需付费、无需打招呼。注明出处不强制,但欢迎。


Connect · 花生(花叔)

花生是 AI Native Coder、独立开发者、AI 自媒体博主。代表作:小猫补光灯(AppStore 付费榜 Top 1)、《一本书玩转 DeepSeek》、女娲 .skill(GitHub 3 万+ star)。自媒体全平台 30 万+ 粉丝。

平台 账号 链接
X / Twitter @AlchainHust https://x.com/AlchainHust
公众号 花叔 微信搜索「花叔」
B 站 花叔 https://space.bilibili.com/14097567
YouTube 花叔 https://www.youtube.com/@Alchain
小红书 花叔 https://www.xiaohongshu.com/user/profile/5abc6f17e8ac2b109179dfdf
官网 huasheng.ai https://www.huasheng.ai/
开发者主页 bookai.top https://bookai.top

合作咨询、自媒体约稿 → 以上任一平台私信花生即可。

关注花叔:公众号「花叔」· B站「花叔v」· 小红书「花叔」

Skill manifest

花叔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。

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

收工三件事

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 天后再试。

是否更新由用户决定,不要自动执行更新。

Files (ok-skills)
  • assets
    • director-notes-samples
      • launch-film-30s-sample.md 78.3 KB
        Loading…
    • sfx
      • container
        • card-flip.mp3 11.9 KB · in bundle
        • card-snap.mp3 8.6 KB · in bundle
        • modal-open.mp3 10.2 KB · in bundle
        • stack-collapse.mp3 13.5 KB · in bundle
      • feedback
        • achievement.mp3 24.1 KB · in bundle
        • error-tone.mp3 11.9 KB · in bundle
        • notification-pop.mp3 10.2 KB · in bundle
        • success-chime.mp3 16.8 KB · in bundle
      • impact
        • brand-stamp.mp3 16.8 KB · in bundle
        • drop-thud.mp3 11.9 KB · in bundle
        • logo-reveal-v2.mp3 24.1 KB · in bundle
        • logo-reveal.mp3 24.1 KB · in bundle
      • keyboard
        • delete-key.mp3 8.6 KB · in bundle
        • enter.mp3 8.6 KB · in bundle
        • space-tap.mp3 8.6 KB · in bundle
        • type-fast.mp3 24.1 KB · in bundle
        • type.mp3 13.5 KB · in bundle
      • magic
        • ai-process.mp3 19.6 KB · in bundle
        • sparkle.mp3 13.5 KB · in bundle
        • transform.mp3 16.8 KB · in bundle
      • progress
        • complete-done.mp3 13.5 KB · in bundle
        • generate-start.mp3 13.5 KB · in bundle
        • loading-tick.mp3 8.6 KB · in bundle
      • terminal
        • command-execute.mp3 8.6 KB · in bundle
        • cursor-blink.mp3 8.6 KB · in bundle
        • output-appear.mp3 10.2 KB · in bundle
      • transition
        • dissolve.mp3 13.5 KB · in bundle
        • slide-in.mp3 10.2 KB · in bundle
        • swipe-horizontal.mp3 11.9 KB · in bundle
        • whoosh-fast.mp3 8.6 KB · in bundle
        • whoosh.mp3 10.2 KB · in bundle
      • ui
        • click-soft.mp3 8.6 KB · in bundle
        • click.mp3 8.6 KB · in bundle
        • focus.mp3 8.6 KB · in bundle
        • hover-subtle.mp3 8.6 KB · in bundle
        • tap-finger.mp3 8.6 KB · in bundle
        • toggle-on.mp3 8.6 KB · in bundle
    • showcases
      • cover
        • cover-build.html 5.5 KB · in bundle
        • cover-build.png 113.6 KB · in bundle
        • cover-pentagram.html 4.8 KB · in bundle
        • cover-pentagram.png 35.2 KB · in bundle
        • cover-takram.html 11.5 KB · in bundle
        • cover-takram.png 151.7 KB · in bundle
      • infographic
        • infographic-build.html 11.4 KB · in bundle
        • infographic-build.png 106.2 KB · in bundle
        • infographic-pentagram.html 13.6 KB · in bundle
        • infographic-pentagram.png 155.3 KB · in bundle
        • infographic-takram.html 21.9 KB · in bundle
        • infographic-takram.png 159.2 KB · in bundle
      • ppt
        • ppt-build.html 8.9 KB · in bundle
        • ppt-build.png 82.4 KB · in bundle
        • ppt-pentagram.html 11.7 KB · in bundle
        • ppt-pentagram.png 99 KB · in bundle
        • ppt-takram.html 15.3 KB · in bundle
        • ppt-takram.png 456.2 KB · in bundle
      • website-ai-nav
        • ainav-build.html 9.4 KB · in bundle
        • ainav-build.png 83.1 KB · in bundle
        • ainav-pentagram.html 10.3 KB · in bundle
        • ainav-pentagram.png 103.1 KB · in bundle
        • ainav-takram.html 12.4 KB · in bundle
        • ainav-takram.png 118.8 KB · in bundle
      • website-ai-writing
        • aiwriting-build.html 13.7 KB · in bundle
        • aiwriting-build.png 127.5 KB · in bundle
        • aiwriting-pentagram.html 13.9 KB · in bundle
        • aiwriting-pentagram.png 146.7 KB · in bundle
        • aiwriting-takram.html 17.6 KB · in bundle
        • aiwriting-takram.png 153.5 KB · in bundle
      • website-devdocs
        • devdocs-build.html 9.7 KB · in bundle
        • devdocs-build.png 66.6 KB · in bundle
        • devdocs-pentagram.html 12.5 KB · in bundle
        • devdocs-pentagram.png 114.3 KB · in bundle
        • devdocs-takram.html 12.8 KB · in bundle
        • devdocs-takram.png 109.2 KB · in bundle
      • website-homepage
        • homepage-build.html 8.1 KB · in bundle
        • homepage-build.png 60.3 KB · in bundle
        • homepage-pentagram.html 8.3 KB · in bundle
        • homepage-pentagram.png 55.8 KB · in bundle
        • homepage-takram.html 10.3 KB · in bundle
        • homepage-takram.png 124.6 KB · in bundle
      • website-saas
        • saas-build.html 12.6 KB · in bundle
        • saas-build.png 97.4 KB · in bundle
        • saas-pentagram.html 14.7 KB · in bundle
        • saas-pentagram.png 94.3 KB · in bundle
        • saas-takram.html 17.8 KB · in bundle
        • saas-takram.png 120.6 KB · in bundle
      • INDEX.md 5.4 KB
        Loading…
    • style-specimens
      • app
        • 01-hardware-panel.html 7.1 KB · in bundle
        • 01-hardware-panel.jpg 73.7 KB · in bundle
        • 02-liquid-glass.html 6.8 KB · in bundle
        • 02-liquid-glass.jpg 87.9 KB · in bundle
        • 03-playful-3d.html 5.6 KB · in bundle
        • 03-playful-3d.jpg 92.8 KB · in bundle
        • 04-friendly-fintech.html 6.2 KB · in bundle
        • 04-friendly-fintech.jpg 91.3 KB · in bundle
        • 05-pro-camera.html 7.1 KB · in bundle
        • 05-pro-camera.jpg 74.5 KB · in bundle
        • 06-topo-outdoor.html 8.9 KB · in bundle
        • 06-topo-outdoor.jpg 90.4 KB · in bundle
        • 07-feed-waterfall.html 7.5 KB · in bundle
        • 07-feed-waterfall.jpg 81.5 KB · in bundle
        • 08-command-palette.html 6.4 KB · in bundle
        • 08-command-palette.jpg 55.4 KB · in bundle
        • 09-health-color-code.html 7.3 KB · in bundle
        • 09-health-color-code.jpg 74.2 KB · in bundle
        • 10-native-polish.html 6.4 KB · in bundle
        • 10-native-polish.jpg 74.5 KB · in bundle
        • 11-gentle-encouraging.html 6.3 KB · in bundle
        • 11-gentle-encouraging.jpg 80.1 KB · in bundle
        • 12-editorial-reader.html 5.9 KB · in bundle
        • 12-editorial-reader.jpg 114.1 KB · in bundle
      • east
        • 01-lu-jingren-bookcraft.html 4 KB · in bundle
        • 01-lu-jingren-bookcraft.jpg 68.5 KB · in bundle
        • 02-song-block-print.html 4.7 KB · in bundle
        • 02-song-block-print.jpg 146.3 KB · in bundle
        • 03-republic-book-jacket.html 4.6 KB · in bundle
        • 03-republic-book-jacket.jpg 57.7 KB · in bundle
        • 04-shanghai-deco-calendar.html 5 KB · in bundle
        • 04-shanghai-deco-calendar.jpg 76.3 KB · in bundle
        • 05-hanzi-experimental-poster.html 5 KB · in bundle
        • 05-hanzi-experimental-poster.jpg 54.1 KB · in bundle
        • 06-hk-street-signs.html 4.4 KB · in bundle
        • 06-hk-street-signs.jpg 115.5 KB · in bundle
        • 07-traditional-colors-solar-terms.html 6 KB · in bundle
        • 07-traditional-colors-solar-terms.jpg 79.7 KB · in bundle
        • 08-sugiura-info-mandala.html 27.9 KB · in bundle
        • 08-sugiura-info-mandala.jpg 127.3 KB · in bundle
        • 09-tanaka-geometric-poster.html 3.1 KB · in bundle
        • 09-tanaka-geometric-poster.jpg 53.6 KB · in bundle
        • 10-hattori-playful-offset.html 2.9 KB · in bundle
        • 10-hattori-playful-offset.jpg 89.6 KB · in bundle
        • 11-sato-minimal-symbol.html 2.8 KB · in bundle
        • 11-sato-minimal-symbol.jpg 45.4 KB · in bundle
        • 12-japan-magazine-dense.html 14.2 KB · in bundle
        • 12-japan-magazine-dense.jpg 122.6 KB · in bundle
      • info
        • 01-personal-annual-report.html 9.3 KB · in bundle
        • 01-personal-annual-report.jpg 121.4 KB · in bundle
        • 02-explanation-graphics.html 4.9 KB · in bundle
        • 02-explanation-graphics.jpg 109.8 KB · in bundle
        • 03-cross-section-epic.html 7.1 KB · in bundle
        • 03-cross-section-epic.jpg 150.3 KB · in bundle
        • 04-magazine-pop-data.html 3.6 KB · in bundle
        • 04-magazine-pop-data.jpg 84.8 KB · in bundle
        • 05-isotype.html 3.9 KB · in bundle
        • 05-isotype.jpg 120.6 KB · in bundle
        • 06-data-humanism.html 5.9 KB · in bundle
        • 06-data-humanism.jpg 85.7 KB · in bundle
        • 07-scrollytelling.html 4.9 KB · in bundle
        • 07-scrollytelling.jpg 69.8 KB · in bundle
        • 08-cartographic-lead.html 4.6 KB · in bundle
        • 08-cartographic-lead.jpg 83.8 KB · in bundle
        • 09-newsroom-chart.html 5.1 KB · in bundle
        • 09-newsroom-chart.jpg 63.9 KB · in bundle
        • 10-computational-portrait.html 4.4 KB · in bundle
        • 10-computational-portrait.jpg 147.4 KB · in bundle
        • 11-beautiful-information.html 4.2 KB · in bundle
        • 11-beautiful-information.jpg 92.2 KB · in bundle
        • 12-open-research-data.html 3.4 KB · in bundle
        • 12-open-research-data.jpg 84.8 KB · in bundle
        • 13-speculative-tech-diagram.html 4 KB · in bundle
        • 13-speculative-tech-diagram.jpg 49 KB · in bundle
        • 14-pictogram-system.html 4.3 KB · in bundle
        • 14-pictogram-system.jpg 79.8 KB · in bundle
        • 15-small-multiples.html 3 KB · in bundle
        • 15-small-multiples.jpg 68.6 KB · in bundle
        • 16-topological-transit-map.html 3.6 KB · in bundle
        • 16-topological-transit-map.jpg 63.1 KB · in bundle
        • 17-ma-emptiness.html 2 KB · in bundle
        • 17-ma-emptiness.jpg 20.5 KB · in bundle
        • 18-bookcraft-data.html 3 KB · in bundle
        • 18-bookcraft-data.jpg 96.8 KB · in bundle
        • 19-scientific-figure-plate.html 5.2 KB · in bundle
        • 19-scientific-figure-plate.jpg 80.6 KB · in bundle
        • 20-swiss-grid-report.html 3.2 KB · in bundle
        • 20-swiss-grid-report.jpg 69.2 KB · in bundle
      • ppt
        • 01-neo-swiss-billboard.html 2.6 KB · in bundle
        • 01-neo-swiss-billboard.jpg 67.7 KB · in bundle
        • 02-black-big-number-stage.html 1.3 KB · in bundle
        • 02-black-big-number-stage.jpg 29.2 KB · in bundle
        • 03-mono-brand-type-hero.html 1.6 KB · in bundle
        • 03-mono-brand-type-hero.jpg 50.3 KB · in bundle
        • 04-full-bleed-gradient-manifesto.html 1.5 KB · in bundle
        • 04-full-bleed-gradient-manifesto.jpg 75.4 KB · in bundle
        • 05-candy-lecture-stage.html 1.5 KB · in bundle
        • 05-candy-lecture-stage.jpg 34.4 KB · in bundle
        • 06-playful-collins-editorial.html 2.4 KB · in bundle
        • 06-playful-collins-editorial.jpg 81.1 KB · in bundle
        • 07-irreverent-pop.html 2.8 KB · in bundle
        • 07-irreverent-pop.jpg 85.2 KB · in bundle
        • 08-y2k-inflated-wrapped.html 2.4 KB · in bundle
        • 08-y2k-inflated-wrapped.jpg 75 KB · in bundle
        • 09-bento-grid.html 4.1 KB · in bundle
        • 09-bento-grid.jpg 68.1 KB · in bundle
        • 10-dark-hairline-terminal.html 2.7 KB · in bundle
        • 10-dark-hairline-terminal.jpg 54.8 KB · in bundle
        • 11-two-font-consulting.html 3.7 KB · in bundle
        • 11-two-font-consulting.jpg 92.7 KB · in bundle
        • 12-diagram-isotype.html 5.2 KB · in bundle
        • 12-diagram-isotype.jpg 94.6 KB · in bundle
        • 13-diagrammatic-minimalism.html 3 KB · in bundle
        • 13-diagrammatic-minimalism.jpg 75.5 KB · in bundle
        • 14-narrative-sparkline.html 3.7 KB · in bundle
        • 14-narrative-sparkline.jpg 65.7 KB · in bundle
        • 15-assertion-evidence.html 3.2 KB · in bundle
        • 15-assertion-evidence.jpg 59.6 KB · in bundle
        • 16-institutional-swiss.html 2.6 KB · in bundle
        • 16-institutional-swiss.jpg 74.8 KB · in bundle
        • 17-editorial-longform.html 3.9 KB · in bundle
        • 17-editorial-longform.jpg 104.9 KB · in bundle
        • 18-humanist-rounded-cards.html 4.1 KB · in bundle
        • 18-humanist-rounded-cards.jpg 82.7 KB · in bundle
        • 19-dense-research-report.html 5.1 KB · in bundle
        • 19-dense-research-report.jpg 92.2 KB · in bundle
        • 20-all-text-manifesto.html 1.6 KB · in bundle
        • 20-all-text-manifesto.jpg 65.9 KB · in bundle
      • web
        • 01-editorial-brutalism.html 4.2 KB · in bundle
        • 01-editorial-brutalism.jpg 104 KB · in bundle
        • 02-neo-brutalism.html 4.2 KB · in bundle
        • 02-neo-brutalism.jpg 113.7 KB · in bundle
        • 03-memphis-maximalism.html 4.8 KB · in bundle
        • 03-memphis-maximalism.jpg 166.7 KB · in bundle
        • 04-friendly-candy.html 4.8 KB · in bundle
        • 04-friendly-candy.jpg 64.2 KB · in bundle
        • 05-pure-css-art.html 5.4 KB · in bundle
        • 05-pure-css-art.jpg 73.1 KB · in bundle
        • 06-bold-big-type.html 2.5 KB · in bundle
        • 06-bold-big-type.jpg 67.2 KB · in bundle
        • 07-cosmic-retro-futurism.html 4 KB · in bundle
        • 07-cosmic-retro-futurism.jpg 83.8 KB · in bundle
        • 08-cinematic-sound-viz.html 12.2 KB · in bundle
        • 08-cinematic-sound-viz.jpg 87.8 KB · in bundle
        • 09-pixel-side-scroller.html 14.6 KB · in bundle
        • 09-pixel-side-scroller.jpg 59.5 KB · in bundle
        • 10-bauhaus-geometric.html 4.8 KB · in bundle
        • 10-bauhaus-geometric.jpg 69.1 KB · in bundle
        • 11-dark-editorial.html 4.3 KB · in bundle
        • 11-dark-editorial.jpg 56.7 KB · in bundle
        • 12-warm-editorial.html 3.8 KB · in bundle
        • 12-warm-editorial.jpg 75.7 KB · in bundle
        • 13-glassmorphism-bento.html 5.7 KB · in bundle
        • 13-glassmorphism-bento.jpg 72.1 KB · in bundle
        • 14-angled-fluid-gradient.html 4 KB · in bundle
        • 14-angled-fluid-gradient.jpg 85.2 KB · in bundle
        • 15-utility-colorful-docs.html 5.8 KB · in bundle
        • 15-utility-colorful-docs.jpg 65.6 KB · in bundle
        • 16-terminal-core.html 4.9 KB · in bundle
        • 16-terminal-core.jpg 62.7 KB · in bundle
        • 17-functional-brutalism.html 5.5 KB · in bundle
        • 17-functional-brutalism.jpg 117 KB · in bundle
        • 18-gallery-dark.html 4.9 KB · in bundle
        • 18-gallery-dark.jpg 22.7 KB · in bundle
        • 19-swiss-monochrome.html 3.3 KB · in bundle
        • 19-swiss-monochrome.jpg 67.2 KB · in bundle
        • 20-kenya-hara-white-gallery.html 3.2 KB · in bundle
        • 20-kenya-hara-white-gallery.jpg 34.2 KB · in bundle
      • sheet-app.jpg 145.1 KB · in bundle
      • sheet-east.jpg 155.8 KB · in bundle
      • sheet-info.jpg 231.1 KB · in bundle
      • sheet-ppt.jpg 229.5 KB · in bundle
      • sheet-web.jpg 234.7 KB · in bundle
    • android_frame.jsx 4.4 KB · in bundle
    • animations.jsx 10.3 KB · in bundle
    • banner.svg 9.3 KB · in bundle
    • bgm-ad.mp3 4.7 MB · in bundle
    • bgm-educational-alt.mp3 4.3 MB · in bundle
    • bgm-educational.mp3 3.9 MB · in bundle
    • bgm-tech.mp3 4.6 MB · in bundle
    • bgm-tutorial-alt.mp3 3.8 MB · in bundle
    • bgm-tutorial.mp3 5.3 MB · in bundle
    • browser_window.jsx 3.9 KB · in bundle
    • cursor.jsx 14.1 KB · in bundle
    • deck_index.html 20.8 KB · in bundle
    • deck_stage.js 11.4 KB
      Loading…
    • design_canvas.jsx 5.1 KB · in bundle
    • ios_frame.jsx 4.6 KB · in bundle
    • macos_window.jsx 2.5 KB · in bundle
    • narration_stage.jsx 20.2 KB · in bundle
    • personal-asset-index.example.json 1.8 KB
      Loading…
  • demos
    • md-html-narration
      • md-html-demo.html 37 KB · in bundle
      • script.md 3.4 KB
        Loading…
    • voiceover-demo
      • script.md 589 B
        Loading…
      • 什么是token.html 11.7 KB · in bundle
    • c1-ios-prototype-en.html 34.3 KB · in bundle
    • c1-ios-prototype.html 34.3 KB · in bundle
    • c2-slides-pptx-en.html 32.1 KB · in bundle
    • c2-slides-pptx.html 32.2 KB · in bundle
    • c3-motion-design-en.html 36.2 KB · in bundle
    • c3-motion-design.html 36.2 KB · in bundle
    • c4-tweaks-en.html 30.4 KB · in bundle
    • c4-tweaks.html 30.4 KB · in bundle
    • c5-infographic-en.html 24.4 KB · in bundle
    • c5-infographic.html 24.2 KB · in bundle
    • c6-expert-review-en.html 25.8 KB · in bundle
    • c6-expert-review.html 26.2 KB · in bundle
    • hero-animation-v10-en.html 47.6 KB · in bundle
    • w1-brand-protocol-en.html 20.1 KB · in bundle
    • w1-brand-protocol.html 20.4 KB · in bundle
    • w2-junior-designer-en.html 30.6 KB · in bundle
    • w2-junior-designer.html 31 KB · in bundle
    • w3-fallback-advisor-en.html 23.3 KB · in bundle
    • w3-fallback-advisor.html 25.8 KB · in bundle
  • references
    • modules
      • deck.md 4.3 KB
        Loading…
      • infographic.md 2.4 KB
        Loading…
      • motion.md 6.3 KB
        Loading…
      • web.md 2.4 KB
        Loading…
    • about-author.md 9.9 KB
      Loading…
    • ai-video-review.md 3.9 KB
      Loading…
    • animation-best-practices.md 22 KB
      Loading…
    • animation-pitfalls.md 30.1 KB
      Loading…
    • animations.md 7.6 KB
      Loading…
    • app-prototype.md 11.6 KB
      Loading…
    • apple-gallery-showcase.md 11.3 KB
      Loading…
    • audio-design-rules.md 9.4 KB
      Loading…
    • brand-asset-protocol.md 15.1 KB
      Loading…
    • camera-language.md 22.7 KB
      Loading…
    • cinematic-patterns.md 10.8 KB
      Loading…
    • content-guidelines.md 11.5 KB
      Loading…
    • critique-guide.md 8.8 KB
      Loading…
    • design-context.md 6.5 KB
      Loading…
    • design-styles.md 98.9 KB
      Loading…
    • directions.md 12.4 KB
      Loading…
    • editable-pptx.md 18.1 KB
      Loading…
    • evolution.md 7.1 KB
      Loading…
    • experience.md 5.1 KB
      Loading…
    • gsap-recipes.md 34.8 KB
      Loading…
    • hero-animation-case-study.md 11.3 KB
      Loading…
    • hyperframes-backend.md 7.3 KB
      Loading…
    • launch-film-director-notes.md 14.5 KB
      Loading…
    • materials.md 5.5 KB
      Loading…
    • multi-perspective-parallel-case-study.md 10.8 KB
      Loading…
    • pptx-from-rendered-html.md 10.2 KB
      Loading…
    • react-setup.md 9.5 KB
      Loading…
    • scene-templates.md 7 KB
      Loading…
    • sfx-library.md 9.5 KB
      Loading…
    • slide-decks.md 35.3 KB
      Loading…
    • storyboard-basics.md 23.4 KB
      Loading…
    • tweaks-system.md 8.8 KB
      Loading…
    • typography.md 18.3 KB
      Loading…
    • ui-demo-animation.md 28.4 KB
      Loading…
    • verification.md 6.8 KB
      Loading…
    • video-export.md 11.3 KB
      Loading…
    • voiceover-pipeline.md 19.6 KB
      Loading…
    • workflow.md 10.7 KB
      Loading…
  • scripts
    • cloud
      • ai-review-video.py 20 KB
        Loading…
      • tts-doubao.mjs 9.8 KB · in bundle
    • tests
      • fixtures
        • assets
          • logo.png 76 B · in bundle
        • lint_broken.html 391 B · in bundle
        • lint_clean.html 778 B · in bundle
        • lint_offline.html 302 B · in bundle
        • lint_reskin.html 1.7 KB · in bundle
        • lint_slop.html 1.7 KB · in bundle
        • lint_tricky_bad.html 633 B · in bundle
        • lint_tricky_ok.html 1.3 KB · in bundle
        • mixed_text.html 1.1 KB · in bundle
      • test_design_lint.py 8.4 KB
        Loading…
      • test_pptx_from_rendered.py 3.1 KB
        Loading…
    • add-music.sh 4.1 KB
      Loading…
    • build_specimens.py 4.4 KB
      Loading…
    • capabilities.py 3.8 KB
      Loading…
    • convert-formats.sh 2.9 KB
      Loading…
    • design-gate-hook.sh 3.4 KB
      Loading…
    • design_lint.py 27.7 KB
      Loading…
    • export_deck_pdf.mjs 3.1 KB · in bundle
    • export_deck_pptx.mjs 3.7 KB · in bundle
    • export_deck_stage_pdf.mjs 4.7 KB · in bundle
    • fetch_images.py 4.3 KB
      Loading…
    • gen_deck_thumbs.mjs 3 KB · in bundle
    • html2pptx.js 33.7 KB
      Loading…
    • learn.py 10.3 KB
      Loading…
    • mix-voiceover.sh 4.4 KB
      Loading…
    • narrate-pipeline.mjs 12.2 KB · in bundle
    • pptx_from_rendered.py 28.8 KB
      Loading…
    • ref_board.py 6.7 KB
      Loading…
    • render-narration.sh 5.3 KB
      Loading…
    • render-video-seek.js 9.5 KB
      Loading…
    • render-video.js 12 KB
      Loading…
    • sfx-cues.sh 1.6 KB
      Loading…
    • verify-video.sh 4.9 KB
      Loading…
    • verify.py 5.3 KB
      Loading…
  • .env.example 463 B · in bundle
  • .gitignore 844 B · in bundle
  • LICENSE 1.1 KB · in bundle
  • package-lock.json 27.9 KB
    Loading…
  • package.json 133 B
    Loading…
  • README.en.md 27.9 KB
    Loading…
  • README.md 28.2 KB
    <sub>🌐 <b>中文</b> · <a href="README.en.md">English</a></sub>
    
    <div align="center">
    
    # Huashu Design
    
    > *「打字。回车。一份能交付的设计。」*
    > *"Type. Hit enter. A finished design lands in your lap."*
    
    [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
    [![Agent-Agnostic](https://img.shields.io/badge/Agent-Agnostic-blueviolet)](https://skills.sh)
    [![Skills](https://img.shields.io/badge/skills.sh-Compatible-green)](https://skills.sh)
    
    <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](LICENSE)),个人和**商用都免费**,无需事先授权。原「个人使用免费、企业商用需授权」的条款已作废。([查看变更](#license))
    
    > 🆕 **3.0:三个方向更敢,项目之间也不再长一个样。** 先出六张缩略图再挑三版做成真稿;风格库扩到 84 种(新增 App、中文与东亚两个分区),每种都有样张;参照作品先截图再动手;带一个只量事实的设计体检,和一本记住你做过什么样子的外观账本。[详见核心机制](#核心机制)
    
    [看效果](#30-案例) · [安装](#装上就能用) · [能做什么](#能做什么) · [核心机制](#核心机制) · [和 Claude Design 的关系](#和-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"><sub>
      ▲ 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>
    </sub></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"><sub>👉 <a href="https://www.youtube.com/watch?v=m-_BlUdcIvw">在 YouTube 观看完整教程</a></sub></p>
    
    ---
    
    ## 装上就能用
    
    ```bash
    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 修复)。升级后再装一次即可:
    >
    > ```bash
    > npm i -g skills@latest        # 或 npx skills@latest add alchaincyf/huashu-design
    > ```
    >
    > 升级后仍异常,就用 `git clone` 兜底安装,把仓库克隆到任意 skills 目录即可:
    >
    > ```bash
    > 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"><sub>动图为 2.0 流程(三套逻辑直接各出一版)</sub></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/](https://www.huasheng.ai/parrots/)**
    
    一句「做个介绍鹦鹉进化史的网站」、零额外要求,skill 自动跑完整 2.0 顾问流程:先判断图片是内容必需 → 抓公共领域博物插画(Edward Lear / John Gould 的鹦鹉图录)→ **三套逻辑并行**(秒数轮盘 + 现实参照获奖站 + 原研哉「白」哲学)各出一版真实视觉。**素材齐了再设计,不是边设计边用色块占位。**
    
    ### 「聊聊 skill」 · PM after-party 演讲 deck
    
    > **Live demo · [https://skill-huasheng.vercel.app](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 的颜色」)和过去的教训,收工时把值得记的记下来;记录前会告诉你,不想记可以拒绝
    - **外观账本**:每次交付记一笔「长什么样」(底色、色板、字体、版式骨架,连同项目名和所在路径),下个项目主动避开——单个项目看都不错、放在一起却长得像,这种单调靠它管
    - **设计体检**:`scripts/design_lint.py` 只量能核对的事实——图裂了、字小到读不了、对比度不够、控制台报错是红灯;全大写小标签、「A · B · C」这类顺手的模板装饰是黄灯;三版是不是换皮、和最近的项目撞没撞,`compare` 和 `ledger check` 来查。好不好看归你判断,它不打分
    - 这些记录只存在你本机的 `~/.huashu-design/`,不随 skill 分发,删掉文件夹就全部忘记
    
    ### Junior Designer 工作流
    
    默认工作模式,贯穿所有任务:
    
    - 开工前 show 问题清单一次性发给用户,等批量答完再动手
    - HTML 里先写 assumptions + placeholders + reasoning comments
    - 尽早 show 给用户(哪怕只是灰色方块)
    - 填充实际内容 → variations → Tweaks 这三步分别再 show 一次
    - 交付前用 Playwright 肉眼过一遍浏览器
    
    ### 反 AI slop 规则
    
    避免一眼 AI 的视觉最大公约数:紫渐变、emoji 图标、圆角+左 border accent、SVG 画人脸、Inter 做 display,以及 2026 年的新一代模板装饰(每个标题上一行全大写小标签、「A · B · C」中点连接、按钮尾巴的「→」、标题只给一个词换色)。不编造数据、评价和 logo 墙。
    
    暖纸衬线、深底单点缀这类「外观家族」不在禁令里:盲选里被用户认可的几版,恰好就有这两类。真正要避免的是三版挤在同一个家族、每个项目都长一个样——那交给外观账本。
    
    ---
    
    ## 和 Claude Design 的关系
    
    我大方承认:品牌资产协议的哲学是从 Claude Design 流传出来的提示词里偷师的。那份提示词反复强调**好的高保真设计不是从白纸开始,而是从已有的设计上下文长出来**。这个原则是 65 分作品和 90 分作品的分水岭。
    
    定位差异:
    
    | | Claude Design | huashu-design |
    |---|---|---|
    | 形态 | 网页产品(浏览器里用) | skill(Claude Code 里用) |
    | 配额 | 订阅 quota | API 消耗 · 并行跑 agent 不受 quota 限 |
    | 交付物 | 画布内 + 可导 Figma | HTML / MP4 / GIF / 可编辑 PPTX / PDF |
    | 操作方式 | GUI(点、拖、改) | 对话(说话、等 agent 做完) |
    | 复杂动画 | 有限 | Stage + Sprite 时间轴 · 60fps 导出 |
    | 跨 agent | 专属 Claude.ai | 任意 skill 兼容 agent |
    
    Claude Design 是**更好的图形工具**,huashu-design 是**让图形工具这层消失**。两条路,不同受众。
    
    ---
    
    ## 安全与数据流
    
    核心链路(设计→渲染→MP4/PDF/PPTX导出)**100%本地运行,零网络零key**。云能力(豆包TTS配音、AI看片评审)全部隔离在 `scripts/cloud/`,完全可选:用你自己的key、只发对应厂商官方API、首次调用需 `--yes` 显式确认。无telemetry,没有任何数据发往作者服务器。3.0 新增的本机记录(品味经验、外观账本)只写在 `~/.huashu-design/`,从不上传;参考板只在你让 agent 截参考作品时访问那些网址。全部出站域名、密钥处理、删除边界的穷举声明见 [SECURITY.md](SECURITY.md),欢迎用你的agent对着代码逐条核验。
    
    ---
    
    ## Limitations
    
    - **不支持图层级可编辑的 PPTX 到 Figma**。产出 HTML,可截图、录屏、导图,但不能拖进 Keynote 改文字位置。
    - **Framer Motion 级别的复杂动画不行**。3D、物理模拟、粒子系统超出 skill 边界。
    - **完全空白的品牌从零设计质量会掉到 60–65 分**。凭空画 hi-fi 本来就是 last resort。
    
    这是一个 80 分的 skill,不是 100 分的产品。对不愿意打开图形界面的人,80 分的 skill 比 100 分的产品好用。
    
    ---
    
    ## 仓库结构
    
    ```
    huashu-design/
    ├── SKILL.md                 # 主文档(给 agent 读)
    ├── README.md                # 中文 README(默认,本文件)
    ├── README.en.md             # 英文 README
    ├── assets/                  # Starter Components
    │   ├── animations.jsx       # Stage + Sprite + Easing + interpolate
    │   ├── ios_frame.jsx        # iPhone 15 Pro bezel
    │   ├── android_frame.jsx
    │   ├── macos_window.jsx
    │   ├── browser_window.jsx
    │   ├── deck_stage.js        # HTML 幻灯片引擎
    │   ├── deck_index.html      # 多文件 deck 拼接器
    │   ├── design_canvas.jsx    # 并排变体展示
    │   ├── showcases/           # 24 个预制样例(8 场景 × 3 风格)
    │   ├── style-specimens/     # 84 种风格的样张(html 源码 + jpg)与分区总览
    │   └── bgm-*.mp3            # 6 首场景化背景音乐
    ├── references/              # 按任务深入读的子文档
    │   ├── animation-pitfalls.md
    │   ├── directions.md        # 三方向:六个候选 → 缩略图 → 挑三版
    │   ├── design-styles.md     # 84 种 HTML 原生风格库(网页 20 + PPT 20 + 信息图 20 + App 12 + 中文与东亚 12)
    │   ├── modules/             # 网页 / deck / 信息图 / 动画 四个模块手册
    │   ├── slide-decks.md
    │   ├── editable-pptx.md
    │   ├── critique-guide.md
    │   ├── video-export.md
    │   └── ...
    ├── scripts/                 # 导出工具链
    │   ├── render-video.js      # HTML → MP4
    │   ├── convert-formats.sh   # MP4 → 60fps + GIF
    │   ├── add-music.sh         # MP4 + BGM
    │   ├── export_deck_pdf.mjs
    │   ├── export_deck_pptx.mjs
    │   ├── html2pptx.js
    │   ├── design_lint.py       # 设计体检、三版撞色撞骨架、外观账本
    │   ├── learn.py             # 品味经验的读写
    │   ├── ref_board.py         # 把参考作品截成参考板
    │   ├── capabilities.py      # 探测本机能力(生图、兄弟 skill、Node、ffmpeg)
    │   └── verify.py
    └── demos/                   # 9 个能力演示 (c*/w*),中英双版 GIF/MP4/HTML + hero v10
    ```
    
    ---
    
    ## 起源
    
    Anthropic 发布 Claude Design 那天我玩到凌晨四点。几天之后发现自己再也没点开过它,不是它不好——它是这个赛道目前最成熟的产品——是我宁愿让 agent 在终端里帮我干活,也不愿意打开任何图形界面。
    
    于是让 agent 拆解 Claude Design 本身(包括社区流传的系统提示词、品牌资产协议、组件机制),蒸馏成结构化 spec,再写成 skill 装进自己的 Claude Code。
    
    感谢 Anthropic 把 Claude Design 的提示词写得清晰。这种基于其他产品灵感的二次创作,是开源文化在 AI 时代的新形态。
    
    ---
    
    ## 用 huashu-design 做的产品
    
    **[FanBox · Coding Agent 的驾驶舱](https://github.com/alchaincyf/fanbox)** 的三套界面皮肤,就是用 huashu-design 设计的。指挥 Claude Code / Codex 干活,看清它碰过的每个文件、每一行改动。
    
    [![FanBox · Coding Agent 的驾驶舱](https://raw.githubusercontent.com/alchaincyf/fanbox/master/assets/promo-banner.jpg)](https://github.com/alchaincyf/fanbox)
    
    ---
    
    ## 社区翻译版本
    
    社区维护的翻译版本。翻译质量与各版本 license 条款由对应维护者负责,使用前请先确认。
    
    | 语言 | 维护者 | 仓库 |
    |---|---|---|
    | English | [@namandhakad712](https://github.com/namandhakad712) | [namandhakad712/huashu-design-en](https://github.com/namandhakad712/huashu-design-en) |
    | 한국어(韩语) | [@ktkarchive](https://github.com/ktkarchive) | [ktkarchive/ktk-design](https://github.com/ktkarchive/ktk-design) |
    | Tiếng Việt(越南语) | [@letrquan](https://github.com/letrquan) | [letrquan/huashu-design](https://github.com/letrquan/huashu-design) |
    
    想加你的语言?fork 仓库、翻译 `SKILL.md` + `README.md`,然后回这边开个 issue,我会把链接加进来。
    
    ---
    
    ## License
    
    **2026-05-14 起改为 MIT 协议。** 此前版本采用「个人使用免费、企业商用需授权」的 Personal Use License,对商用做了限制——现在这层限制完全解除。
    
    按 [MIT License](LICENSE),你可以**自由使用、修改、分发**本 skill,**包括商业用途**——公司内部用、客户商单交付、做成付费产品对外卖,都没问题。无需事先授权、无需付费、无需打招呼。注明出处不强制,但欢迎。
    
    ---
    
    ## Connect · 花生(花叔)
    
    花生是 AI Native Coder、独立开发者、AI 自媒体博主。代表作:小猫补光灯(AppStore 付费榜 Top 1)、《一本书玩转 DeepSeek》、女娲 .skill(GitHub 3 万+ star)。自媒体全平台 30 万+ 粉丝。
    
    | 平台 | 账号 | 链接 |
    |---|---|---|
    | X / Twitter | @AlchainHust | https://x.com/AlchainHust |
    | 公众号 | 花叔 | 微信搜索「花叔」 |
    | B 站 | 花叔 | https://space.bilibili.com/14097567 |
    | YouTube | 花叔 | https://www.youtube.com/@Alchain |
    | 小红书 | 花叔 | https://www.xiaohongshu.com/user/profile/5abc6f17e8ac2b109179dfdf |
    | 官网 | huasheng.ai | https://www.huasheng.ai/ |
    | 开发者主页 | bookai.top | https://bookai.top |
    
    合作咨询、自媒体约稿 → 以上任一平台私信花生即可。
    
    <p align="center"><img src="https://raw.githubusercontent.com/alchaincyf/alchaincyf/main/assets/follow.svg" width="100%" alt="关注花叔:公众号「花叔」· B站「花叔v」· 小红书「花叔」"></p>
    
  • SECURITY.md 7.2 KB
    Loading…
  • SKILL.md 15.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 天后再试。
    
    是否更新由用户决定,不要自动执行更新。
    
  • test-prompts.json 3 KB
    Loading…

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.