Agents365-ai/drawio-skill

解决的问题

drawio-skill 允许用户从自然语言、现有代码库或基础设施配置中生成专业且可编辑的图表。它通过自动化 .drawio XML 文件的布局和创建，消除了在 draw.io 中手动拖拽形状的繁琐工作，生成的文件可导出为多种图像格式。

工作原理

该项目作为 AI 代理（如 Claude Code 或 Cursor）的技能，与原生 draw.io 桌面 CLI 进行交互。它使用提取器和布局引擎的流水线，将输入转换为结构化图表：

• 自然语言： AI 代理将提示转换为图表规范。
• 代码/基础设施导入： 专用脚本可从 Python、JS-TS、Go、Rust、Terraform、Kubernetes 和 docker-compose 文件，或用于 ER 图的 SQL DDL 中提取结构。
• 布局引擎： 使用 Graphviz 进行节点定位和正交边路由，避免重叠和“毛球”现象。
• 优化： 工具包含自检机制，可读取自身生成的 PNG 输出，自动修复重叠和截断的标签。
• 转换： 支持将 Mermaid 文本转换为原生、可编辑的 .drawio 文件。

适用人群

• 软件架构师： 可用于可视化复杂的微服务、云基础设施和 C4 模型，并支持下钻查看。
• 开发者： 可从代码和数据库模式中自动生成类层次结构、导入图和 ER 图。
• DevOps 工程师： 可将基础设施即代码（IaC）文件转换为使用官方云图标架构图。
• C4 模型实践者： 可创建包含链接组件的多页系统文档。

主要亮点

• 广泛的图表支持： 提供 11 种预设，包括 ERD、UML、C4、SysML、BPMN 和网络拓扑。
• 代码转图表： 可从多种语言和 IaC 清单中自动提取项目结构。
• 云图标集成： 自动解析官方 AWS、Azure、GCP 和 Kubernetes 图标。
• AI/LLM 品牌图标： 包含 321 个标准 draw.io 中未提供的现代 AI 工具图标（如 OpenAI、Claude、LangChain 等）。
• 高级布局： 支持“地铁图模式”用于流程图，以及确定性序列图。
• 迭代式 AI 循环： 支持最多 5 轮针对性优化和视觉自修正。
• 多格式导出： 通过 draw.io CLI 导出为 PNG、SVG、PDF 和 JPG。