1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | drawio-ai-kit |
| 作者/维护者 | sparklabx（多贡献者协作维护） |
| 来源链接 | https://github.com/sparklabx/drawio-ai-kit |
| 许可证 | MIT（GitHub API） |
| GitHub Stars | 605（GitHub API） |
| Forks | 104（GitHub API） |
| 最新版本 | v1.0.1（package.json / 发布提交） |
| 安装方式 | npm 全局安装 + skills CLI 添加技能 |
2. 功能介绍与亮点
drawio-ai-kit 是一套面向 AI 编程助手的 Skill 套件，教会 Agent 把自然语言描述的系统架构画成正确、美观的 draw.io 图，覆盖 AWS、Azure、GCP、Databricks、BPMN 五个专用领域。
核心能力：把 draw.io 官方图形 ID 映射为声明式图标目录，避免 AI 编造不存在的图形导致空白方块；生成后用结构校验器核对图形引用、配色、坐标；还可导出图片让 Agent 自行“看一眼”渲染结果并纠错，形成生成—校验—修正闭环。CLI 零运行时依赖。
亮点：仓库自带 CI 密钥扫描（gitleaks）与代码安全扫描（Semgrep），开发过程留有架构决策记录（ADR）；近日仍有代码推送，维护节奏稳定。
3. 适用场景
所属分类：数据分析与可视化
适合需要为软件系统绘制标准化云架构图（AWS / Azure / GCP）或业务流程图（BPMN）的开发者、架构师、技术文档撰写者。尤其适合不熟悉 draw.io 手工排版的用户——用自然语言描述系统组成，即可得到可在 draw.io 中直接编辑的标准架构图。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | SKILL.md 为标准格式，npx skills add 可直接写入其技能目录 |
| Codex | 原生支持 | 安装文档写明 skills CLI 会自动识别 Codex 并写入对应技能目录 |
| OpenClaw | 未验证 | 已获取材料未提及 |
| Hermes Agent | 未验证 | 已获取材料未提及 |
5. 推荐理由
多数“AI 画图”类技能止步于“能画”，drawio-ai-kit 把重点放在“画对”：图标目录、结构校验、渲染自检三层机制专门针对 AI 生成图表常见的翻车点（编造图形、空白方块、布局错乱）做了工程化处理，且按云平台各自独立打包，可按需只装用得到的领域。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 605 Stars、104 Forks，仓库创建约 5 周内积累到这一数量，增长速度较快；尚未检索到多平台的独立讨论 |
| 可用性 | 8 | npm 全局安装加一条 skills CLI 命令即可完成配置，文档（README/INSTALL/ADR）齐全含示例，近日仍有推送，零运行时依赖；比单文件拖拽式技能略多一步 |
| 安全性 | 8 | 代码执行范围明确于本地生成与校验图表文件，无遥测外发，不需要凭据，License 清晰，团队自建 CI 安全扫描 |
安全检查清单：①shell 命令范围限于本机生成/校验图表文件，无越权；②本地运行、无遥测外发；③不需要凭据；④未见可疑指令或注入迹象；⑤多贡献者协作，提交记录规范，未见刷星或 SEO 操纵痕迹；⑥MIT License 明确；⑦近日仍有推送，非弃置项目。
综合评分 7.3（三项均值）。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位与差异 |
|---|---|
| architecture-diagram-generator（Cocoon-AI） | 直接上传到 claude.ai 网页端使用，输出单个可分享的 HTML 文件；面向通用架构图，不区分云平台图标库，也没有独立结构校验 |
| excalidraw-diagram-skill（coleam00） | 生成 Excalidraw 手绘风格图，更适合演示、白板场景；仓库未附带开源许可证声明 |
| axton-obsidian-visual-skills（axtonliu） | 面向 Obsidian 笔记生态，产出 Canvas / Excalidraw / Mermaid 多种格式，覆盖面更广，但需要用户已安装并使用 Obsidian |
| drawio-skill（Agents365-ai） | 同为 draw.io 方向，通过桌面版 CLI 本地导出 PNG/SVG/PDF，收录万余官方图形素材，素材库更庞大通用，但没有分平台的领域建模与渲染自检闭环 |
drawio-ai-kit 的差异化在于按云平台拆成独立领域技能，并用图标目录、结构校验、渲染自检三层机制保证生成结果合法可用。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；GitHub Issue 区当前主要是维护团队自身的开发任务记录，尚未见到外部用户的使用反馈。
9. 其他补充
npx skills add sparklabx/drawio-ai-kit --list 可先预览全部 5 个领域技能再按需选装，不必一次性全装。
10. 安装使用方式
# 1. 全局安装 CLI（不发布于 npm registry，直接从 GitHub 安装）
npm i -g github:sparklabx/drawio-ai-kit
# 2. 添加技能（可选装单个领域，或一次装全部 5 个）
npx skills add sparklabx/drawio-ai-kit --skill drawio-aws
npx skills add sparklabx/drawio-ai-kit安装后需重启 Agent 以加载新技能；可用 drawio-ai --help 验证安装是否成功。
11. 注意事项
- CLI 本体未发布到 npm registry，只能通过
npm i -g github:owner/repo从 GitHub 直接安装，无法用常规包名搜索到。 - 导出 PNG/SVG 依赖本机安装的 draw.io 桌面应用（可选），未安装时仍可生成
.drawio源文件；大规模图（约 15 节点以上）的自动布局依赖可选安装的 Graphviz。 - 仓库创建约 5 周，社区规模尚小，尚无广泛的第三方独立评价。