drawio-skill

drawio-skill 是一个开源 Agent Skills 包（MIT 许可），让 AI 编码代理——Claude Code、Cursor、Copilot、OpenClaw、Codex、Autohand Code、Hermes，或任何兼容 Agent Skills 的宿主——能够根据自然语言提示和真实系统来源生成、维护和再利用专业的 draw.io 图表。 核心生成流程：该技能规划布局，编写 .drawio XML，导出草稿 PNG，自检渲染效果并自动修复重叠、标签裁剪和边线堆叠（最多 2 轮），然后运行 5 轮用户反馈循环，最后导出。内置 11 种图表类型预设：ERD、UML Class、Sequence、C4、Architecture、ML/Deep Learning、Flowchart、SysML、BPMN、Network Topology 和 Cross-Functional Swimlane。Mermaid 文本（28 种标准类型，包括 mindmap、gantt、timeline、journey、pie、sankey、kanban）在 draw.io ≥ 30 上可转换为原生可编辑的 .drawio，而 raster2drawio.py 工具可将白板照片或旧版 PNG 重建为可编辑图表。 源到图表的导入器覆盖 Python、JS/TS、Go 和 Rust 导入图以及 Python 类层次结构；Terraform、Kubernetes 和 docker-compose 配置，带官方 AWS/Azure/GCP/K8s 图标；来自 `terraform show -json`、`docker inspect` 和 `kubectl get -o json` 的实时基础设施快照；SQL DDL 到 ERD；OpenAPI/Swagger 到按 HTTP 方法着色的 API 图；AsyncAPI 到事件驱动架构图；Protocol Buffers 到消息/服务图；GraphQL SDL 到实体类型图；以及 GitHub Actions / GitLab CI 到流水线 DAG。序列图使用计算的生命线和激活条；C4 模型为多页，支持点击下钻。 长期维护通过 Diagram IR 处理，它将含义、来源和几何分离，因此可以从一个模型投影出高管、系统、部署、数据流和安全视图。`diagramctl sync` 执行增量更新，保留手动调整的坐标、样式和注释，删除项保持可审查。YAML/JSON 中的 Diagram-as-Test 规则（互联网到数据库访问、循环、孤儿、信任边界、对比度）由官方 GitHub Action 在每个 PR 上强制执行，同时还有一个渲染视觉差异的 PR action。其他工具可查询组件、所有者和路径；发现关节点和高耦合；模拟故障传播；并发布可访问的 Story 走查。漂移以两个图表或两个实时快照之间的颜色编码差异可视化，时间流逝播放器可重放代码库架构在 git 历史中的演变。 分享和重新样式化是一键操作：带平移/缩放/搜索的交互式 HTML 查看器、PowerPoint 演示文稿、动画数据流 SVG、Mermaid 或 Markdown 导出、点击式 runbook 和高管摘要压缩。样式预设（default、corporate、handdrawn、色盲安全的 Okabe-Ito、dark）可以从用户自己的 .drawio 文件中学习；双语标签变体保留布局；数据驱动的热图根据 CSV/JSON 为节点着色；tube-map 模式将流水线重新样式化为伦敦地铁风格的地铁图。shapesearch.py 工具可在 10,000+ 官方 draw.io 形状（AWS、Azure、GCP、Cisco、Kubernetes、UML、BPMN、ER、电气、P&ID）中解析精确样式字符串，而 aiicons.py 可解析 321 个 AI/LLM 品牌徽标（OpenAI、Claude、Gemini、Mistral、Llama、Cohere、DeepSeek、Qwen、Ollama、LangChain、HuggingFace 等）以及 draw.io 本身缺少的 18 个数据存储品牌（Redis、Postgres、MongoDB、Qdrant、Milvus、Supabase）。 一切都由单个 `diagramctl` CLI（doctor/build/sync/views/query/test/review/whatif/story/publish/transform）驱动，核心工作流仅使用标准库且可离线运行；可选的 MCP 服务器将相同命令暴露给 Claude Desktop、Cursor、VS Code、Codex 和任何 MCP 宿主。布局使用 Graphviz（可选）进行放置、正交路由、传递归约和嵌套模块容器；确定性的 validate.py linter 提供 `--score` 和 `--strict` 门控用于 CI。安装需要 draw.io 桌面 CLI（建议 ≥ 30）和 `npx skills add Agents365-ai/drawio-skill -g`，或手动克隆到代理的 skills 目录。该项目是 Agents365-ai diagram-skill 系列的一部分，与 excalidraw-skill、mermaid-skill、plantuml-skill 和 tldraw-skill 并列，各自针对不同的图表风格。