技能介绍

问题

在绘制网络拓扑、系统架构、流程图、泳道或 UML 类图时，直接手写 .drawio、.mmd、.excalidraw 文件容易踩到几个坑：节点 ID 不唯一、边被错误地放进子节点、容器层级不合法、坐标与方向不匹配。这个技能把用户意图先转换成一份可校验的 JSON 规格，再交给 mcp-diagram-generator MCP 服务落盘，降低不同图表格式之间的手工维护成本。

工作方式

收集必要参数：先确认图类型、输出格式、布局方向、使用场景，以及可选的文件名或目录；如果用户已经提供完整需求，则跳过多余提问。
按 playbook 分发：网络拓扑、系统架构、流程图、泳道、序列/类/ER、白板草图分别读取对应参考，只加载当前任务需要的规则。
构建 JSON 规格：核心要求包括 elements 必须是数组、ID 必须唯一、edges 必须是顶层元素、style 必须是对象、颜色尽量使用 #RRGGBB。
质量门与生成：调用生成工具前检查格式、方向、容器层级、文本与连接线规则；生成后检查目标文件是否具备预期格式属性。默认输出到 diagrams/{format}/，也支持自定义文件名和路径。

适用边界

依赖 mcp__mcp-diagram-generator__get_config、init_config、generate_diagram 等 MCP 工具；如果工具缺失，需要先配置 MCP 服务并重启 agent 环境。
适用于新建图表和编辑现有 .drawio、.mmd、.excalidraw 文件，不适合作为通用图像编辑器。
复杂 Draw.io 与 Excalidraw 图需要显式几何；子节点坐标相对直接父容器计算，容器尺寸必须容纳子节点边界并留出 padding。