drawio-skill (draw.io 图表)
从自然语言生成专业级 draw.io 图表：11 种图型预设（UML/SysML/BPMN/ERD/C4/泳道等），通过本地 draw.io CLI 导出可编辑的 PNG/SVG/PDF/JPG，并附带 31 个脚本覆盖代码库/IaC/SQL 自动可视化和图表全生命周期再加工。
仓库：Agents365-ai/drawio-skill
热度证据：7,542 star,图表类技能的代表仓库
五维评分
热度5/5
质量5/5
创新4/5
易用4/5
文档5/5
优秀点拆解
- 按需加载设计：SKILL.md 用 Bundled resources 表把 13 个 reference 和 31 个脚本做成「何时读」路由，控制上下文占用，SKILL.md 本体保持精炼
- 三层质量闭环：validate.py 确定性结构 lint → 视觉自检（读 PNG 查 7 类问题并自动修复，最多 2 轮）→ 用户评审循环（5 轮最小 XML 编辑），展示前拦截结构错误与视觉错误
- 真实踩坑固化成规则和脚本：repair_png.py 修 draw.io -e 导出 PNG 的 IEND 截断 bug、--width 2000 规避 vision API 2576px 上限、--layout 非法值挂死 headless 等，全部写进常见错误章节
- 图表全生命周期而非一次性生成：explain 图转文字、raster2drawio 照片反栅格化、relabel 换文案、restyle 换主题、drawiodiff 漂移对比、timelapse 架构演进、drawio2pptx 转幻灯片、prdiff CI 自动 PR 图审查
- 中英双语教科书级文档：448 行 README + 完整中文版 + docs 站点 + 14 个专项 references + CHANGELOG + 单元测试与 CI
可复用的设计模式
- 「用户说什么 → 读哪个 reference」的措辞路由表（diagram-types 的用户短语映射、toolbox 的 I-have-X-want-Y → use-Z 索引）
- 统一 CLI 约定的小工具族：JSON schema 输入、-o 输出、stdin 支持、同款 flag，可组合成 importer → autolayout → validate → 导出 的 pipeline
- 分层验证金字塔：确定性 lint（免费）→ 模型视觉自检（免费）→ 人工评审（贵），逐层拦截错误
- 配置外置 + 覆盖链：用户预设存 ~/.drawio-skill/styles/（git pull 不冲突），built-in 存技能目录，带槽位回退阶梯
适用场景
从一段自然语言描述生成架构图/微服务图/ML 模型图等正式图表并导出 PNG/SVG/PDF把现有代码库（Python/JS/Go/Rust）、Terraform/K8s/docker-compose、实际运行态（terraform show/docker inspect/kubectl）自动可视化为架构图SQL DDL 转 ER 图、OpenAPI 转 API 图、CI 配置转流水线图对已有 .drawio 做换主题、批量改文案（如中英对照）、数据热力着色、版本漂移对比、git 历史架构演进动画图表再交付：转 Mermaid、转 PPT、单文件交互式 HTML 查看器、流程图变点击式排障 runbook
边界与注意：强依赖 draw.io 桌面 CLI（macOS 沙箱隔离环境下 CLI 崩溃，只能走浏览器回退或纯 XML 交付）；手绘风/白板风及 markdown 内嵌渲染场景应改用 excalidraw/mermaid；自动布局是拓扑最优而非语义最优；代码/IaC 导入为静态解析，dynamic import 与复杂 HCL 解析有限
完整拆解分析文档
本页为摘要版，完整精读分析（核心机制、逐条优秀点拆解、写作过程）见本地 Markdown 文档：
analysis/community-drawio-skill.md