本文是对开源项目 alchaincyf/huashu-design（Huashu Design 3.0，作者花叔）的摘要与评论。抓取时仓库约 ★27735、forks≈3013；许可证自 2026-05-14 起为 MIT（个人与商用均免费）；语言以 HTML / Markdown skill + 脚本为主。插图取自官方 Release 案例与仓库页；安装与完整规范以仓库 README 与 SKILL.md 为准。

全文主线可以压成一句：把「设计工作室流程」编码进 agent skill——取真实品牌色、先看参照再动手、多候选可见选择、本机账本防审美趋同——而不是再堆一套好看的 prompt。

这篇在说什么（以及和站内旧文差在哪）

站内相关	差在哪
ai-design-skills	轻量落地页 / motion 规范合集（约数千星量级）
mattpocock/skills	工程 skill（grill / TDD / 架构），不是设计工作室

先讲清它要解决的问题。人在 Claude Code / Cursor 里打「做个观鸟 App 原型」，Agent 很会吐 JSX，但常常缺设计流程：品牌色靠猜、风格盲选、项目之间审美撞车、导出还要另开 GUI。Huashu Design 把自己定位成：装进任意 skill 兼容 agent 的「HTML 原生设计工作室」——打一句话，拿回可点击原型、可编辑 PPTX、MP4/GIF、信息图；README 宣称案例图本身也是 skill 跑出来的。口号是「打字。回车。一份能交付的设计。」

安装（跨 agent）：

npx skills add alchaincyf/huashu-design

作者提醒：完整 skill 依赖 references/、assets/、scripts/、demos/；旧版 skills CLI（≤1.5.15）可能只同步 SKILL.md，需升级或 git clone 兜底。少了样张库与脚本，工作室就退化成一篇长 prompt。

设计 skill 真正难的是流程，不是文案

「帮我做漂亮一点」这类提示，几乎必然通向紫渐变、中点标签和千篇一律的卡片栅格。难的是把工作室里那些无聊但关键的步骤写进可执行流程：品牌色从哪来、参照怎么拆、候选如何可见地选、项目之间如何避免撞审美、导出前验什么事实。Huashu Design 3.0 的星标热度，很大程度上来自它把这些步骤写成了 skill 默认路径，而不是留给用户每次口述。

这也解释了它为什么依赖 references/、样张库与本地脚本：没有这些，SKILL.md 只是一篇较长的审美说明；有了这些，才是可重复的工作室。安装时若只同步到单个 markdown，等于买了菜单却没进厨房。

1. 能交付什么

README 能力表（典型耗时为作者口径）：

能力	交付物
交互原型（App / Web）	单文件 HTML、真机 bezel、可点击、Playwright 验证
演讲幻灯片	HTML deck + 真文本框可编辑 PPTX（html2pptx.js）
时间轴动画	MP4 / GIF / 插帧 / 配 BGM
设计变体	并排对比 + Tweaks 实时调参
信息图	印刷级排版，可导 PDF / PNG / SVG
设计方向顾问	六缩略图 → 挑三版真稿
5 维评审	雷达图 + Keep / Fix / Quick Wins

3.0 案例里常见模式是「一句话需求」：北斋线上展、观鸟 App「鸣迹」、菜谱 App、千里江山图讲座 PPT、黑洞科普 deck 等——强调真图（Wikimedia / Met 等公共域）先齐再设计，而不是色块占位。交付物落在 HTML / PPTX / 视频上，设计工具层在终端对话里「消失」。

解读：卖点不是「又能生成好看 HTML」，而是交付物能进下一环——真机能点、PPTX 能改字、动画能导出。对不愿开 Figma 的人，这条路径可能比「100 分图形产品」更贴手。

2. 3.0 核心机制（比「又一个 skill」更值得看的部分）

品牌资产协议（5 步硬流程）

涉及具体品牌时：问 guidelines → 搜官方 brand/press → 下载 SVG/HTML/截图三条兜底 → grep 真实色值，禁止凭记忆猜 → 固化 brand-spec.md + CSS 变量。作者称 A/B 后稳定性方差显著下降——护城河是可重复的取色流程，不是某次好看的截图。

设计方向顾问：六个候选 → 三版真稿

模糊需求时：

1. 最佳设计师逻辑各出两候选
2. 同媒介获奖参照（ref_board.py 先截图再拆网格/字号/色比）各两候选
3. 秒数轮盘从 84 种带样张风格库抽（网页/PPT/信息图/App/中文与东亚分区）

六张缩略图摆出来再选，不让用户在没看见视觉时盲选风格；再做成三版完整稿。内部盲选故事：强制大隐喻、加一堆禁令都输过；改成「加选项、不加禁令」才赢——和站内 poteto「最短路径=最好路径」同族，但是设计侧。

外观账本 + 设计体检 + 经验

• 外观账本：记下底色/色板/字体/骨架，避免项目间「各自还行、放一起像一家」
• 设计体检（design_lint.py）：只量可核对事实（裂图、对比度、控制台错误、换皮撞车）；不打审美分
• 经验（learn.py）：记住你说过的品味原话，可拒绝写入

记录只在本机 ~/.huashu-design/，不随 skill 上传。

反 AI slop + Junior 工作流

禁紫渐变 / Inter display / 全大写小标签 /「A · B · C」中点串等模板装饰；默认先 show assumptions（把假设说出来），尽早给可点草稿再迭代。

解读：3.0 真正可抄的是流程编码——取色协议、可见多选、本机账本、只验事实的 lint。把这些拆开，你也能接到别的 skill；合在一起，才像「工作室」而不是「又一篇审美 prompt」。

3. 和 Claude Design 的关系

作者承认品牌资产哲学偷师自 Claude Design 流传提示词，并做对照表：Claude Design 是更好的图形产品（配额、画布、导 Figma）；huashu-design 是让图形工具层在终端对话里消失（API 消耗、HTML/MP4/PPTX、跨 agent）。两条路，不同受众——不是「谁取代谁」。

4. 边界（作者自己写明的）

• 不产出可进 Figma 拖图层的稿；复杂 3D/物理粒子超出范围
• 完全空白品牌从零 hi-fi 会掉到约 60–65 分——有上下文才是主场
• 自称「80 分的 skill」：对不愿开 GUI 的人，可能比 100 分产品更贴手

安全口径：核心渲染/导出链路宣称本地、零遥测；云 TTS/评审在可选 scripts/cloud/，需显式确认——细节见仓库 SECURITY.md。

装完之后，第一周怎么用才不容易踩坑

作者把自己的产品说成「80 分的 skill」，这句话值得当真：它强在有上下文、有参照、有品牌资产时；弱在完全空白品牌从零做 hi-fi。所以第一周更稳的用法不是「做一个无所不包的设计系统」，而是选一个真实、窄的交付：

1. 准备好公共域图片或品牌 guidelines 链接，再开口下单。
2. 模糊需求时，强制走「六缩略图 → 选方向 → 三版真稿」，不要跳过可见选择。
3. 打开外观账本，让连续两个项目至少在底色/字体上有意识地区分。
4. 导出前跑设计体检，只处理裂图、对比度、控制台错误一类事实问题。
5. 确认 references/、assets/、scripts/ 都在——只有 SKILL.md 时，工作室能力会大幅缩水。

和轻量规范包（如本站 ai-design-skills）搭配时，可以分工：日常营销页用规范包压「AI 味」；要 PPTX/视频/多方向顾问时再唤起 Huashu Design。

解读：把这套 skill 当成「可调用的工作室流程」，而不是「更好看的默认主题」。流程被跳过时，输出会迅速退回普通 Agent 生成页的平均水平。

最后提醒一句：案例里的北斋展、观鸟 App、讲座 PPT 之所以好看，往往因为素材与叙事约束先到位。你把自己的一句话需求写得越空，skill 就越可能退回平均生成水平——这不是安装失败，而是工作室流程在提醒你：上下文才是主场。

安全方面，核心渲染宣称本地零遥测，并不等于所有可选脚本都离线；启用云 TTS 或云评审前，按 SECURITY.md 做显式确认，避免把「本地工作室」默默认成「全部数据不出机」。

作者自录的上手视频适合作为第一周对照；文字 README 负责边界与机制，视频负责建立「一句话到交付物」的体感。

怎么看

热度（约 2.8 万星）来自把「设计工作室流程」编码进 skill。对 Vigenz 读者更有用的切法是当 Agent skill 工程范例（窄桥路由 + 子手册 + 本地脚本），而不只是「又能生成好看 HTML」。

和 ai-design-skills 比：那边是精简规范包；这边是带样张库、导出链与记忆的重型工作室。和 mattpocock/skills 比：一个管工程反馈环，一个管视觉交付环——可同机并存。

上手教程（作者自录）：YouTube m-_BlUdcIvw。仓库：https://github.com/alchaincyf/huashu-design；安装：npx skills add alchaincyf/huashu-design。