AB
AiBoss
project

stack-diagram - 用一句话描述技术栈,生成带官方图标的架构图

stack-diagram 是一个面向 AI 编程代理的技能包:用一句自然语言描述你的技术栈,它就会生成一张带官方品牌图标的架构图,可输出为自包含 HTML、PNG 或无依赖的 React 组件。由 caru-ini 维护,MIT 许可,最新版本 v0.7.0。

stack-diagram 是一个面向 AI 编程代理的技能包(skill):你只要用一句自然语言描述自己的技术栈,代理就会据此生成一张架构图,并为图中的各项服务配上官方品牌图标。它解决的是「画架构图太费时间」这件事——不必手动拖拽画布、逐个找 logo、反复调整连线,描述清楚系统组成即可出图。适合需要快速产出架构示意的前后端工程师、技术写作者、做方案演示的团队,以及已经在使用 Claude Code、Codex、Cursor 等支持 skills 的代理工具的用户。

维护者与状态

项目由 caru-ini 维护,仓库创建于 2026-11-01,最后一次提交在 2026-11-19。最新正式版本为 v0.7.0,发布于 2026-11-18。截至 2026-11-19,仓库获得 2647 个星标。从时间线看,这是一个相当新的项目,版本迭代节奏较快,接口与输出形式仍可能随版本变化。

主要能力

以下能力据项目 README 自述整理:

  • 自然语言出图。README 给出的示例覆盖多种场景:Next.js 加 Hono API 部署在 Vercel、Postgres 用 Neon、认证用 Clerk、支付用 Stripe、GitHub Actions 负责部署;也包括纯开发工具链,例如 pnpm workspace 搭配 Turborepo、Biome、Vitest 与 Lefthook;以及 AI 应用,例如 Next.js 检索 Supabase pgvector 并由 Claude 作答、Inngest 每晚同步 Notion。
  • 官方图标自动获取。据项目说明,图标依次从 svgl、devicon、gilbarbara/logos 或品牌自有仓库获取;AWS、Google Cloud、Azure、Kubernetes 与 CNCF 项目图标来自各厂商自己的图标包。Databricks 没有官方图标包,因此其产品图标取自 databricks.com 的原始素材,经由社区的 databricks-architecture-icons 目录定位。README 强调图标从不重新着色或重绘。
  • 连线避让文字。项目自述连线会绕开标签,并且代理在交付前会先渲染并检查一遍图。
  • 多种输出格式。默认输出一个自包含的 HTML 文件,字体与 logo 全部内联,无网络也能渲染;也可输出 PNG、无依赖的 React 组件,或作为 Claude Artifact 发布。PNG 与 React 组件由同一个文件渲染而来。
  • 明暗双主题。每张图都同时渲染明色与暗色两版,色块保持白色以保留 logo 自身配色,分组标签则切换为品牌的暗色主题 logo。
  • 可选发布到公共画廊。出图后代理会询问一次是否发布到公共画廊,并展示将要公开的内容(明暗两张 PNG、英文标题、技术栈与显示名),需要用户两次确认后才会发布;提示词不会被发送。GitHub 登录是可选的,且不会公开展示,仅用于日后删除该条目。

使用入口

仓库地址:caru-ini/stack-diagram。

据 README,安装方式为通过 skills 命令添加:

npx skills add caru-ini/stack-diagram

项目说明该方式适用于 Claude Code、Codex、Cursor 以及其他支持 skills 的代理。在 Claude 应用中,则从 Releases 下载 stack-diagram.zip 作为 skill 上传。

运行前置条件:需要 Python 3.9 及以上版本,并且获取 logo 时需要网络访问;导出 PNG 依赖 Playwright 与 Chromium。

许可与限制

项目代码与文档采用 MIT 许可证。README 另外说明:内置字体为 SIL Open Font License 1.1;logo 并不随技能包分发,而是在构建时从上述各图标来源或品牌自有站点、仓库下载,各来源分别适用其自身许可(如 devicon 为 MIT、gilbarbara/logos 为 CC0、Kubernetes 社区图标为 Apache-2.0 / CC-BY-4.0、Lucide 为 ISC 等)。所有品牌名称与 logo 均为各自所有者的商标,出现在图中不代表背书;脚本不会重新着色或改动 logo。

使用边界方面,README 提到 Databricks 图标目录为社区维护、非官方且未获 Databricks 认可,素材版权仍归 Databricks。此外,项目依赖代理工具运行,并非独立的图形界面应用;PNG 导出需要额外的浏览器运行时,离线环境下只能使用已内联资源的 HTML 输出。