
字节笔记本
2026年11月3日 · 约 4 分钟读完
一句话说出技术栈,架构图自己长出来
架构图是工程师最懒得画的东西之一,现在可以嘴炮了。stack-diagram 是一个刚发布的 Agent Skill:用自然语言一句话描述技术栈,直接得到一张带官方 Logo 的架构图。示例提示词长这样:「Diagram our stack: Next.js and a Hono API on Vercel. Postgres on Neon, auth with Clerk, payments with Stripe。」安装一行:npx skills add caru-ini/stack-diagram,Claude Code、Codex、Cursor 都能用。仓库 11 月 1 日创建,两天拿了 1,450 星、60 fork,MIT 协议,作者是东京东洋大学 INIAD 的学生 caru-ini,单人维护。

一、核心设计:Logo 永不改色
它和一般「AI 画图」的分界线画得很清楚:Logo 必须用官方原版,永不重上色。抓取链是 svgl 到 devicon 到 gilbarbara/logos 再到品牌官方仓库,simple-icons 被明确拒绝,理由很实在:单色重绘的 Logo 一眼假。三大云更是各自遵守官方制图规范:AWS 要画在子网里,GCP 的 region 要在 VPC 内,Azure 服务要用全称。明暗双主题,暗色模式不会把深色 Logo 糊成一片。
输出有四种形态:自包含 HTML 是唯一的事实源,字体和 Logo 全部 inline,离线也能打开;PNG 用无头 Chromium 截图;还能导出 React/TSX 组件和 Claude Artifact。设计上最难得的一条是强制人眼验收:渲染 PNG 后必须真看一遍,箭头不许压文字。分享到画廊要双重确认,提示词本身永不上传,还会提醒你检查截图里有没有内网信息。
二、和 Mermaid 的分工
Mermaid 是手写 DSL,结构自己想、语法自己写;stack-diagram 是自然语言进,LLM 决定节点、分组和边,坐标按规则排,学习成本为零。代价是边界也硬:它只做架构图、技术栈图和拓扑图,流程图、时序图、ER 图都不归它管。两者其实是上下游,想精修结构时 Mermaid 依然是工具。
三、冷水:五条都成立
一,项目只有两天,复杂系统的排版质量未经大规模验证,现在画微服务全家桶大概率会挤。二,单人学生维护,bus factor 等于 1,好在 MIT 加 60 个 fork 是天然缓冲。三,Logo 源依赖第三方仓库,断网或上游变动时新 Logo 抓不到。四,装 skill 等于运行别人的代码。作者这次把脚本读了:纯标准库、无混淆,但也没有逐行审计,这个姿势值得每个装 skill 的人保持。五,商用文档里用各家 Logo,商标责任在使用者自己,与项目无关。

四、判断
短期看这是「一句话出架构图」的效率工具;拉远看,它更像是 Skill 作为 Agent 时代软件分发形态的一个好样本:一行 npx 给 agent 装上一个原本不存在的能力,不装 App、不配服务,能力随装随删。画架构图这件事小,但「需求用嘴说、产物直接出、规则预先编码」这个配方,放在哪个领域都成立。画廊里已经挂了一批社区作品,stacks.caru.moe 可以直接翻。


