diagram-design 是什么:让 Agent 画出能直接发的图

让 Agent 画架构图,多数时候拿到的是一堆圆角方框、几种马卡龙底色,和你的博客或幻灯片完全不搭。diagram-design 是一个 MIT 开源的 Agent Skill,把一套「编辑部风格」的画图规矩写进了 SKILL.md:你用一句话描述要什么图,Agent 选图型、说明打算怎么画,最后交出一个双击就能打开的 HTML 文件。这篇按官方 README、SKILL.md、CHANGELOG 和隐私说明(截至 2026-11-20 的 2.6.168 版),讲它能画什么、怎么装、导入导出怎么用。
它是什么
diagram-design 是作者 Cathryn Lavery 给自己博客配图时写的 Skill。她在 README 里说,模型其实看得懂内容,缺的是审美,所以她把审美写成了规则:全图只有一种强调色,只留给读者最该先看的一两个元素;1px 细线,不加阴影,圆角最大 10px;所有坐标、宽度、间距都是 4 的倍数。
| 仓库 | github.com/cathrynlavery/diagram-design |
|---|---|
| 作者 | Cathryn Lavery(插件目录由她的公司 LittleMight 发布) |
| 许可证 | MIT |
| 热度 | GitHub 68,844 星、4,625 fork(GitHub API);skills.sh 累计安装 30.6K 次(均为 2026-11-20 北京时间) |
| 支持的 Agent | Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、Factory Droid、Qoder、Pi 等读取 Agent Skills 的工具 |
| 最新版本 | 2.6.168(插件清单 2026-11-19 08:17 北京时间更新) |
和 Mermaid、draw.io 怎么选
README 自己列了一张对比表,也把短板写得很直接:
| Mermaid / PlantUML | draw.io / Excalidraw | diagram-design | |
|---|---|---|---|
| 怎么做 | 写文本 | 手动拖形状 | 用一句话告诉 Agent |
| 布局 | 自动 | 手动 | Agent 按 4px 网格摆放,CI 检查重叠和裁切 |
| 产物 | GitHub 能直接渲染的文本 | 可编辑的源文件 | 一个内联 SVG 的 HTML,可导出 SVG/PNG |
| 以后要改 | 改文本 | 改画布 | 再问一次 Agent,或手改 SVG |
短板也写在 README 里:画出来的效果取决于你用的模型,同一句提示词两次布局可能不一样;产物不是可编辑的源格式,PR 里没法 diff。放在 Git 里、每个迭代都要改的文档图,作者建议继续用 Mermaid,这个 Skill 适合要发出去的那张图。
怎么用
1. 安装。通用方式是 Vercel 的 npx skills,会把整个 Skill(含参考文档、模板和脚本)装进你选的 Agent 目录:
npx skills add cathrynlavery/diagram-design
Claude Code 用户可以走插件市场,这样能拿到自动更新和导入导出的斜杠命令:
/plugin marketplace add cathrynlavery/diagram-design
/plugin install diagram-design@diagram-design
Codex 对应 codex plugin marketplace add cathrynlavery/diagram-design 再 codex plugin add diagram-design@diagram-design。README 提醒,只用 npx skills 装的话只有 Skill 本体,/export-diagram、/import-mermaid 这些命令要装插件版才有。
2. 用大白话提需求。README 给的例子:
给我的应用画一张架构图:前端、后端、数据库、Redis 缓存
做一个象限图,按影响和工作量排第二季度的项目
画一个带 401 后刷新令牌的 Bearer 调用时序图
Agent 会先说明选了哪种图型、什么尺寸、打算删掉什么,再动手画。
3. 第一次用先配品牌。在新项目里第一次画图时,如果样式表还是默认的黑色加橘色,SKILL.md 规定 Agent 要停下来问你:给网址、给本地设计规范、手贴色值,还是就用默认。说一句「onboard diagram-design to 你的网址」,它会抓首页的底色、正文色、强调色和字体,先给你看改动,你确认后才写进样式表,写之前还会检查文字对比度是否达到 WCAG AA。多个客户项目可以各存一份配置,在项目里放一个 .diagram-design 标记文件指定用哪份。
它的思路是先删再画:每个节点都要有理由留下,强调色只给一两个地方。
导入旧图和导出
手上已有的图可以直接交给它重画,插件版的命令长这样:
/diagram-design:import-drawio platform.drawio --size=slide-16x9 --detail=simplified --audience=executive
/diagram-design:import-mermaid README.md --diagram=all
/diagram-design:import-excalidraw whiteboard.excalidraw
/diagram-design:import-plantuml sequence.puml
四个参数分别管输出格式、尺寸(文档内嵌、16:9 幻灯片、社交卡片、A4 打印等)、保留多少节点(faithful 最多 24 个,balanced 最多 12 个,simplified 最多 7 个)和措辞面向谁(工程师、混合、管理层)。每次导入最后会列一份清单,写明哪些节点被合并、折叠或删掉。原图的坐标、配色和字体都不会带过来。PlantUML 只支持时序图和类图。
导出用 /diagram-design:export-diagram 文件.html,加 --svg-only 或 --png-only --scale=3。PNG 靠 Playwright 渲染,第一次要先装:
pip install playwright && playwright install chromium
装之前看这几条
- 默认会连 Google Fonts。生成的图从 Google Fonts 加载 Instrument Serif、Geist、Geist Mono 三种字体,这是唯一的网络请求。国内打开慢的话,让它用系统字体,文件就完全不联网。
- 没有服务器和遥测。隐私说明写明 LittleMight 不收任何数据,品牌配置存在本机
~/.diagram-design/profiles/。只有你要求按网址配品牌时,Agent 才会去抓那个网站。 - 认准官方仓库。README 说官方构建只来自这个仓库,插件目录里用其他名义发布的是非官方副本。
- 能自查。生成的文件可以跑
python3 skills/diagram-design/scripts/self_check.py 文件.html,输出OK才算合格,加--offline会连 Google Fonts 链接一起拦下。
适合谁,不适合谁
适合要往博客、技术方案、汇报幻灯片里放图,又不想花半小时拖 Figma 的人;手上有一堆 draw.io 或 Mermaid 旧图想统一风格的团队也用得上。README 的「什么时候别用」写得很实在:列表用表格或要点,前后对比用表格,只有一个方框的「图」直接写成一句话。想让 Agent 画可交互的系统架构图,可以看站内写过的 Archify;想给整个代码库出一张地图,可以看 Floorplan。
最后
想试的话,挑一张你 README 里现成的 Mermaid 图,装好插件后跑一次 import-mermaid,把重画的结果和原图放在一起比一比。