如何一句话描述你的技术栈?10个stack-diagram提示词技巧与实战案例清单
如何一句话描述你的技术栈?10个stack-diagram提示词技巧与实战案例清单
还在用 PPT 和方框箭头手绘架构图吗?开源项目 stack-diagram 是一个 Agent skill(技能插件):你用一句话描述技术栈,AI 编码助手就能自动生成一张带有官方品牌 Logo 的云厂商风格技术架构图,输出自包含 HTML、PNG 或 React 组件,浅色/深色主题一次出齐。本文整理 10 个实用提示词技巧与 3 组实战案例,帮你快速上手 stack-diagram。
一分钟了解 stack-diagram
安装完成后,只需在对话里输入一句类似下面这样的描述,Agent 就会完成"规划节点 → 拉取官方 Logo → 布局连线 → 渲染校验 → 交付"的完整流程:
Diagram our stack: Next.js and a Hono API on Vercel.
Postgres on Neon, auth with Clerk, payments with Stripe. GitHub Actions deploys.
它的几个核心优势:
- ✅ 官方 Logo,自动获取:按 svgl → devicon → gilbarbara/logos → 品牌官网的顺序下载,AWS 图标直接取自 AWS 官方架构图标包,绝不重绘、不改色
- ✅ 箭头不穿文字:连线自动绕行标签,Agent 会先渲染 PNG 检查,确认无误再交付
- ✅ 多格式输出:自包含 HTML(默认,离线可看)、PNG、无依赖的 React/TSX 组件、Artifact 页面
- ✅ 深浅双主题:瓷砖保持白色以保护 Logo 原色,分组标签自动切换深色版图标
安装方法:一条命令
npx skills add caru-ini/stack-diagram
适用于 Claude Code、Codex、Cursor 及其他支持 skills 的 Agent。如果偏好本地克隆,也可以:
git clone https://gitcode.com/gh_mirrors/st/stack-diagram
运行环境要求:Python 3.9+,联网获取 Logo;导出 PNG 需要 Playwright + Chromium(pip install playwright && python3 -m playwright install --with-deps chromium)。
10 个 stack-diagram 提示词技巧
1️⃣ 一句话讲清"谁调用谁"。不要只罗列工具名,用短句描述数据流:User → Next.js → Hono → Neon。有流向,图才有主干。
2️⃣ 为每个组件加一句小角色描述。例如 Postgres on Neon(数据库)、auth with Clerk(认证)、payments with Stripe(支付),Agent 会自动生成 serverless postgres、auth 这类小字副标题。
3️⃣ 明确"部署关系"用动词 deploy 表达。比如 GitHub Actions deploys,提示词里一句部署描述,图上就多出一条规范的虚线部署流。
4️⃣ 用分组名词圈定边界。像 on Vercel、a pnpm workspace 这样的表述,会让 Agent 自动画出云厂商风格的分组容器(VPC、工作区盒子)。
5️⃣ 开发工具链也能画,不局限于云。CI、测试、格式化、git hooks 同样适用:Draw our monorepo tooling: a pnpm workspace with Turborepo, Biome, Vitest and Lefthook.
6️⃣ AI 应用要写清"检索 + 生成"两段。例如 Next.js on Vercel searches Supabase pgvector and answers with Claude,向量检索和大模型调用会呈现为两条清晰的边。
7️⃣ 定时任务单独说明。Inngest syncs Notion every night 这类夜间同步关系会以中性虚线表达,与主请求路径区分开。
8️⃣ AWS 图直接点名 AWS 服务。CloudFront in front of S3 and an ALB in a public subnet. Fargate, RDS and ElastiCache sit in a private subnet.——公共/私有子网划分是 AWS 图的灵魂,务必写清。
9️⃣ 指定输出格式。在提示词末尾加 and export a PNG 或 as a React component,Agent 默认交付 HTML,其余格式按需派生。
🔟 不满意就让它"看图改"。skill 内置了渲染校验环节(见 render_png.py),你可以直接说"箭头穿过文字了,重新布局",它会重新渲染、自检后再交付。
实战案例:三张真实效果图
案例 1:AI 文档聊天机器人
提示词:Draw our docs chatbot: Next.js on Vercel searches Supabase pgvector and answers with Claude. Inngest syncs Notion every night.
蓝色的主请求路径(question → vector search → prompt)与灰色的后台任务流(nightly sync → embeddings)分区明确,一眼看懂。
案例 2:AWS 完整架构
提示词:Draw our app on AWS: CloudFront in front of S3 and an ALB in a public subnet. Fargate, RDS and ElastiCache sit in a private subnet.
注意 VPC → 子网 → 服务的分层方框与 AWS 官方图标,这正是"一句话提示词"能达到的完成度。
案例 3:深浅色主题一键双出
每张图都会同时渲染浅色与深色两个版本:瓷砖保持白色保护 Logo 原色,分组标签切换为品牌深色图标。
交付形态:一个 HTML 文件走天下
最终产物是一个把所有字体、Logo 内联的自包含 HTML 文件——无网络也能渲染,可以直接发布为 Artifact 分享链接,或丢进仓库、wiki。PNG 与 React 组件都从同一份 HTML 派生,保证三种形态完全一致。
进阶:源码与参考资料
想深入定制或了解生成原理,建议按顺序阅读仓库中的这几份资料:
| 资料 | 说明 |
|---|---|
| SKILL.md | 核心技能定义:六步工作流、Logo 规则、AWS 绘图规范 |
| references/geometry.md | 坐标系统、间距常量与防穿字连线规则 |
| references/tsx.md | 将 HTML 转换为无依赖 React 组件的方法 |
| scripts/fetch_icons.py | 官方 Logo 抓取脚本(svgl/devicon/AWS 图标包) |
| scripts/render_png.py | 无头 Chromium 截图脚本,支持双主题、2x 清晰度 |
| assets/template.html | 图面模板,同时充当格式文档 |
| assets/fonts/README.md | 内嵌的 Geist 与 JetBrains Mono 字体说明 |
快速上手清单
- 用
npx skills add caru-ini/stack-diagram安装技能 - 组织一句包含"组件 + 角色 + 流向 + 分组"的英文/中文描述
- 在 Claude Code / Cursor 中粘贴提示词,等待 Agent 渲染并自检
- 交付后按需追加
export a PNG或as a React component - 对细节不满意?直接指出问题点,让它看图重画
一句话总结:把技术栈讲成一句话,stack-diagram 就还你一张可直接放进文档和评审会的官方 Logo 架构图。





