● EP91 · 一天一个新Skill 2026-11-18 · 一天一个新Skill
stack-diagram · agent skill

一句话,出一张架构图

stack-diagram 本机实测。官方 logo、2000×1080 的图、release 包 105.4 kB。装法里有一条我没跑通,也写在这一页。

★ 2,595 MIT v0.6.0 release zip 105,397 B 全链路 ≈24 s
左边一句话,右边自动长成一张架构图
首屏:左边一句人话,右边由方块与连线长成架构图。
01

一句话进去,图出来

我给它的原句是这一句,英文,没有指定节点,也没给坐标:

实际输入Next.js and Postgres and Redis for a SaaS.

出来的图是 2000×1080。上面一个 Vercel 分组框,里面是浏览器里的小人、Next.js 的 web app 和 HTTPS 连线;下面一个 Data layer 分组框,PostgreSQL 和 Redis 并排,分别标着 primary db 和 cache。SQL 与 cache 两条连线把两层接起来。

四个品牌 logo 都是原件,没有重新上色。分组框、连线的起止点、标签怎么避让,是它自己算的。

从敲命令到两张 PNG 落盘,大约 24 秒,不含下载 release 包的 1.85 秒。取 logo 花了 11.7 秒,也是唯一需要联网的一步。

一句话描述生成的 SaaS 架构图,含 Next.js、PostgreSQL、Redis、Vercel 四个官方 logo。
一句话描述,直接长成部署架构图 原图 2000×1080,此处无损裁切
演示视频槽位 · 成片到后填入 src
演示 · 从一句话到两张 PNG(成片槽位)
02

它到底做了什么

它是一份 Agent skill,没有画布可以拖,也不靠生图模型拼图。Agent 先把节点、分组、连线定下来,填进模板;工具负责取 logo、算坐标、把资源内联、截图。分工清楚了,图才稳定。

第一步 · 11.7 s

取 logo

fetch_icons.py 按 svgl、devicon、gilbarbara/logos 的顺序查。本机这批图标全部来自 svgl。这是唯一联网的步骤。规则是 logo 永不重上色,浅色 logo 就放到深色底板上。

fetch_icons.py <icons-dir> nextjs postgresql redis vercel
第二步 · <1 s

组装

build.py 把图标和字体转成 base64 塞进一个 HTML。本机产物 105,408 字节。从这一步之后,断网也能渲染。

build.py draft.html icons out.html --fonts assets/fonts
第三步 · 11.7 s

渲染

render_png.py 用 Playwright 驱动 Chromium 截 .canvas,--scale 2。出两张 2000×1080:light 87,917 字节,dark 94,703 字节。

render_png.py out.html out.png --selector .canvas --scale 2
03

本机实测账本

测量窗口 2026-11-18 13:46–13:59 CST;主机 macOS 27.2 / arm64 / Node v26.7.0 / npm 11.19.0 / Python 3.15.2。每条都能指回命令和输出。

项目实测值命令与关键输出
star2,595curl -sS https://api.github.com/repos/caru-ini/stack-diagram → "stargazers_count": 2595(13:45 与 05:46Z 两次同值)
fork140同一响应 → "forks_count": 140
许可MIT同一响应 → "license": {"spdx_id": "MIT"}
open issues1同一响应 → "open_issues_count": 1
最新 releasev0.6.0 · 2026-11-13releases API → tag_name v0.6.0,published_at 2026-11-13T07:38:20Z,共 6 个 release
release 包105,397 字节 = 105.4 kB = 102.93 KiBasset size 105397;下载后 wc -c = 105397,sha256 821ed618…
解压25 个条目(19 文件 + 6 目录)/ 160,364 字节unzip -l;find -type f / -type d 各计一次
技能目录212Kdu -sh skills/stack-diagram
SKILL.mdv0.6.0 22,137 字节;main 23,938 字节本地 wc -c vs contents API
取 logo11.7 秒fetch_icons.py → real 11.706s,四个品牌加 Vercel 深色版全部 OK ... svgl
组装不到 1 秒 → 105,408 字节build.py → built out/saas.html (102 KB);html_bytes = 105408
单文件自检data:image 6 / data:font 2 / 未解析 %%TOKEN%% 0见 evidence.md §4.2
渲染11.7 秒 → 2000×1080render_local.py → real 11.68s;light 87,917 字节,dark 94,703 字节
全链路约 24 秒(不含下载)11.7 + <1 + 11.7
仓库 size3,450 KB"size": 3450,这是仓库体积,不是包体积
04

怎么装

两条路径并列写:一条是我没跑通的官方文档装法,一条是我实际走通的 release zip。哪条是实测,标清楚。

Release zip · 我实际走通的

下载官方 release 解压

curl -sSL -H 'Accept: application/octet-stream' -o stack-diagram.zip \
  https://api.github.com/repos/caru-ini/stack-diagram/releases/assets/742744355
unzip -q stack-diagram.zip -d skills

GitHub Releases 里 v0.6.0 提供了 stack-diagram.zip,README 把这条列为 Claude apps 的装法。unzip 退出码 0,得到 skills/stack-diagram:19 个文件(连目录共 25 个条目),212K,SKILL.md 22,137 字节。

一个网络上的坑:github.com/.../releases/download/... 直链在我这台机器上 15 秒连不上,302 之后超时。走 API asset 端点 1.85 秒就下完了,文件是同一个,105,397 字节。

装完需要:Python 3.9+;要出 PNG 还要 Playwright 和 Chromium。取 logo 需要网络,build 之后不需要。
仓库:github.com/caru-ini/stack-diagram(纯文本)
05

适合谁,不适合谁

适合

  • 你手里有一句能说清架构的话,想让 Agent 画成工程图。
  • 你要官方 logo 和规整的正交连线,不想手动挪方块。
  • 你要一个单文件 HTML,或者能贴进文档的 PNG。

不适合

  • 你想要一个拖拽画布。这是 Agent skill,不是编辑器。
  • 你一点网都不想连。取 logo 必须联网。
  • 你要它替你想架构。它画的是你说出来的结构;结构错了,图会错得很整齐。
06

边界与未验证项

没跑通的、只有单次计时的、只在一种输入上试过的,都列在这里。

  1. 官方 npx skills add caru-ini/stack-diagram 在本机被宿主安全复核拦下,未实测通过。
  2. 本机渲染用的是系统安装的 Google Chrome,不是 render_png.py 默认的 Playwright headless-shell(chromium_headless_shell-1255 在沙箱时间预算内没下下来)。截图语义(.canvas、--scale 2、去圆角、明暗双主题)逐行照抄原脚本,差异只在浏览器可执行文件。
  3. 本机全部读数属于 release v0.6.0,它的 SKILL.md(22,137 字节)落后于仓库 main(23,938 字节)。
  4. size: 3450 是 GitHub 的仓库体积字段(KB),不是包体积。包体积是 105,397 字节,两者别混用。
  5. 只测了一个输入:一句英文,四个技术。多语言、AWS / Google Cloud / Azure 的官方图标集、TSX 输出没有在本机跑。
  6. 取 logo 的 11.7 秒,计时来自第一次 fetch_icons.py 调用(nextjs / postgresql / redis);Vercel 是随后单独一次调用,没有单独计时,evidence.md 按整批合计记为 11.7 秒。复跑时若要逐次计时,数字可能不同。