一句话生成系统架构图:stack-diagram 这个 Claude Skill 火了
11 月 1 日,一个叫 stack-diagram 的仓库在 GitHub 上创建。两天后,它的 star 数超过了 1200,一天之内涨了 800 多——涨星速度在同期新仓库里排进前三。
它做的事很简单:用一句话描述你的技术栈,它给你一张带官方 logo 的系统架构图。
比如你跟 agent 说:
Diagram our stack: Next.js and a Hono API on Vercel. Postgres on Neon, auth with Clerk, payments with Stripe. GitHub Actions deploys.
几分钟后,你得到一张深浅双主题、每个组件都带着官方图标、连线不穿过文字的架构图,还附带一个可以直接丢进文档站点的自包含 HTML 文件。
这篇文章是中文首发解读:它到底怎么工作的、装起来要几步、以及它没告诉你的三件事。先声明:本文基于仓库 README 与文档的研读,没有实际跑过完整流程,文中凡是”据文档”的表述都请按文档口径理解。
▲ 封面图:stack-diagram 关键信息速览(数字截至 11 月 3 日)

一、它是个 Claude Skill,不是独立 App
理解 stack-diagram,先要理解它是什么形态:它是一个 Agent Skill——一包给 AI coding agent 用的”工作手册”(SKILL.md + 脚本 + 资源文件),agent 读到之后就知道”哦,用户要画架构图,我该按这个流程办”。
安装只要一行:
npx skills add caru-ini/stack-diagram装好之后,它能在 Claude Code、Codex、Cursor,以及”支持 skills 的其他 agent”里被触发。在 Claude 的 App 版里,则是去 Releases 页下载 stack-diagram.zip 当 skill 上传。
这个形态选得很聪明:画架构图这件事,难的从来不是”画”,而是”知道该画什么、用什么图标、线怎么走不打架”。把这些 know-how 写成 skill,让 agent 去执行,比做一个独立 App 轻得多,也比每次手写 prompt 靠谱得多。
二、工作流程:四步,从一句话到成品图
▲ 图:stack-diagram 的工作闭环

按文档描述,整个流程是这样的:
- 理解:agent 读你的那句话,拆出技术栈组件(框架、数据库、鉴权、支付、CI……);
- 找 logo:去 svgl、devicon、gilbarbara/logos 这些图标库,或者 AWS / Google Cloud / Azure 各自官方的图标包,把每个组件的官方 logo 拉下来——关键是”官方原版”,不许重着色、不许重画;
- 画 + 自检:agent 渲染出图,然后自己检查一遍——线的走向不能穿过文字标签,有问题就修,修完再交付;
- 交付:默认给一个自包含 HTML 文件(字体和 logo 都内联,离线也能打开),也可以要 PNG、无依赖的 React 组件,或者直接发成 Claude artifact 分享链接。
每张图都同时渲染浅色和深色两套主题:色块保持白色让 logo 保持本色,组标签则切换成品牌在深色模式下的 logo 版本。这个细节是文档里明确写的,也是它跟”让 AI 随便画一张”拉开差距的地方。
三、画廊:画完之后,agent 会问你要不要公开展示
一个有意思的设计:画完之后,agent 会主动问一次要不要把图发到公共画廊 stacks.caru.moe。
公开展示的内容只有浅色/深色两张 PNG、英文标题、技术栈和一个展示名。文档里写了三重保险:你的原始 prompt 永远不会被发送;要你亲口确认两次才发布;GitHub 登录是可选的(只用来以后删除自己的帖子)。
这个画廊如果做起来,会变成一个”真实技术栈图鉴”——别人搜”Next.js + Supabase 的架构一般长什么样”,能直接看到现成的参考。对作者来说,这是零成本的获客;对社区来说,是真实案例库。双赢的设计。
四、它没告诉你的三件事
第一,logo 的版权处理得比你想象的认真。
架构图里用第三方 logo 是个灰色地带,作者的处理方式是:logo 不打包进 skill,而是在构建时现下载;来源只选 MIT / CC0 / ISC 许可的图标库或厂商官方包;脚本永远不改 logo 的颜色和形状。文档里甚至专门注明”微软允许 Azure 图标用于架构图、培训材料和文档”。这种法务意识在两天速成的开源项目里很少见。
第二,它有运行门槛。
文档 Requirements 里写着:需要 Python 3.9+,拉 logo 需要联网,PNG 导出要用 Playwright + Chromium。也就是说,它不是”装完即用”的零依赖小工具,第一次跑起来要装一圈东西。README 没藏着掖着,但中文自媒体转述时大概率会略过这一段——先给你打个预防针。
第三,star 涨得快不等于生产可用。
仓库 11 月 1 日创建,29 个 commit,4 个 release——迭代速度极快,但也意味着 API 和行为还在变。star 数(截至 11 月 3 日约 1200+)证明的是”大家觉得这个想法好”,不是”大家都在生产环境用”。如果你打算把它接进团队的文档流程,建议先在小项目上试两轮。
五、谁应该现在就去试
- 写技术方案的人:方案评审前,一句话生成一张像样的架构图,比手动画半小时强;
- 做布道 / 写文档的人:统一风格的架构图能让整个文档站点看起来专业一个档次;
- 带新人的技术负责人:“我们的系统长这样”——一张图胜过三页 onboarding 文档。
安装命令再贴一次:npx skills add caru-ini/stack-diagram,仓库地址 github.com/caru-ini/stack-diagram,MIT 协议。
Agent Skill 正在变成新的软件分发形态:以前我们分享的是 App,现在分享的是”让 AI 会干某件事的手册”。stack-diagram 是这个趋势里一个很漂亮的样本——它不训练模型、不调 API,只是把”画好一张架构图”的 know-how 写清楚,就换来了两天 1200 star。
接下来值得看的是:它的画廊能不能聚起真实案例,以及会不会有人把它做成”一句话生成任何图”的通用 skill。画廊的地址先收藏好:stacks.caru.moe。