drawio-skill
活跃简介
把自然语言、代码库、Terraform 或 SQL 转成可维护 .drawio 架构图的 Agent 技能,支持保留手工布局的增量同步、架构规则测试与内置 MCP 服务器。
核心特性
- 多源导入 — 13 种提取器覆盖 Python/JS/Go/Rust import 图、Terraform/K8s/docker-compose 资源图、SQL DDL、OpenAPI 与 CI 流水线
- 增量同步保留布局 — diagramctl sync 只更新变更节点与关系,手工调过的坐标、样式与标注原样保留
- 架构即测试 — 用 YAML/JSON 规则检查越层访问、循环依赖、孤儿节点等约束,并提供 CI 用的官方 GitHub Action
- 官方图形检索 — 搜索 10000 多个 draw.io 官方形状与 321 个 AI/LLM 品牌图标,避免渲染成空白方块
- 内置 MCP 服务器 — diagramctl_mcp.py 暴露九个工具,仅依赖标准库可离线运行,可接入 Claude Desktop、Cursor 等
- 自检与自动修复 — 读取导出 PNG 自动修正重叠、裁切与堆叠连线,最多两轮,另支持五轮迭代反馈
适用场景
💡 用一句自然语言生成微服务电商架构图,导出 PNG 或 SVG 用于评审汇报
💡 把现有 Terraform 或 Kubernetes 清单可视化成带官方云厂商图标的架构图,审计实际部署
💡 在 CI 里对每个 PR 强制执行架构契约测试,防止越层依赖与结构回归
💡 从代码库自动提取模块 import 图并自动排版,帮助新成员快速理解项目结构
优势与不足
✅ 优势
- • 活跃维护,近期持续更新
- • 社区热度高(9.2k stars)
- • 开源许可证友好(MIT)
- • Issue 响应及时,积压少
快速开始
# 安装 draw.io 桌面 CLI(macOS,建议版本 30 以上)
brew install --cask drawio
# 安装技能到任意 Agent
npx skills add Agents365-ai/365-skills -g
# 或手动克隆到技能目录
git clone https://github.com/Agents365-ai/drawio-skill.git ~/.claude/skills/drawio-skill