drawio-skill 是给 AI coding agent 使用的 diagrams.net/draw.io 技能包。它能从自然语言、代码、Terraform、Kubernetes、SQL 和 API schema 生成可编辑 .drawio，并提供同步、验证、查询、差异、多个视图和离线 HTML 发布。核心脚本可只用 Python 3；原生 PNG/SVG/PDF 导出仍需要 draw.io 桌面 CLI。
来源：github.com/Agents365-ai/drawio-skill；https://github.com/Agents365-ai/… 查看 GitHub 仓库 → 📘 使用教程 →项目在 2026-09 将简单画图技能扩展为带版本化 Diagram IR、增量同步、架构规则、MCP 和可访问 Story 输出的工具链；当前 SKILL.md 标记 3.4.0，仓库约 9.6k stars。
来源：github.com/Agents365-ai/drawio-skill/blob/main/CHANGELOG.md；https://g…diagramctl 可从多种源码生成带稳定语义 ID、provenance 与属性的 IR，再输出 draw.io；同步时尽量保留人工布局与样式。
来源：github.com/Agents365-ai/drawio-skill/blob/main/CHANGELOG.md；https://g…可执行路径查询、循环与耦合检查、失败传播、架构规则和 PR 差异；这些结论来自静态模型，不等于运行时观测。
来源：github.com/Agents365-ai/drawio-skill/blob/main/skills/drawio-skill/SK…支持 Python/JS/Go/Rust、Terraform、K8s、Compose、SQL、OpenAPI、AsyncAPI、Protobuf、GraphQL 与 CI；可转 PNG、SVG、PDF、PPTX、Mermaid、Markdown、动画和离线 HTML。
来源：github.com/Agents365-ai/drawio-skill/blob/main/README.md；https://gith…可安装进 Codex、Claude Code、Cursor、Copilot 等兼容环境；MCP stdio server 将 doctor、build、sync、views、test、review 等工作流暴露为本地工具，不需要后台网络服务。
来源：github.com/Agents365-ai/drawio-skill/blob/main/docs/INSTALL_SKILL.md；…SKILL.md 负责把请求路由到 diagramctl.py 或聚焦脚本；importer 将源码提取为版本化 Diagram IR，layout 与 XML writer 生成 draw.io 页面，validate/test/review/query 在同一语义模型上检查。sync 通过稳定 ID 对齐旧图与新来源，默认把删除项留成待审元素。导出阶段才调用 draw.io Electron CLI，Graphviz 只在部分自动布局或压缩流程中需要；MCP 模式是 stdio wrapper，内部仍调用 diagramctl。
来源：github.com/Agents365-ai/drawio-skill/blob/main/skills/drawio-skill/SK…核心 IR、同步、查询、测试、review 与 Story 只要求 Py…原生图片/PDF 导出需要 draw.io desktop CLI；Me…Graphviz、PyYAML、python-pptx、Pillow 等…适合需要可编辑架构图、从代码或 IaC 生成图、在 PR 中看结构变化、用架构规则做 CI gate，或从同一模型生成执行层/部署/安全视图的团队。只需要 README 中自动渲染的简单 diagrams-as-code 时，Mermaid 更直接；自由手绘白板则更适合 Excalidraw 或 tldraw。
来源：github.com/Agents365-ai/drawio-skill/blob/main/README.md；https://gith…main 分支 SKILL.md 当前版本是 3.4.0；CHANGELOG 显示 3.0/3.1 在 2026-09-01 引入 Diagram IR、同步、架构检查与 MCP，之后继续更新语义保真。GitHub Releases 页面最新可见正式包仍为 v1.28.2，因此应固定 commit，不要只依赖 release 标签。
来源：github.com/Agents365-ai/drawio-skill/blob/main/skills/drawio-skill/SK…status: docs_and_source_checked_not_executed | checked_at: 2026-09-23 | environment: 核对官方 README、SKILL.md、安装文档、CHANGELOG、LICENSE、GitHub releases 和官方 jgraph/drawio-mcp 仓库；未安装 skill、draw.io、Graphviz 或 MCP server。 | limitations: 没有执行 doctor、importer、sync、layout、validation、MCP、draw.io 导出、PR Action 或 visual QA；也没有验证 9.6k star 数以外的使用量。 | observed_output: 当前 SKILL.md 元数据为 3.4.0，核心语义流程要求 Python 3，原生导出需 draw.io，Graphviz 可选。GitHub Releases 页面最新可见包为 v1.28.2，晚于它的 3.x 变化记录在 main CHANGELOG。
来源：github.com/Agents365-ai/drawio-skill/blob/main/skills/drawio-skill/SK…相比 diagrams.net 官方 jgraph/drawio-mcp，drawio-skill 把代码/IaC/SQL/API importer、Diagram IR、增量同步、架构规则、diff 和多种发布工具放在一个技能仓库中；官方 drawio-mcp 的优势是由 diagrams.net 项目直接维护，并提供 MCP server 与官方 Claude Code plugin。已经依赖官方插件且只需生成/编辑图时先用官方方案；需要来源追踪、同步和 CI 架构检查时再评估 drawio-skill。
来源：github.com/Agents365-ai/drawio-skill/blob/main/docs/COMPARISON.md；htt…drawio-skill 可保留。它的自愿赞助链接没有形成付费功能门槛，仓库关注度高，但本站暂无搜索记录。使用时应按可执行代理插件管理：项目级安装、固定 commit、先读 SKILL.md、限制扫描路径；先交付 .drawio 和校验报告，再在 draw.io CLI 可用时导出图片。
来源：github.com/Agents365-ai/drawio-skill；https://github.com/Agents365-ai/…核心 IR、同步、查询、规则检查和 Story 流程只需要 Python 3；要原生导出 PNG、SVG 或 PDF 时才需要 draw.io CLI。部分自动布局还会用到可选 Graphviz。
技能具备 Bash 和文件读写能力，只有代理调用相应 importer 或命令时才会读取路径。建议装在项目级 skills 目录，先审阅 SKILL.md，并把扫描范围限制到明确目录。
官方设计用稳定语义 ID 对齐元素，更新关系和标签时保留匹配单元的几何与样式；移除项默认留下供审阅，只有显式 prune 才删除。仍应输出到新文件并先看 diff。
Releases 页面最新可见包是 v1.28.2，但 main 分支的 SKILL.md 已标 3.4.0，CHANGELOG 也记录 3.x 功能。复现时固定 commit，并以该 commit 内的 SKILL.md 和 CHANGELOG 为准。
需要在 Markdown 中自动渲染、文本 diff 清楚的简单图时选 Mermaid；需要精确样式、官方云图标、可编辑布局、源代码同步或多格式交付时选 drawio-skill。