1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | stack-diagram |
| 作者/维护者 | caru-ini |
| 来源链接 | https://github.com/caru-ini/stack-diagram |
| 许可证 | MIT(随附字体为 SIL OFL 1.1) |
| GitHub Stars / Forks | 1,149 / 50(GitHub API,2026-11-03 读取) |
| 最新版本 | 有 Release 标签;主分支最近一次提交 2026-11-02 |
| 安装方式 | npx skills add caru-ini/stack-diagram;需要 Python 3.9+,取图标时要联网,导出 PNG 还要 Playwright 与 Chromium |
数据来源:上述数字取自 GitHub API;功能与评分依据来自仓库 README、SKILL.md 与脚本说明。
2. 功能介绍与亮点
一句话:用一句话描述你的技术栈,得到一张带官方 Logo 的架构图——白底图标、分组框、正交箭头,像云厂商的参考架构图。
- 真 Logo,不是字母方块:脚本按 svgl → devicon → gilbarbara 的顺序取图标,AWS 走官方图标库,也可以直接给 URL。
- 工程制图风格:白底图标、带标签的分组容器、单色等宽字体标注的正交连线、冷灰网格纸背景。
- 一份源,多种交付:自包含 HTML 是唯一真相源,PNG、React/TSX 组件与在线 artifact 都从它派生。
- 分组与拓扑:支持 VPC 式的嵌套分组、同层服务、跨组连线,适合画「谁调用谁、部署在哪」。
- 可选发布:能一键分享到公开画廊(默认不分享,需显式操作)。
3. 适用场景
所属分类:数据分析与可视化。
- 给 README、设计文档或 RFC 配一张能直接看的架构图;
- 方案评审时快速对比几种部署拓扑;
- 新人入职材料里说明系统由哪些服务组成、怎么连;
- 想把架构图当代码管理、随仓库一起版本化的团队。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能安装后用自然语言触发 |
| Codex | 需适配 | 技能正文通用,脚本调用与目录约定需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行 Python 脚本 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
架构图的麻烦不在画,而在「Logo 找不齐、箭头对不齐、每次改都要重画」。这个技能把取图标、摆位置、连箭头都交给脚本,你只负责说清楚有哪些服务和依赖;产出的 HTML 还能继续改,下次调整不用从头再来。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 建仓两天 1,149 stars、50 forks,传播集中在开发者社区 |
| 可用性 | 8 | 一条命令安装,Python 标准库即可运行;导出 PNG 需要额外的 Playwright 与 Chromium |
| 安全性 | 8 | 见下方清单;取图标会访问固定的几个公开来源,不收集凭据 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 仓库内 Python 脚本负责取图标、生成 HTML 与导出;作用域限于工作目录 |
| ② 联网外发 | 只访问图标来源(svgl、devicon、gilbarbara、AWS 图标库与用户显式给出的 URL),不上传项目内容 |
| ③ 凭据 | 不需要任何 API key 或账号 |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | 公开作者与仓库,有 Release;issue 为空,暂无社区争议 |
| ⑥ License | MIT;字体单独标注 OFL |
| ⑦ 维护时间 | 2026-11-02 仍在更新 |
扣分点:图标依赖外部源,冷门技术可能取不到;PNG 导出要装浏览器内核;分享画廊是公开行为,需谨慎。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| drawio-skill | 生成/编辑 draw.io 图表 | 产出是 draw.io 工程文件;stack-diagram 产出可直接嵌网页的自包含 HTML 与图片 |
| archify | 架构图生成 | 更偏图形组织;stack-diagram 强调真实 Logo 与云厂商式分组 |
| oh-my-mermaid | Mermaid 图 | 文本语法、可版本化;stack-diagram 更像成品图,适合直接给人看 |
核心差异:同类要么给工程文件、要么给文本语法,它给的是一张「已经能贴进文档」的成品图,同时保留可编辑的 HTML 源。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价,仓库 issues 为空(2026-11-03)。
9. 其他补充
- 图标是各品牌的商标,公开发布前确认使用方式符合对方的品牌规范。
- 随附字体为 SIL OFL 1.1,可随产物分发。
- 产物是一份自包含 HTML,离线可打开,适合随仓库提交。
10. 安装使用方式
npx skills add caru-ini/stack-diagram
装好后直接说,例如:
画一下我们的栈:Next.js 和 Hono API 部署在 Vercel,Postgres 在 Neon,认证用 Clerk,支付用 Stripe,GitHub Actions 部署。
默认得到 HTML;要 PNG 就说「导出成 PNG」。
11. 注意事项
- 取图标需要联网,离线环境只能手动画或自带图标。
- 冷门或自研技术可能没有现成 Logo,需要给 URL 或接受占位。
- 导出 PNG 需要 Playwright 与 Chromium,首次安装体积较大。
- 分享到公开画廊会把图发布到互联网,确认内容不含内部信息再操作。