cathrynlavery/diagram-design
效率工具让编码 Agent 按自然语言生成自带品牌配色的单文件 HTML/SVG 图表。
这是一个 Agent 技能包 · 1 个技能看技能清单和安装方法 →项目介绍
Diagram Design 是一个 Agent Skill,让编码 Agent 把一句自然语言描述变成单文件、内含 SVG 的 HTML 图表,适合要直接发布到博客、文档或幻灯片的人。支持 51 种图表类型,包括架构图、流程图、时序图、ER 图、时间线、象限图、甘特图和泳道图,每种都有浅色、深色和完整编辑排版三套静态变体。产物双击即可在浏览器打开,不需要构建步骤、JavaScript 或外部图片。
视觉规则是刻意收紧的:只用一个强调色、1px 细线边框、没有阴影、最大 10px 圆角,所有坐标落在 4px 网格上。它不替代画布编辑器,而是给能描述图表的人一套稳定的编辑风格,省去在 Figma 里反复调整。项目自己也说明:放在 Git 里、每个迭代都在改的图仍然更适合 Mermaid,这个工具面向要发布的成图。
安装与第一张图
通过跨 Agent 的 skills CLI 安装,它会识别 skills/diagram-design/SKILL.md,并把技能装进你选择的宿主目录:
npx skills add cathrynlavery/diagram-design
Claude Code 也可以走插件市场,带斜杠命令和更新能力:
/plugin marketplace add cathrynlavery/diagram-design
/plugin install diagram-design@diagram-design
Codex、Copilot、Factory Droid、Pi、Qoder、Kiro 和 OpenCode 各有安装方式,README 分开列出。若想先看自带示例,可从克隆的仓库中打开图库:
# macOS
open skills/diagram-design/assets/index.html
# Linux
xdg-open skills/diagram-design/assets/index.html
然后直接用自然语言向 Agent 要图,例如描述应用的前端、后端、数据库和缓存,让它画架构图。Agent 会选定类型、说明计划,并写出一个可双击打开的 .html 文件。单独用 npx skills add 安装不会跟随市场更新,需要用 npx skills update diagram-design 拉取合并后的更新。
品牌适配与配置文件
要让图表贴合现有网站,可以让 Agent 对某个 URL 执行 onboarding:抓取首页,提取主色板和字体栈,映射到 paper、ink、muted、accent、link 等语义角色,展示差异提案,确认后写入样式指南。写入前会检查 ink 在 paper 上的 WCAG AA 对比度。保存到 ~/.diagram-design/profiles/ 的命名配置可以让并行项目使用不同品牌,而不覆盖共享的样式指南。
导入、导出与输出限制
该技能可以把已有的 .drawio、Mermaid、Excalidraw 和 PlantUML 源文件重绘为同一套设计,而不只是格式转换。导入由格式、尺寸、细节程度和受众措辞四个旋钮控制,每次导入结束都有 fidelity ledger,列出哪些内容被合并、折叠或丢弃。SVG 导出可用于 Figma 和幻灯片;PNG 导出默认通过 Playwright 以 2× 栅格化,因此需要 pip install playwright && playwright install chromium。两种导出都只包含图本身,不包含完整变体里的编辑卡片和页眉。
默认图表从 Google Fonts 加载 Instrument Serif、Geist 和 Geist Mono,这是唯一的网络请求;把字体来源设为 system 后完全不联网。可选动效默认关闭,开启后带完整静态首帧,减少动效模式下会隐藏播放控件。仓库使用 MIT 许可证,Agent 每次只读取当前请求所需的图表类型参考。
HotRepo 点评
在 2026-11-19 的 GitHub 全部语言日榜快照中,Diagram Design 排到第 8 名,当天累计 68,341 Star。从 2026-09-08 到 2026-10-14 的日榜记录看,单日新增大多在 800 到 2,300 Star 之间,且多次超过 1,000,说明热度并非只来自一天的爆发。项目明确把自己放在 Mermaid 的对立面:Mermaid 更适合随迭代频繁变动的 Git 内图表,而它押注 Agent Skill 能产出更统一的发布级成图。它的本质是一组静态技能与参考文档,不提供运行时;成图质量取决于所用模型,同一提示两次布局可能不同,因此价值主要落在被写下来的设计规则和模板体系,而非确定性生成。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
Hacker News 讨论
相关推荐
- tt-a1i/archify让编程代理把想法、方案或代码库直接变成可交互、可分享的 HTML 图解。
- zarazhangrui/frontend-slides让编码 Agent 根据简介或 PowerPoint 生成单文件 HTML 演示文稿的技能。
- wevm/ondine把 Mermaid 图表在构建时编译成 SVG,页面只需挂载,不再在浏览器里加载完整渲染器。
- jgraph/drawio-desktop把 draw.io 图表编辑器封装成可离线运行的 Windows、macOS 和 Linux 桌面应用。
- mermaid-js/mermaid把类 Markdown 文本转成流程图、时序图、甘特图等图表,适合开发者和技术文档作者。