huashu-design:在 Agent 里打一句话拿回能交付的设计
huashu-design(默认分支 master,整理时 HEAD 为 9b01ee8,2026-10-31)
AI 参与说明(Agent:Cursor):本文依据上述提交的
SKILL.md(metadata.version为3.1.0)、README.md、SECURITY.md、LICENSE,以及references/directions.md、references/brand-asset-protocol.md、references/design-styles.md、references/critique-guide.md、references/editable-pptx.md、assets/animations.jsx与仓库文件树整理。风格条目名称、id、温度与还原度均从该提交的references/design-styles.md逐条抽出;样张id取自同文件「样张」路径的文件名(不含扩展名)。作者在 README 里报告的耗时、盲选和方差没有复跑。模型标识未取得独立运行记录字段;执行入口 Cursor Cloud。中文正文按项目 humanizer-zh 编辑。
修订说明(2026-10-31,Agent:Cursor):按作者要求改写:原先「84 种风格库」一节只写分区数量与用法概念,现改为嵌入仓库内完整清单(网页 20 + PPT 20 + 信息图 20 + App 12 + 中文与东亚 12),并补上当前
master已写入同一文件的小红书 8 种;交付物、脚本与样张路径改为本页可直接对照的项目内容。
修订说明(2026-11-03,Agent:Codex):补充 92 种风格的文件配对核验、24 个场景样例与能力演示的区别,以及本地静态预览和 Agent 设计任务的操作方法。执行入口 Codex Desktop;模型完整标识与 reasoning effort 未取得任务级运行记录。新增中文正文按 humanizer-zh 编辑。
想在 Claude Code、Cursor 或 Codex 里说一句「做个观鸟记录 App 的原型」,拿回能点开的 HTML,可以用 huashu-design。它是花叔(花生,GitHub alchaincyf)维护的 Agent Skill,许可证是 MIT(2026-05-14 起,个人和商用都不必另行授权)。安装:
npx skills add alchaincyf/huashu-design
HTML 在这里是媒介:交互原型、1920×1080 演讲 deck、时间轴动画、信息图、小红书图文,以及可执行的设计评审。生产级 Web App、要做 SEO 的站点、需要后端的系统,SKILL.md 写明不走这个 skill。
先认识几个名称
| 英文术语 | 中文名称 | 简要解释 |
|---|---|---|
| Three-direction gate | 三方向门 | 新的视觉设计先交出三个方向的真实初稿,选定之后才做完 |
| Core Asset Protocol | 核心资产协议 | 认得出品牌靠 logo、产品图和界面截图,色值和字体只是辅助 |
| Look ledger | 外观账本 | 记下每次交付的底色、色板、字体和版式,下一次主动避开 |
| design lint | 设计体检 | 只检查裂图、字号、对比度、报错和模板装饰,不给好看打分 |
| Tweaks | Tweaks | 在页面侧边改配色、字型和密度,选择存在浏览器 localStorage |
| Stage / Sprite | 舞台 / 片段 | 动画按整段时间和片段起止来排,片段内再用进度插值 |
Any new visual design passes the three-direction gate before execution. Specifying a style or a brand does not waive it. The agent shows real drafts and stops, including in unattended sessions. Logo, product photography, and UI screenshots outrank color values and type specs.
秒数轮盘从下面这套风格库抽号。条目里的 hex 和字体是锚点,不是配方;用之前要先走 design-styles.md 里的色彩推导三步(采样 → 收敛 → 论证)。字体配对与「已被用烂名单」以 references/typography.md 为准。
84 种风格清单(仓库原文)
references/design-styles.md 文件头写的是 网页 20 + PPT 20 + 信息图 20 + App 12 + 中文与东亚 12;文末版本说明记为 60 → 84(2026-10 补齐 App 与中文东亚分区及样张)。当前这份 master 文件里另外还有 小红书 8(下一节),合计 92 条带样张的 HTML 原生风格。AI 生图专用表不进 default 库。
下面五张表按该文件逐条列出名称、温度与还原度。id 取自同条「样张」路径的文件名,对应 assets/style-specimens/<分区>/<id>.jpg;同名 .html 是可打开的 CSS 源码。分区总览图:sheet-web.jpg、sheet-ppt.jpg、sheet-info.jpg、sheet-app.jpg、sheet-east.jpg(小红书另有 sheet-xhs.jpg)。
分区按产出形态选,不按题材:可点击站点走网页,要翻页走 PPT,以数据为主角、能脱离交互阅读的图走信息图,App / 移动端原型走 App;中文与东亚跨媒介,中文内容可以优先翻。温度刻意让大胆款占多数。还原度 ≥90% 可直接做;70–90% 个别细节会降级;<70% 必须标明哪一部分用纯色块代替,不能假装做出原版质感。
网页(20)
| # | id | 风格名(原文) | 温度 | 纯 HTML 还原度 |
|---|---|---|---|---|
| 1 | 01-editorial-brutalism | 媒体级粗野主义 Editorial Brutalism(巨号Helvetica压小正文) | 大胆 | 98% |
| 2 | 02-neo-brutalism | 新粗野主义撞色信息流 Neo-Brutalism(粗黑描边卡片+高饱和撞色) | 大胆 | 95% |
| 3 | 03-memphis-maximalism | 孟菲斯复古拼贴最大化 Memphis Maximalism(撞色块+错位叠放+复古字体) | 大胆 | 72% |
| 4 | 04-friendly-candy | 糖果色凸起立体按钮游戏化 Friendly Geometric Candy | 大胆 | 85% |
| 5 | 05-pure-css-art | 纯CSS几何插画+响应式变形彩蛋 Pure-CSS Art | 大胆 | 80% |
| 6 | 06-bold-big-type | 巨型字黑白高对比时装大字报 Bold Big-Type Editorial | 大胆 | 88% |
| 7 | 07-cosmic-retro-futurism | 复古未来太空图录 Cosmic Retro-Futurism | 大胆 | 75% |
| 8 | 08-cinematic-sound-viz | 电影感声波可视化 Cinematic Sound-Viz Dark | 大胆 | 72% |
| 9 | 09-pixel-side-scroller | 像素游戏横版叙事 Pixel-Game Side-Scroller | 大胆 | 70% |
| 10 | 10-bauhaus-geometric | 包豪斯几何标志+扁平插画系统 Bauhaus Geometric | 中性 | 90% |
| 11 | 11-dark-editorial | 暗色双色侧栏开发者作品集 Dark Editorial(深底+单荧光accent+等宽字) | 中性 | 96% |
| 12 | 12-warm-editorial | 暖色出版物 Warm Editorial(奶油纸底+赤陶橙+衬线无衬线混排) | 中性 | 97% |
| 13 | 13-glassmorphism-bento | Linear暗色发光+Bento网格 Glassmorphism Bento | 中性 | 85% |
| 14 | 14-angled-fluid-gradient | 斜切流体渐变带 Angled Fluid Gradient | 中性 | 92% |
| 15 | 15-utility-colorful-docs | 实用主义彩虹分类文档 Utility-First Colorful Docs | 中性 | 98% |
| 16 | 16-terminal-core | 终端核软未来 Terminal-Core Soft-Futurism(等宽字+等距立方) | 中性 | 80% |
| 17 | 17-functional-brutalism | 功能主义网格社区 Functional Brutalism(灰线分割+系统字+蓝链接) | 安静 | 98% |
| 18 | 18-gallery-dark | 深色画廊裱框 Gallery Dark(深黑负空间+单列大图+EXIF小字) | 安静 | 75% |
| 19 | 19-swiss-monochrome | Swiss极致黑白 Swiss Monochrome(Vercel式纯黑白+Geist+锐利边角) | 安静 | 98% |
| 20 | 20-kenya-hara-white-gallery | 日式留白白盒画廊 Kenya Hara White Gallery | 安静 | 80% |
PPT(20)
| # | id | 风格名(原文) | 温度 | 纯 HTML 还原度 |
|---|---|---|---|---|
| 1 | 01-neo-swiss-billboard | 新瑞士大字报 / Neo-Swiss Billboard Editorial | 大胆 | 98% |
| 2 | 02-black-big-number-stage | 黑底巨型数字剧场 / Black Big-Number Stage | 大胆 | 97% |
| 3 | 03-mono-brand-type-hero | 高饱和单色品牌撞色海报 / Mono-Brand Type-as-Hero | 大胆 | 96% |
| 4 | 04-full-bleed-gradient-manifesto | 全幅渐变宣言版式 / Full-Bleed Gradient Manifesto | 大胆 | 82% |
| 5 | 05-candy-lecture-stage | CS50单概念糖果舞台 / Candy-Color Lecture Stage | 大胆 | 94% |
| 6 | 06-playful-collins-editorial | 玩味手绘极简 / Playful Maximalist Editorial (Collins式) | 大胆 | 75% |
| 7 | 07-irreverent-pop | 不羁玩梗流行版 / Irreverent Pop (Reddit式) | 大胆 | 80% |
| 8 | 08-y2k-inflated-wrapped | Y2K膨胀大字 / Maximalist 3D-Type (Wrapped式) | 大胆 | 78% |
| 9 | 09-bento-grid | Bento便当格模块网格 / Bento Grid | 中性 | 95% |
| 10 | 10-dark-hairline-terminal | Neo-Swiss暗色终端美学 / Dark Hairline Terminal | 中性 | 94% |
| 11 | 11-two-font-consulting | 双字体咨询版 / Two-Font Consulting (Bower式) | 中性 | 90% |
| 12 | 12-diagram-isotype | 图谱箭头企业版 / Diagram-Driven Isotype | 中性 | 88% |
| 13 | 13-diagrammatic-minimalism | 单图母图概念图解 / Diagrammatic Minimalism | 中性 | 95% |
| 14 | 14-narrative-sparkline | Sparkline叙事波形 / Narrative Sparkline (Duarte式) | 中性 | 91% |
| 15 | 15-assertion-evidence | 断言-证据 / Tufte信息设计 | 安静 | 93% |
| 16 | 16-institutional-swiss | 瑞士机构极简 / Institutional Swiss Minimal | 安静 | 96% |
| 17 | 17-editorial-longform | 杂志编辑长文流 / Editorial Longform | 安静 | 95% |
| 18 | 18-humanist-rounded-cards | 人文圆角卡片 / Humanist Rounded Cards (Khan式) | 安静 | 80% |
| 19 | 19-dense-research-report | 研报密集图表 / Dense Research Report (Meeker式) | 安静 | 92% |
| 20 | 20-all-text-manifesto | 纯文字宣言备忘录 / All-Text Manifesto (Netflix/Amazon式) | 安静 | 97% |
信息图(20)
| # | id | 风格名(原文) | 温度 | 纯 HTML 还原度 |
|---|---|---|---|---|
| 1 | 01-personal-annual-report | 个人数据印刷年报 / Personal Annual Report(Feltron式) | 大胆 | 94% |
| 2 | 02-explanation-graphics | 解释性图解 / Explanation Graphics(Nigel Holmes式) | 大胆 | 76% |
| 3 | 03-cross-section-epic | 巨幅剖面手绘 / Cross-Section Epic(SCMP Arranz式) | 大胆 | 55% |
| 4 | 04-magazine-pop-data | 杂志撞色数据页 / Magazine Pop Data(Businessweek式) | 大胆 | 90% |
| 5 | 05-isotype | ISOTYPE图形统计 / Neurath–Arntz | 大胆 | 88% |
| 6 | 06-data-humanism | 数据人文主义手绘图谱 / Data Humanism(Lupi式) | 大胆 | 80% |
| 7 | 07-scrollytelling | 滚动叙事数据长卷 / Scrollytelling(The Pudding式) | 大胆 | 85% |
| 8 | 08-cartographic-lead | 地图即主角 / Cartographic Lead(Stamen式) | 大胆 | 65% |
| 9 | 09-newsroom-chart | 数据新闻图表规范 / Newsroom Chart System(FT式) | 中性 | 96% |
| 10 | 10-computational-portrait | 计算式数据肖像 / Computational Portrait(Fathom式) | 中性 | 78% |
| 11 | 11-beautiful-information | 美丽信息 / Beautiful Information(McCandless式) | 中性 | 90% |
| 12 | 12-open-research-data | 学术开放数据 / Open Research Data(Our World in Data式) | 中性 | 94% |
| 13 | 13-speculative-tech-diagram | 东方思辨科技图 / Speculative Tech Diagram(Takram式) | 中性 | 84% |
| 14 | 14-pictogram-system | 系统图标化图解 / Pictogram System(Otl Aicher式) | 中性 | 92% |
| 15 | 15-small-multiples | Tufte小倍数矩阵 / Small Multiples | 安静 | 95% |
| 16 | 16-topological-transit-map | 拓扑简化路网图 / Topological Transit Map(Beck/Vignelli式) | 安静 | 86% |
| 17 | 17-ma-emptiness | 白之留白信息图 / Ma & Emptiness(原研哉式) | 安静 | 82% |
| 18 | 18-bookcraft-data | 书籍级信息排印 / Bookcraft Data(Irma Boom式) | 安静 | 80% |
| 19 | 19-scientific-figure-plate | 科学期刊图版 / Scientific Figure Plate | 安静 | 96% |
| 20 | 20-swiss-grid-report | 瑞士网格年报 / Swiss Grid Report(Müller-Brockmann式) | 安静 | 97% |
App(12)
| # | id | 风格名(原文) | 温度 | 纯 HTML 还原度 |
|---|---|---|---|---|
| 1 | 01-hardware-panel | 硬件面板 Hardware Panel(Teenage Engineering式,OP-1 / EP-133 的界面语言) | 大胆 | 85% |
| 2 | 02-liquid-glass | 液态玻璃 Liquid Glass(Apple iOS 26 新设计语言) | 大胆 | 70% |
| 3 | 03-playful-3d | 玩味3D材质 Playful Tactile(Not Boring系列式,Andy Works) | 大胆 | 70% |
| 4 | 04-friendly-fintech | 友好金融 Friendly Fintech(Monzo式,高饱和品牌色+大圆角) | 大胆 | 90% |
| 5 | 05-pro-camera | 专业相机工具 Pro Camera(Halide式,深色+黄色强调+密集刻度) | 大胆 | 85% |
| 6 | 06-topo-outdoor | 户外地形工具 Topo Outdoor(Gaia GPS / AllTrails式等高线与轨迹) | 中性 | 90% |
| 7 | 07-feed-waterfall | 中文内容瀑布流 Feed Waterfall(小红书式双列卡片流) | 中性 | 92% |
| 8 | 08-command-palette | 键盘优先命令面板 Command Palette(Raycast式) | 中性 | 90% |
| 9 | 09-health-color-code | 健康数据颜色编码 Health Color-Code(Apple 健康 / Oura式) | 中性 | 92% |
| 10 | 10-native-polish | 原生精修 Native Polish(Things 3式,Cultured Code) | 安静 | 95% |
| 11 | 11-gentle-encouraging | 柔和鼓励式 Gentle Encouragement(Gentler Streak式,暗色变体) | 安静 | 80% |
| 12 | 12-editorial-reader | 编辑式阅读 Editorial Reader(Matter / Readwise Reader式) | 安静 | 90% |
中文与东亚(12)
| # | id | 风格名(原文) | 温度 | 纯 HTML 还原度 |
|---|---|---|---|---|
| 1 | 01-lu-jingren-bookcraft | 吕敬人书籍设计 Lü Jingren Bookcraft | 安静 | 85% |
| 2 | 02-song-block-print | 宋刻本版式 Song Block-Print Leaf | 安静 | 80% |
| 3 | 03-republic-book-jacket | 民国书衣 Republic-Era Book Jacket | 中性 | 70% |
| 4 | 04-shanghai-deco-calendar | 上海摩登装饰艺术 Shanghai Moderne Deco | 大胆 | 78% |
| 5 | 05-hanzi-experimental-poster | 中文实验字体海报 Experimental Hanzi Poster | 大胆 | 85% |
| 6 | 06-hk-street-signs | 香港街招与招牌 Hong Kong Street Signs | 大胆 | 80% |
| 7 | 07-traditional-colors-solar-terms | 中国传统色·节气色谱 Solar-Term Palette | 中性 | 90% |
| 8 | 08-sugiura-info-mandala | 杉浦康平信息曼荼罗 Sugiura Information Mandala | 大胆 | 72% |
| 9 | 09-tanaka-geometric-poster | 田中一光几何平面构成 Ikko Tanaka Geometric | 中性 | 90% |
| 10 | 10-hattori-playful-offset | 服部一成玩味错位 Hattori Playful Offset | 大胆 | 75% |
| 11 | 11-sato-minimal-symbol | 佐藤可士和极简符号 Sato Minimal Symbol | 中性 | 92% |
| 12 | 12-japan-magazine-dense | 日式生活杂志密排 Japanese Lifestyle Magazine Dense | 中性 | 78% |
库的定位写在文件开头:用户已经给了内容、品牌或参考,设计从那里长出来,不要为了用库而套库。三方向里只有「秒数轮盘」强制从这里抽;另两套逻辑(最佳设计师、现实参照)没思路时也可以翻。三个方向不要落在同一种气质。
暖色出版物(12-warm-editorial,奶油纸底 + 赤陶橙)还原度标到 97%,同时也是模型不加约束时最容易滑进去的样子。SKILL.md 描述的默认审美是暖奶油底、高反差衬线标题、陶土色点缀、全大写小标签和 01/02/03 编号——可以用,但三版不能都挤在这里,外观账本里最近用过就换。
assets/showcases/INDEX.md 是另一套更早的预制样例(8 个场景 × 3 种风格共 24 个),不要把它当成这张 84 种表。
小红书 8 种(当前 master 已写入同一文件)
当前 HEAD 的文件标题已写成「… + 小红书 8」。README 能力表也把「小红书图文 / 封面」单列:3:4 一组图(≤18 张)、8 种范式模板、长卷连续滑动,脚本入口是 scripts/xhs_render.py,模块说明在 references/modules/xiaohongshu.md。这 8 条不在文末「60 → 84」那句计数里,但已经是同库可抽的实体条目:
小红书(8)
| # | id | 风格名(原文) | 温度 | 纯 HTML 还原度 |
|---|---|---|---|---|
| 1 | 01-specimen-journal | 标本志 Specimen Journal | 中性 | 90% |
| 2 | 02-sticker-notebook | 贴纸本 Product Notebook | 中性 | 95% |
| 3 | 03-index-ink | 索引 Index Ink | 大胆 | 95% |
| 4 | 04-panorama-strip | 长卷 Panorama Strip | 大胆 | 90% |
| 5 | 05-daily-paper | 日报 Daily Paper | 中性 | 80% |
| 6 | 06-trading-cards | 集换卡 Trading Cards | 大胆 | 85% |
| 7 | 07-blank-vertical | 留白 Blank & Vertical | 安静 | 90% |
| 8 | 08-area-infographic | 信息图 Area Infographic | 中性 | 95% |
它实际交什么(按仓库模块)
| 你要的东西 | 交回来的是什么 | 主要文件 |
|---|---|---|
| 网页或 App 原型 | 可点击的 HTML;手机原型用 assets/ios_frame.jsx 等机身框 | references/modules/web.md、references/app-prototype.md |
| 演讲幻灯片 | 浏览器里放的 HTML deck,以及可编辑的 PPTX | references/editable-pptx.md、scripts/html2pptx.js |
| 时间轴动画 | 本地导出的 MP4 / GIF,可加 BGM | assets/animations.jsx、references/modules/motion.md |
| 信息图 | 以 HTML/CSS 排的长图或图表,再导出 PDF / PNG / SVG | references/modules/infographic.md |
| 小红书图文 | 3:4 组图 / 长卷,按上面 8 种模板切 | references/modules/xiaohongshu.md、scripts/xhs_render.py |
| 方向本身 | 六格缩略图加三版完整初稿,另外三张留作备选 | references/directions.md |
| 评审 | 概念先过关,再按五个执行维度写 Keep / Fix / Quick Wins | references/critique-guide.md |
| 改参数 | Tweaks 面板,刷新后仍保留 | references/tweaks-system.md |
动画引擎在 assets/animations.jsx:Stage 管整段时间,Sprite 管 start / end 之间的片段,片段里用 useSprite() 读 0 到 1 的进度,再用 interpolate 和 Easing 插值。文件头写明这是借鉴 Remotion 的轻量时间轴,挂在 window.Animations 上。≥20 秒的片子开工前要有 导演稿.md;≥45 秒的成片渲染可以由可选的 scripts/design-gate-hook.sh 拦住,直到 direction-approved.md 存在。
PPTX 有两条路,不要在同一项目里混用:还没写 HTML、希望 PowerPoint 里是真文本框时,走 references/editable-pptx.md + scripts/html2pptx.js(画布 960pt × 540pt);已经做好的视觉稿走 references/pptx-from-rendered-html.md。pptxgenjs 不能拿客户现成的 pptx 当母版继承。
references/critique-guide.md(文件内版本 v1.0,日期 2026-02-13)把概念/立意放在最前面:换个客户名还成立,这一维直接 ≤5,总评封顶 6.0。后面才是哲学一致性、视觉层级、细节执行、功能性和创新性。
装上之后目录里该有什么
安装目录必须同时有 references/、assets/、scripts/、demos/。README 写明:skills CLI ≤1.5.15 有过只同步 SKILL.md 的问题,1.5.19 修复。仍不行就整仓克隆:
git clone https://github.com/alchaincyf/huashu-design.git ~/.claude/skills/huashu-design
脚本路径相对 skill 根目录。Windows 上把 python3 换成 python。开工时常跑的三个本机脚本是:
scripts/learn.py:读品味原话scripts/design_lint.py ledger:看最近交付长什么样scripts/capabilities.py:看本机有没有生图、兄弟 skill、Node、ffmpeg、Playwright
本轮在 9b01ee8 上还能直接对照的实体包括:references/modules/ 下的 web.md、deck.md、motion.md、infographic.md、xiaohongshu.md;demos/ 里的 c1-ios-prototype.html、c2-slides-pptx.html、c3-motion-design.html、c4-tweaks.html、c5-infographic.html、c6-expert-review.html 等成对中英文样例。
每种风格都有案例吗,怎样在本地看
有。2026-11-03 对上述 9b01ee8 的文件核验结果是:92 种风格全部有同名 HTML 和 JPG,其中网页 20、PPT 20、信息图 20、App 12、中文与东亚 12、小红书 8。HTML 可以打开看排版、读 CSS;JPG 是预先渲染的效果图。它们展示视觉语言,不保证每个按钮都有功能,也不等于每种风格都附带一套完整应用。
The repository contains 92 paired HTML/JPG style specimens and 24 scenario showcases. Style specimens demonstrate appearance; they are not full application implementations.
先分清三套可直接浏览的文件:
| 内容 | 数量与用途 | 本地目录 |
|---|---|---|
| 风格样张 | 92 种,每种一份 HTML 与 JPG;对照上面的风格表 | assets/style-specimens/{web,ppt,info,app,east,xhs}/ |
| 场景样例 | 8 场景 × 3 风格,共 24 份 HTML 与 PNG;适合比较同题的三种做法 | assets/showcases/,索引见 INDEX.md |
| 能力演示 | c1–c6、w1–w3 的中英文 HTML;部分是自动播放的终端与画面演出 | demos/ |
README 中的北斋展览、观鸟 App、菜谱 App 等发布案例是另一组作品展示,不能用这三套文件的数量推断它们都附有完整可运行源码。想立即复现已有外观,先看风格样张与场景样例;想验证 Skill 处理自己的需求,则要在 Agent 中执行一次设计任务。
第一步:只看效果,不必安装 Skill
前置条件是 Git、Python 3 和浏览器。在自己选定的工作目录执行;若已经克隆过,直接进入原目录,不重复运行 git clone:
git clone --depth 1 https://github.com/alchaincyf/huashu-design.git
cd huashu-design
# 可选:固定到本文核验的版本
git checkout 9b01ee8751679724dd43d855a532944aaa2c2b59
python3 -m http.server 8765 --bind 127.0.0.1
保持终端运行,在浏览器打开 http://127.0.0.1:8765/assets/style-specimens/。这里会显示目录列表,进入分区后选 .html 查看。按 Ctrl+C 停止服务;端口被占用时换一个端口,并同步修改浏览器地址。这一步只需要静态文件服务:仓库 package.json 没有 dev script,不需要先执行 npm install 或尝试 npm run dev。
建议依次看以下路径,均接在 http://127.0.0.1:8765/ 后面:
| 先看什么 | 路径 | 能观察到什么 |
|---|---|---|
| 网页风格总览 | assets/style-specimens/sheet-web.jpg | 一张图比较 20 种网页外观 |
| 暖色出版物 | assets/style-specimens/web/12-warm-editorial.html | 字体、配色和页面层级 |
| 硬件面板 App | assets/style-specimens/app/01-hardware-panel.html | 多个手机画面的视觉样张;不代表真实采样工具 |
| 中文书籍设计 | assets/style-specimens/east/01-lu-jingren-bookcraft.html | 中文排版与书籍式界面 |
| 同题三风格 | assets/showcases/website-saas/ | 分别打开 saas-pentagram.html、saas-build.html、saas-takram.html |
| 能力演示 | demos/c1-ios-prototype.html | 自动播放的原型制作演示,区别于实际可操作的产品 |
这些静态页面可在本机服务下打开;部分会请求 Google Fonts 等外部资源,断网或字体服务不可达时字体可能回退。上面的“还原度”是上游风格库的标注,不是本次测试得分。
第二步:让 Agent 用 Skill 做一份自己的设计
看样张只是在浏览已有文件。要让 Agent 按这套规则产出新稿,再安装 Skill:
npx skills@latest add alchaincyf/huashu-design
按安装器提示选择实际使用的 Agent 和安装范围,随后检查安装目录中确有 SKILL.md、references/、assets/、scripts/、demos/。如果当前 Agent 没有发现新安装的 Skill,重新打开会话,并明确要求使用 huashu-design;也可以直接给出本地仓库的 SKILL.md 路径让它读取。
可以从一个容易验收的任务开始:
使用 huashu-design 做一个中文番茄钟的 HTML 原型。
需要专注计时、任务列表、今日统计三个画面。
先给六格缩略图和三个完整方向,等我选择后再完成。
可参考 app/01-hardware-panel 与 east/01-lu-jingren-bookcraft 的样张,
但三个方向要有明显区别。
最终在浏览器里能开始、暂停、重置计时,并能切换三个画面。
输出到当前工作项目;给我本地预览地址。
先检查是否真的交了三个视觉方向,再选一个继续;完成后亲自操作开始、暂停、重置与页面切换。只看到截图或自动播放动画,不能算这个任务通过。若只是想替换一份既有样张的文字和配色,直接指定那份 HTML,请 Agent 保留布局并修改内容即可。
导出视频、PPTX 或运行设计体检时,再按对应模块安装依赖。浏览静态 HTML 不需要 ffmpeg;仓库的 Node 依赖也不能代替 design_lint.py 所需的 Python Playwright 与浏览器。各脚本的依赖以脚本头部和模块说明为准,不必为看样张一次装齐所有工具。
以上操作依据 README、风格样张目录、场景索引 与 package.json 核对。文件配对计数与本地服务已实测;本节没有把新生成设计或各类导出结果写成已验证。
从一句话到选定方向
flowchart TD
A["一句需求"] --> B["核实产品是否已发布"]
B --> C{"点名了品牌或产品?"}
C -->|是| D["核心资产协议<br/>brand-spec.md"]
C -->|否| E["从已有上下文取素材"]
D --> F["六个候选"]
E --> F
F --> G["六格缩略图"]
G --> H["三版完整初稿"]
H --> I["design lint"]
I --> J["停下来等选择"]
J --> K["direction-approved.md"]
K --> L["做完并写入外观账本"]
references/directions.md 要求选择发生在看见视觉之后。提问只有一轮,最多 3 个问题。候选六个:两位气质不同的设计师各一版、两件同媒介核实过的作品各一版(先用 scripts/ref_board.py 截参考板)、秒数轮盘再从风格库抽两号。六个都画成约 480×300 的缩略图(design-demos/thumbs.html),再挑三张做成完整 HTML。用户原话写入 direction-approved.md。
秒数轮盘用当前秒数 S(date +%S)。产出分区取 S % 分区风格数 + 1,中文与东亚分区再取 S % 12 + 1。抽到和外观账本最近 3 个交付同类的,顺延下一号。
references/brand-asset-protocol.md 的识别度顺序是 logo、产品图或 UI 截图,然后才是色值、字体和气质词。五步是问清单、搜官方渠道、下载、验证、写成 brand-spec.md。色值从已下载的 SVG、HTML、CSS 里提取,不靠记忆。
收工三件事:对最终文件跑 design_lint.py check,用 ledger add 记外观,用 learn.py harvest 收回教训。三方向初稿放在项目下的 design-demos/。
可以怎么开口
README 给了四句可以直接用的 prompt:
做一份 AI 心理学的演讲 PPT,推荐 3 个风格方向让我选
做个 AI 番茄钟 iOS 原型,4 个核心屏幕要真能点击
把这段逻辑做成 60 秒动画,导出 MP4 和 GIF
帮我对这个设计做一个 5 维度评审
点了名的产品,同一句话里加上「logo 和产品图按核心资产协议取,色值从文件里抽」。已经有设计系统或仓库时,指给 Agent 看。截图在 v3.0.0 release。2.0 时期仍可打开的成品包括鹦鹉进化史和「聊聊 skill」演讲 deck。
数据留在本机
SECURITY.md 的范围是:设计、渲染、导出 MP4 / PDF / PPTX 的主链路在本机完成,不带作者的 API key,也没有 telemetry。
| 去哪里 | 什么时候 | 送出什么 |
|---|---|---|
| 品牌官网、simpleicons、Google favicon、svgl | 做品牌稿、下载公开 logo | 普通 GET |
commons.wikimedia.org | scripts/fetch_images.py 找图 | 搜索词,并打印许可信息 |
| 参考作品的 URL | 三方向门里跑 ref_board.py | 无头浏览器打开该页并截图 |
fonts.googleapis.com 等 CDN | 你在浏览器里打开生成的 HTML 或样张 | 字体和库 |
ark.cn-beijing.volces.com | 可选,scripts/cloud/ai-review-video.py | 你自己渲染的视频片段,用你的 ARK_API_KEY |
openspeech.bytedance.com | 可选,豆包 TTS | 你要合成的旁白文本,用你的 key |
本机记忆只有两份,可用 HUASHU_DESIGN_HOME 改位置:~/.huashu-design/experience.md(品味原话)和 ~/.huashu-design/ledger.jsonl(外观指纹与项目路径)。
边界
适合用它把一次发布、一堂课、一个原型、一张信息图或一组小红书图在对话里做完。不适合替代生产前端仓库:没有后端、没有 SEO 站点工程、也没有 Figma 图层往返。复杂到 Framer Motion 那一档的动画,以及 3D、物理模拟、粒子,超出 skill 边界。
上手教程:YouTube。3.0 发布片:launch-3.0.mp4。
相关链接
- 仓库与协议:alchaincyf/huashu-design、MIT License、SECURITY.md
- 机制原文:SKILL.md、directions.md、brand-asset-protocol.md、design-styles.md、critique-guide.md
- 站内:Taste Skill:从设计规则到方向抽样与浏览器检查,另一份把设计选择交给脚本和浏览器检查的 Agent Skill;网站 UI 设计实践:从内容结构到交互验收,人工做网站时的结构、视觉和交付检查。