1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | drawio-skill |
| 作者/维护者 | Agents365-ai（团队/组织，持续维护同系列 plantuml-skill 等多个 Skill） |
| 来源链接 | https://github.com/Agents365-ai/drawio-skill |
| 许可证 | MIT |
| GitHub Stars | 5,852（GitHub API 实测） |
| Forks | 469（GitHub API 实测） |
| 最新版本 | v1.34.0 “Tube-Map Mode”（2026-07-14 发布） |
| 安装方式 | npx skills add 一键安装 / Claude Code 插件市场 /plugin install drawio / 手动克隆到 ~/.claude/skills/ |
2. 功能介绍与亮点
drawio-skill 让 Claude 用自然语言直接生成可编辑的 draw.io（.drawio XML）图表，并导出 PNG/SVG/PDF/JPG。核心亮点：
- 11 种图表预设：ERD、UML 类图/时序图、C4、架构图、SysML（BDD/IBD/需求/参数）、BPMN、网络拓扑、跨职能泳道图等
- 36 个配套工具：代码库转架构图（Python/JS/Go/Rust 导入关系与类层次）、IaC（Terraform/Kubernetes/docker-compose）转图并附官方云图标、SQL DDL 转 ER 图、图片转可编辑图、思维导图
- 10,000+ 官方图形库（AWS/Azure/Cisco/UML/BPMN）+ 321 个 AI/LLM 品牌 Logo
- 自校验自动修复：生成后读取导出的 PNG 检查重叠/裁切，最多 5 轮迭代直到用户确认
- 全程本地处理，无需 API Key
3. 适用场景
固定分类：数据分析与可视化。
适合需要产出专业级、可编辑架构图/流程图作为交付物的场景：系统设计评审用的架构图、数据库设计的 ER 图、API 交互的时序图、基础设施的网络拓扑图、业务流程的 BPMN 泳道图，以及把现有代码库/IaC 配置自动可视化用于文档沉淀。目标用户是需要向团队或客户交付“能改、能审”的正式图表、而不满足于 Mermaid 简易语法的初中级开发者与技术文档撰写者。
4. 跨 Agent 兼容性
- Claude Code：原生支持——文档与安装路径均围绕 Claude Code 插件市场与
~/.claude/skills/设计，是明确的第一目标平台 - Codex：原生支持——仓库文档明确将 Codex 列入官方支持的 Agent 平台清单
- OpenClaw：原生支持——同上，官方支持清单中明确包含
- Hermes Agent：未验证——直接抓取到的仓库 README 只明确列出 Claude Code / Cursor / GitHub Copilot / OpenClaw / Codex / Autohand Code 六个平台，未见 Hermes Agent 出现在该清单中；另有聚合来源提到“兼容 Agent Skills 标准”的表述，但未找到面向 Hermes Agent 的直接证据，故不作原生支持认定
5. 推荐理由
一句话：用自然语言生成可编辑、专业级的 draw.io 架构图，覆盖 Claude Code/Codex/OpenClaw 等多生态，且有独立第三方评测将其列为同类最佳。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 5,852 star；独立第三方对比评测（Medium 文章《Top 4 Claude Code & Cursor Skills for Architecture Diagrams》）将其列为 AWS 架构图/系统设计场景首选；另被 claudemarketplaces.com、skillsmp.com、agentskill.work、crossaitools.com 等至少 4 个独立技能目录收录 |
| 可用性 | 8 | npx 一键安装与 Claude Code 插件市场双通道；SKILL.md + 中英双语 README + 独立文档站（agents365-ai.github.io/drawio-skill）文档完整；v1.34.0 于 2026-07-14 发布，维护节奏非常活跃；但需额外安装本地 draw.io 桌面 CLI（自动布局还需可选 Graphviz） |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.3 | ≥ 7.0 达标，安全性未触发一票否决 |
安全检查清单：
① Shell 执行——本地调用 draw.io 桌面 CLI 与可选 Graphviz 子进程完成渲染和自动布局，范围限于本地绘图工具，非任意代码执行
② 联网外发——默认仅在生成 AI/LLM 品牌 Logo 时访问 unpkg CDN 取图标，可用 --embed 参数改为完全离线嵌入，未见其他外联
③ API Key/凭据——不需要，全流程本地处理
④ 可疑指令——核对 README 与 SKILL.md 描述，未发现越权操作、隐藏指令或 prompt injection 迹象
⑤ 作者信誉——Agents365-ai 持续维护多个同系列 Skill（如 plantuml-skill），有独立文档站与双语文档，但非官方/一线机构，透明度中等
⑥ License——MIT，清晰
⑦ 维护时间——最近 release 为 2026-07-14，维护活跃，无弃置风险
7. 跟同类 Skills 相比的优势
| Skill | Star | 定位 | 与本 Skill 的差异 |
|---|---|---|---|
| drawio-skill（本次推荐） | 5,852 | 自然语言 → 可编辑 draw.io 图表，36 工具覆盖代码/IaC/SQL 转图 | 生态覆盖最广（含 Codex/OpenClaw），有独立第三方评测佐证 |
| Cocoon-AI/architecture-diagram-generator | 6,500 | 生成深色主题的独立 HTML/SVG 架构图 | Star 数更高，但官方文档仅明确支持 Claude.ai/Claude Code，不支持 Codex/OpenClaw/Hermes；未见独立第三方评测 |
| coleam00/excalidraw-diagram-skill | 4,114 | Excalidraw 风格快速流程图/白板图 | 适合头脑风暴等轻量场景，但自 2026-03 发布后再无更新，且未见 License 文件 |
| axtonliu/axton-obsidian-visual-skills | 3,208 | Obsidian 笔记内 Canvas/Excalidraw/Mermaid 图表生成 | 定位窄，强依赖 Obsidian 客户端，通用性不及 drawio-skill |
| yctimlin/mcp_excalidraw | 2,169 | 基于 MCP Server 的 Excalidraw 画布操作 | 需额外部署 MCP Server，安装门槛更高 |
drawio-skill 在图表类型覆盖度、生态兼容广度与第三方认可度上综合领先，是目前“自然语言生成专业架构图”路线里关注度最高的实现。
8. 用户评价
- Soumil Shah（Medium，《Top 4 Claude Code & Cursor Skills for Architecture Diagrams, AWS Designs, and Flowcharts》，2026-06）：将 drawio-skill 列为四款对比 Skill 之一，评价其“生成可编辑的 Draw.io 图表”并带 AWS 图标支持，推荐用于生产级架构图、系统设计与基础设施文档场景。
该技能公开可见的具名独立评价目前仅此 1 条，其他第三方平台尚无更多具名评价。
9. 其他补充
仓库提供英文与中文（README_CN.md）双语文档，并维护独立文档站点。
10. 安装使用方式
- 一键安装：
npx -y skills add agents365-ai/drawio-skill --skill drawio-skill --agent claude-code（--agent可替换为对应平台参数） - Claude Code 插件市场：
/plugin install drawio - 手动安装：克隆仓库到
~/.claude/skills/drawio-skill - 前置依赖：需先安装 draw.io 桌面版（建议 v30+ 以支持 Mermaid 转换）；自动布局功能需额外安装 Graphviz（可选）
- 安装后无需重启，后续对话中提及“画架构图/画 UML/画流程图”等意图会被自动触发调用
11. 注意事项
- 依赖本地 draw.io 桌面 CLI，在沙箱化的 macOS 环境中运行该 CLI 可能崩溃，需要有完整 shell 访问权限的环境
- Graphviz 为可选依赖，仅在需要自动布局时安装，否则可手动布局
- Hermes Agent 的兼容性缺乏公开证据，如需在该平台使用建议先小范围验证
- 生成 AI/LLM 品牌 Logo 默认从 unpkg CDN 获取，网络隔离环境建议使用
--embed参数离线嵌入