huashu-design
花叔Design——用HTML做高保真原型、幻灯片、动画、可视化与专家评审。任何新设计100%先出三个方向初稿给用户选(指定风格/品牌也不豁免),选定后才执行。触发词:做原型、PPT、幻灯片、动画、设计风格、评审、做个HTML页面、UI mockup、导出MP4/GIF、做个好看的。生产级Web App/需后端的系统不适用。
Install
npx skills add https://github.com/mxyhi/ok-skills/tree/main/huashu-design
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install mxyhi-ok-skills@llmmart
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."
在你的 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 的关系
▲ 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 的讲座幻灯片:黑底、照片做主角、标注直接写在图上。每页都标了出处,事实先过核查再上页面。

App · 绿拇指(第三轮盲选赢的那版)
把植物当成会呼吸的生命体征来读。App 原型做成一张有构图的展示板,几台手机错落排开。

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

📺 新手教程(花叔亲录)
不知道怎么用?看花叔录的 huashu-design 上手教程:
装上就能用
npx skills add alchaincyf/huashu-design
装完先自检:这个 skill 不只是 SKILL.md 一个文件,
references/、assets/、scripts/、demos/四个子目录里有 99 处被引用的配方、脚本、素材,缺一不可。装完看一眼安装目录(如~/.claude/skills/huashu-design/),如果只有 SKILL.md、没有那几个子目录,说明你的skillsCLI 版本太旧(≤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 趋势
能做什么
| 能力 | 交付物 | 典型耗时 |
|---|---|---|
| 交互原型(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,题材与数字虚构):


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 干活,看清它碰过的每个文件、每一行改动。
社区翻译版本
社区维护的翻译版本。翻译质量与各版本 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 |
合作咨询、自媒体约稿 → 以上任一平台私信花生即可。
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,按吃紧程度逐级降级:
- 三方向并行 → 串行:每版开工前只读 spec 和自己那张方向卡,不参考已做的版本
- 仍吃紧 → 1 个完整主版+2 个轻量变体(只做首屏或一页),但三张方向卡照写、变体照自己的卡做——卡片便宜,换皮的代价贵
- references 只读当前任务对应的模块手册,不全读
- deck 先只交 2 页代表页,其余页确认方向后分批做
- 检查点问答改成产出里的 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://skills.sh) [](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 干活,看清它碰过的每个文件、每一行改动。 [](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.
Reviews (0)
No reviews yet.


No comments yet.