draw.io 图表制作技能 是做什么的?
何时使用此技能
- 用户请求流程图、过程图或工作流图
- 用户请求 ERD、数据库图或实体关系模型
- 用户请求架构图、系统图或组件图
- 用户请求类图、时序图或 UML 图
- 用户提到“draw.io”、“diagram”、“flowchart”、“visualize this process”
- 用户要求更新、修复或扩展现有的
.drawio文件
必读 —— 在生成任何内容之前请阅读
- 首先检测图表类型 —— 在编写 XML 之前,请参见 diagram-types/ 引用文件
- 应用通用盒模型样式标准 —— 请参见
references/box-style-standards.md - 所有位置均为硬编码 —— draw.io XML 中没有自动布局功能
- 每次导出后运行可视化审查循环 —— 请参见
references/visual-review-protocol.md - 没有进行可视化检查前,绝不要声明完成 —— 导出 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—— 使用
表示换行 - 在所有多行内容框上设置
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>