项目2026-11-20 · 智涌AI

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

diagram-design 项目头图:左侧大字「diagram-design 画能发出去的图」与钩子「一句话出图,一种强调色、不加阴影」,三张数据卡为 45 种图型、68.8K GitHub 星、MIT 开源许可;右侧流程面板依次为描述、选型、出图、导出四步

让 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 北京时间)
支持的 AgentClaude 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 / PlantUMLdraw.io / Excalidrawdiagram-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

装之前看这几条

适合谁,不适合谁

适合要往博客、技术方案、汇报幻灯片里放图,又不想花半小时拖 Figma 的人;手上有一堆 draw.io 或 Mermaid 旧图想统一风格的团队也用得上。README 的「什么时候别用」写得很实在:列表用表格或要点,前后对比用表格,只有一个方框的「图」直接写成一句话。想让 Agent 画可交互的系统架构图,可以看站内写过的 Archify;想给整个代码库出一张地图,可以看 Floorplan。

最后

想试的话,挑一张你 README 里现成的 Mermaid 图,装好插件后跑一次 import-mermaid,把重画的结果和原图放在一起比一比。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。