ClaudeMap

stack-diagram

一个把一句技术栈描述变成架构图的 Claude Code skill——图里每个产品都用官方 logo,产出可以是自包含 HTML 文件、PNG、无依赖 React 组件或 Claude artifact。

技能与命令skillarchitecturediagramdocumentationvisual

stack-diagram 是一个画架构图的 agent skill:像平时说话那样描述技术栈——Vercel 上跑 Next.js 和 Hono API,数据库是 Neon 的 Postgres,认证用 Clerk,支付用 Stripe,部署走 GitHub Actions——agent 画完还会先渲染检查一遍再交付。连线绕开标签走线,没有箭头穿过文字。logo 永不改色、永不重绘:skill 会依次从 svgl、devicon、gilbarbara/logos 获取,或直接从品牌自己的仓库取,AWS 架构图则使用 AWS 官方图标包。每张图都有亮色与暗色两版——底板保持白色以保留 logo 自身配色,分组标签切换成品牌暗色主题的 logo。默认产出是单个内联字体与 logo 的 HTML 文件,离线也能渲染,还能发布成 Claude artifact;PNG 与无依赖 React 组件由同一文件渲染。README 给的现成例子不止云服务:monorepo 工具链(Turborepo、Biome、Vitest、Lefthook 组成的 pnpm workspace)、AI 文档问答(Supabase pgvector、Inngest、Claude)与 AWS 拓扑(CloudFront、ALB、Fargate、RDS、ElastiCache)。可用在 Claude Code、Codex 与 Cursor;代码与文档均为 MIT 许可。

它做什么

  • 一句话进,一张核验过的图出——agent 先渲染再检查,确认无误才交付;连线绕开标签,没有箭头穿过文字
  • 官方 logo 替你取好——先 svgl、再 devicon、再 gilbarbara/logos,或直接从品牌自己的仓库获取;AWS 图使用 AWS 官方图标包;永不改色或重绘
  • 每张图亮暗双版本——底板保持白色以保留 logo 自身配色,分组标签切换成品牌暗色主题的 logo
  • 同一来源,四种格式——内联字体与 logo 的自包含 HTML(默认)、PNG、无依赖 React 组件,或 Claude artifact
  • 现成例子不止云服务——monorepo 工具链(Turborepo、Biome、Vitest、Lefthook 组成的 pnpm workspace)、AI 文档问答(Supabase pgvector、Inngest)与 AWS 拓扑(CloudFront、ALB、Fargate、RDS、ElastiCache)

什么时候用

任何需要一张架构图、且图必须忠于真实技术栈的场合:入职文档、设计评审、RFC 与 wiki 页面。一句话描述技术栈,产物可以直接放进仓库、发布成 Claude artifact,或以 PNG 交给同事。可跑在 Claude Code、Codex 与 Cursor;在 Claude 应用里则把 Releases 中的 stack-diagram.zip 作为 skill 上传。

如何上手

npx skills add caru-ini/stack-diagram

# 在 Claude 应用里:把 Releases 中的 stack-diagram.zip 作为 skill 上传

需要 Python 3.9+ 与网络访问(logo 在构建时获取)。PNG 导出使用 Playwright 与 Chromium。

注意事项

2026-11-01 创建(撰稿时 306 星):刚满一天,工作流预计还会持续变动。logo 在构建时联网下载、不随 skill 打包,因此需要网络访问,离线画不了;内置字体为 SIL Open Font License 1.1。品牌名与 logo 仍归各自所有者——在图中使用不构成背书,docs/ 的示例图含有第三方 logo。

代码仓库

caru-ini/stack-diagram

收录日期

地图上的相关资源

  • SureForge

    技能

    纯指令式 skill:让 agent 先调研再提问、先规划再动手、先验证再说「做完了」。

    • workflow
    • verification
    • quality
    • skill
  • 归藏的 Agent Skill:把代码库的最近更新做成一支成片宣传片——接真实组件、代码渲染动画、代码写配乐,全程不碰视频剪辑软件。

    • agent-skill
    • video
    • promo
    • marketing
  • 一个给「图里没有任何文字线索」的照片做地理定位的 Agent Skill——用 OSM 几何、高程天际线与卫星瓦片,把「这是哪」变成带误差半径的测量答案。

    • agent-skill
    • geolocation
    • osint
    • openstreetmap