Community写作与编辑github.com

draw.io 图表制作技能

生成美观的 draw.io 图表,并强制执行视觉质量检查循环,确保你的智能体构建的图表看起来完全正确。

draw.io 图表制作技能 是什么?

该技能允许 AI 智能体(如 Claude 或 Cursor)自动生成专业且美观的 draw.io 图表。它支持广泛的图表类型,包括流程图、ERD、架构图、类图和序列图。技能的核心是一个强制性的可视化审查循环:智能体在导出 PNG 后必须读取并检查布局,确保文本不重叠、间距正确(至少 15-20 像素),然后再进行迭代。XML 生成严格遵循预定义的盒模型样式标准(包含 `spacingLeft=12` 等属性)并采用硬编码坐标,避免了 draw.io 原生自动布局的局限性。该技能适用于 macOS 和 Linux 环境,利用 CLI 工具导出为 PNG、SVG、PDF 等格式,并驱动用户选择最终输出格式(可编辑的 .drawio 文件或多种渲染格式)。通过系统化地规划所有节点和连线,并在最终交付前进行视觉验证,该技能解决了 AI 生成图表常见的格式混乱问题,显著提升了图表的质量和可用性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add Spotlight-Revenue/drawio-diagrammer-skill

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

draw.io 图表制作技能 是做什么的?

何时使用此技能

  • 用户请求流程图、过程图或工作流图
  • 用户请求 ERD、数据库图或实体关系模型
  • 用户请求架构图、系统图或组件图
  • 用户请求类图、时序图或 UML 图
  • 用户提到“draw.io”、“diagram”、“flowchart”、“visualize this process”
  • 用户要求更新、修复或扩展现有的 .drawio 文件

必读 —— 在生成任何内容之前请阅读

  1. 首先检测图表类型 —— 在编写 XML 之前,请参见 diagram-types/ 引用文件
  2. 应用通用盒模型样式标准 —— 请参见 references/box-style-standards.md
  3. 所有位置均为硬编码 —— draw.io XML 中没有自动布局功能
  4. 每次导出后运行可视化审查循环 —— 请参见 references/visual-review-protocol.md
  5. 没有进行可视化检查前,绝不要声明完成 —— 导出 PNG,读取,修复,重复

图表类型检测

用户提及的关键词引用文件
“流程图”、“过程”、“步骤”、“工作流”、“SOP”references/diagram-types/flowchart.md
“ERD”、“数据库”、“表”、“实体”、“外键”references/diagram-types/erd.md
“架构”、“系统”、“组件”、“服务”references/diagram-types/layout.md
“类”、“UML”、“继承”、“方法”、“属性”references/diagram-types/class.md
“序列”、“交互”、“生命线”、“参与者调用”references/diagram-types/sequence.md

标准生成工作流

步骤 1 —— 加载类型引用

在编写任何 XML 之前,先读取正确的 references/diagram-types/ 文件。

步骤 2 —— 规划所有元素

在编码之前,列出每个节点、连接和区域。不要在构建过程中即兴调整布局。

步骤 3 —— 应用通用盒模型样式

每个节点必须包含来自 references/box-style-standards.md 的通用间距属性。

步骤 4 —— 创建输出文件夹并编写 XML

mkdir -p ./diagrams

保存到:

./diagrams/<diagram-name>.drawio

保存前检查清单:

  • 所有 mxCell 元素具有唯一的顺序数字 ID
  • 对每个节点样式应用了通用盒间距:spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top;
  • 箭头使用链式路由,而非从单一源到多个目标的扇出
  • 任意两个框之间至少有 15–20px 的间距(验证子项列表底部与下一节顶部之间的间距)
  • 高度使用 box-style-standards.md 中的公式计算(在 fontSize=10 时每行 ×16px)
  • 宽文本面板(注释、描述)宽度为 530px 及以上 —— 而不是 460px 或更小
  • 在 value 属性中不要使用字面 \n —— 使用 &#xa; 表示换行
  • 在所有多行内容框上设置 verticalAlign=top

步骤 5 —— 导出 PNG 并运行可视化审查循环

/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<name>.png --scale 2 --border 30 ./diagrams/<name>.drawio

然后按照 references/visual-review-protocol.md 中的完整协议操作。

步骤 6 —— 交付

首先向用户发送 PNG。对于较大的图表,在发送完整图像之前,先发送局部截图(顶部、中部、底部)。

然后询问他们想要哪些附加格式:

图表已准备就绪。您想要哪种格式?

1 —— PNG 图像(可直接查看)
2 —— .drawio 文件(可在 draw.io 中编辑)
3 —— SVG(可缩放矢量图)
4 —— PDF
5 —— 以上全部

请回复对应的数字。

对于通过 Drive 交付或自定义输出路径,请遵循 references/workflow-sop.md。


CLI 参考

# macOS —— 导出 PNG(标准)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>

# macOS —— 导出高分辨率 PNG
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 3 --border 30 <file.drawio>

# macOS —— 导出 SVG
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <out.svg> <file.drawio>

# macOS —— 导出 PDF
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <out.pdf> <file.drawio>

# Linux / 无头模式 —— 导出 PNG
xvfb-run -a drawio --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>

# Linux / 无头模式 —— 导出 SVG
xvfb-run -a drawio --export --format svg --output <out.svg> <file.drawio>

相关技能