Repolode
Agents365-ai

Agents365-ai/drawio-skill

一个智能体技能,可将自然语言及 Terraform、K8s、SQL、OpenAPI 等源码转换为可编辑的 draw.io 架构图。

可替代:Lucidchart

Star
10,234
Fork
870
未关闭 Issue
0
最近提交
9天前

这是什么?

drawio-skill 是一个遵循 Agent Skills 格式的技能包,可根据自然语言描述、代码、基础设施配置和数据结构定义生成可维护的 .drawio 架构模型。支持 Terraform、Kubernetes、docker-compose(使用官方云厂商图标),也能把 SQL DDL 转为 ER 图,并将 OpenAPI、AsyncAPI、Protobuf、GraphQL 以及 CI 流水线转换为对应图表。

除一次性生成外,该项目重点在于让图表与系统保持同步。增量同步会更新变化的节点,同时保留手动调整过的布局;漂移对比可比较两份图表或两次快照;基于 YAML/JSON 的架构规则可在 CI 中作为测试运行。图表可导出为交互式 HTML、PPTX、动画 SVG、Mermaid 或 Markdown。核心流程仅依赖 Python 标准库,主要外部依赖是 draw.io 桌面版 CLI。

核心功能

  • 01根据自然语言生成可编辑的 .drawio 文件,并自动检查渲染结果
  • 02支持导入 Terraform、Kubernetes、docker-compose、SQL、OpenAPI、AsyncAPI、Protobuf、GraphQL 等来源
  • 03增量同步图表,保留手动调整的布局和标注
  • 04以 CI 测试形式运行架构规则,并比较图表之间的差异
  • 05可导出为交互式 HTML、PPTX、动画 SVG、Mermaid 和 Markdown
  • 06检索超过 10,000 个 draw.io 官方图形及 321 个 AI/LLM 品牌图标

适用场景

  • 依据 Terraform 或 Kubernetes 配置生成带官方云厂商图标的基础设施文档
  • 在 PR 中通过架构规则拦截公网直连数据库等不合规设计
  • 对比已部署系统与设计文档之间的漂移
  • 基于现有代码生成面向干系人的演示文稿或交互式架构讲解页

快速上手

  1. 1

    安装 draw.io 桌面版命令行工具(macOS)

    brew install --cask drawio
  2. 2

    为任意智能体安装该技能

    npx skills add Agents365-ai/drawio-skill -g
  3. 3

    验证命令行工具安装是否成功

    drawio --version

使用前须知

  • 完整功能需要 draw.io 桌面版命令行工具,建议版本 30 或更高以支持 Mermaid 转换和 ELK 布局。
  • Windows 和 Linux 上的命令行配置较为繁琐,WSL2 需要调用 Windows 桌面版可执行文件。

标签

常见问题

drawio-skill 是什么?
一个智能体技能,可将自然语言及 Terraform、K8s、SQL、OpenAPI 等源码转换为可编辑的 draw.io 架构图。 drawio-skill 是一个遵循 Agent Skills 格式的技能包,可根据自然语言描述、代码、基础设施配置和数据结构定义生成可维护的 .drawio 架构模型。支持 Terraform、Kubernetes、docker-compose(使用官方云厂商图标),也能把 SQL DDL 转为 ER 图,并将 OpenAPI、AsyncAPI、Protobuf、GraphQL 以及 CI 流水线转换为对应图表。
drawio-skill 可以免费使用吗?用的什么许可证?
drawio-skill 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
drawio-skill 还在维护吗?
活跃维护中。drawio-skill 最近一次提交是在 2026年10月11日。
drawio-skill 适合用来做什么?
依据 Terraform 或 Kubernetes 配置生成带官方云厂商图标的基础设施文档 在 PR 中通过架构规则拦截公网直连数据库等不合规设计 对比已部署系统与设计文档之间的漂移 基于现有代码生成面向干系人的演示文稿或交互式架构讲解页
drawio-skill 怎么安装和运行?
安装 draw.io 桌面版命令行工具(macOS): brew install --cask drawio 为任意智能体安装该技能: npx skills add Agents365-ai/drawio-skill -g 验证命令行工具安装是否成功: drawio --version
在哪里获取 drawio-skill?
源代码和安装说明在 GitHub 上:https://github.com/Agents365-ai/drawio-skill

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目