alchaincyf/huashu-design

如果你日常在编程 agent 里工作，又不想为了一个落地页、一份路演 PPT 或一个 App 原型切到图形软件，这个 skill 值得拿一个真实交付物试一轮。如果你需要回到 Figma 或 Keynote 做图层级修改，或者要大场面的 3D、物理动画，它就不合适。

解决什么问题

你想为发布会或客户做一套页面、可点击原型或幻灯片，但你的工作环境是终端或编程 agent，不在设计工具里。以前要么手写布局代码，要么在几个软件之间来回倒腾。用了这个 skill，变的只是起点：你给一句话需求，agent 自己挑方向、渲染 HTML，再导出成页面、PDF 或 PPTX。拿到的是能打开、能展示的成品文件，不是一段布局描述。

有什么不同

它的核心想法是避免 agent 给出第一个最安全的答案。README 描述的 3.0 流程是先出六张缩略图、收窄到三个真实方向，再结合一份 84 种带样张的风格库；如果你提供 logo、色板或 UI 截图，它还会先读你的品牌资产。此外还有一次“设计体检”和一个外观账本，把最近的选择记在 ~/.huashu-design/，让后续交付换一种字体或版式。这针对的是一次生成的真实毛病：每张成品都长得差不多。

README 的案例能看出机制怎么运转：做《富岳三十六景》线上展时，设计体检发现两个方向撞了同一张首图，于是把其中一个换掉；做观鸟 App 时，它先截参考板再动手。作者自己说这是 80 分的 skill，不是 100 分的产品。

代价在格式上：产出是 HTML 原生，可以截图、录屏、导出图片、视频、PDF 和 PPTX，但拖不进 Keynote 或 Figma 按图层改文字位置。Framer Motion 级别的复杂动画、3D、物理和粒子系统都超出边界。README 也提到，完全空白的品牌从零做的质量会掉到 60–65 分左右——所以给它真实品牌资产，比琢磨提示词更重要。

谁值得试

适合：创始人、市场或工程师，平时在 Claude Code、Codex、Cursor 之类的 agent 里写东西，几小时内需要一份像样的网站、原型或 PPT，手头最好有 logo、色板或截图。README 说的 3–30 分钟，以及《富岳三十六景》、鸣迹观鸟、《千里江山图》讲座这些案例，都是一句话需求跑出来的。

不适合：做完还要在矢量编辑器里精修的设计师，或者需要电影级动效、游戏级交互的人。品牌完全空白的话，你面对的就是 README 自己警告的“最后手段”场景，不如先把基础视觉体系搭起来。

使用条件与边界

它是 skill，需要一个兼容的 agent 宿主；作者列了 Claude Code、Codex、Cursor 和“任何 agent”，并标注兼容 skills.sh。设计→渲染→MP4/PDF/PPTX 导出的核心链路，文档写明是本地运行、零网络、零 key（见项目说明）。这点的实际意义是：主交付流程不依赖云账号或 API 预算。

可选的云能力——豆包 TTS 配音和 AI 看片评审——隔离在 scripts/cloud/，用你自己的 key，首次调用需显式 --yes 确认。本地品味记录和外观账本只放在 ~/.huashu-design/；只有你让 agent 截参考作品时，参考板才会访问那些网址。安全文档逐条列出了出站域名和删除边界，涉及客户素材时值得对着看。

实际限制就是上面那些：不能把 PPTX 拿回 Figma 或 Keynote 做图层级往返编辑，没有重型动画，空白品牌效果更弱。产出更像一份需要人来收尾的交付初稿，而不是已经定稿的像素级文件。

HotRepo 点评

按 HotRepo 唯一一条记录，这个仓库在 2026-10-26 登上过一次 GitHub Trending 日榜，26,397 星，当天 +177。这只是一个有日期的快照，不足以判断热度能否持续；样本只覆盖一天。仓库很年轻（创建于 2026-04-19），并已改为 MIT 许可，解除了早先的商用限制。投入时间之前，建议先核对安全文档里的出站域名清单是否符合你客户的数据政策，并确认你的 agent 宿主能从 skills.sh 加载 skill。