前言¶
写设计文档或评审材料时,ERD、类图、时序图、流程图、架构图往往要单独开 draw.io(diagrams.net)手摆,再导出 PNG 贴进 Markdown 或 PPT。对话式 Agent 能写文字说明,却未必能稳定给出可编辑的 .drawio 源文件和可直接使用的位图。若希望用自然语言描述结构,由 Agent 按 Skill 规范生成专业图示并导出 PNG,可以安装 SkillHub 上的社区 Skill drawio生成(@user_41c94e21/guoxueting000)。
这是什么¶
drawio生成 是面向 design-media 分类的 Agent Skill,版本 1.0.0,来源为 community,由发布者 user_41c94e21 维护。官方页面将其定位为:生成专业的 draw.io 图示,并导出为 PNG;当用户需要各类图表、数据库模型、类结构、流程或系统可视化时使用。
Skill 标注 requires_api_key=false,不依赖额外 API Key。在 SkillHub 上评分 100000,截至页面资料下载 621 次、安装 22 次(数据以 SkillHub 展示为准,会随时间变化)。
核心功能¶
根据官方简介,已核实的能力包括:
- 图示类型:ERD / 数据库表结构、类图、时序图、流程图、架构图等 draw.io 常见类型。
- 输出形式:生成 draw.io 兼容的专业图示,并 导出为 PNG,便于插入文档或演示材料。
- 触发场景:用户提出任意图示、数据库模型、类结构、流程或系统可视化相关需求时,Agent 应加载该 Skill 并按其指引执行。
具体生成步骤、文件命名与导出方式以 Skill 包内 SKILL.md 为准;本文不展开未在公开资料中出现的脚本或配置项。
安装与启用¶
SkillHub 推荐通过 CLI 安装,并必须把技能装进当前 Agent 能识别的 skills 目录。
1. 检查或安装 SkillHub CLI¶
先确认本机是否已有 skillhub:
command -v skillhub && skillhub --version
若未安装,可按 SkillHub 安装文档执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装说明全文见:https://skillhub.cn/install/skillhub.md
2. 安装 drawio生成¶
官方 Skill 页给出的安装提示为:根据上述安装文档,安装坐标 @user_41c94e21/guoxueting000。
在终端中示例(--dir 须换成你当前 Agent 的 skills 目录,否则默认可能落到 ./skills/ 而未被识别):
skillhub install @user_41c94e21/guoxueting000 --dir <你的 Agent skills 目录>
常见客户端 skills 路径(摘自 SkillHub 安装文档,以你本机实际为准):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可将 SkillHub 页面上的安装提示复制给 AI,让其按 https://skillhub.cn/install/skillhub.md 完成安装。
安装后按你所用客户端要求重启或刷新 Agent,使新 Skill 生效。
典型用法¶
公开资料未附带逐步截图示例,用法以 Skill 简介中的 Use when 条件为准:在对话中说明你要的图类型与内容即可,例如数据库表关系、类之间的继承与关联、服务调用的时序、业务审批流程、系统分层架构等。
建议在一次请求里写清:
- 图类型(ERD、类图、时序图、流程图、架构图等)。
- 实体、表、类名、步骤或组件名称及关系。
- 是否需要导出 PNG,以及期望的文件名或存放位置(若 Skill 内对输出路径有约定,Agent 会按 SKILL.md 处理)。
Agent 加载 drawio生成 后,应生成 draw.io 图示并完成 PNG 导出;若结果不符合预期,可补充字段、连线或布局要求后让 Agent 修订。
适用场景与注意¶
适合谁:需要在文档、评审或沟通中快速产出标准技术图、又不想每次手动拖拽 draw.io 的开发者与架构写作者;已在使用 Cursor、Claude Code、Codex 等支持 Skills 的客户端的团队。
注意:
- 社区来源(community),使用前可在 SkillHub 页面查看版本与说明,重大生产文档建议人工核对图与真实系统是否一致。
- 不依赖 API Key,但本机仍需能运行 Agent 及 Skill 所要求的工具链(以 SKILL.md 为准)。
- 安装务必指定正确的
--dir,并与客户端文档中的 skills 路径一致。 - 评分与下载量为平台统计,仅作选型参考,不代表图示质量在所有场景下一致。
结尾¶
drawio生成 把「描述结构 → draw.io 源图 → PNG」收进 Agent Skill 工作流,覆盖 ERD、类图、时序、流程与架构等常见图示,且无需配置 API Key。需要安装或查看更新时,可打开 SkillHub 官方页:
- https://www.skillhub.cn/skills/user_41c94e21/guoxueting000
- https://api.skillhub.cn/user_41c94e21/guoxueting000