用途：让 AI 智能体生成和运维可编辑的 draw.io 图表，而非扁平图片。核心入口为 scripts/diagramctl.py，统一处理生成、增量同步、多视图投影、语义查询/测试/评审、失败分析与无障碍发布，底层共享 Diagram IR。
主要能力：按需选择工作流，如自然语言精确绘图、Mermaid 转原生 .drawio（draw.io ≥30）、大型图自动布局（autolayout.py，15+ 节点）、从代码/Terraform/K8s/compose/SQL/OpenAPI/AsyncAPI/CI 源构建、从实际运行环境导入、保留手动画布的增量同步、执行/系统/部署/数据流/安全多视图、语义查询与 what-if 分析、CI 架构规则校验与 PR 视觉差异评论、导出 HTML/PPTX/Mermaid/Markdown 等。
必要用法：在技能目录下运行，例如 python3 scripts/diagramctl.py doctor；build model.json --from ir -o architecture.drawio；build ./infra --from terraform --group --ir-output architecture.ir.json -o architecture.drawio；sync architecture.drawio ./infra --from terraform -o architecture.next.drawio；views、test、review、query、whatif、story 等子命令。创建后运行 python3 scripts/validate.py diagram.drawio --score 做结构校验。导出草稿用 drawio -x -f png --width 2000 -o diagram.png diagram.drawio（不要加 -e），最终可编辑 PNG 用 -e -s 2 并配合 repair_png.py，SVG/PDF 用 -e 及 --embed-svg-images。
限制：doctor 不加 --probe 不启动 GUI；核心语义命令离线且仅用标准库。不得混用 --width 与 -s；草稿 PNG 不能嵌 XML。节点 ID 不得使用保留的 0 或 1，边必须含相对几何。自动视觉修复最多两轮。CLI 崩溃时按 troubleshooting 处理，不要反复启动。语义推断结果不得当作已验证的运行时事实。不要输出密钥；Story HTML 需自包含、可键盘操作并有文字替代。具体参考文档见 references 目录。