前言¶
写设计文档或评审材料时，架构图、拓扑图、流程图往往要反复改：先在脑子里对齐结构，再切到 Draw.io 或 Mermaid 编辑器里手调节点和连线。若希望对话里直接产出可继续编辑的图源，并把「画什么」和「怎么画」交给 Agent 按规范执行，就需要一套围绕图表工具链的 Skill，而不是每次从零口述排版细节。
下面介绍 SkillHub 上的 Diagram生成器（坐标 @u_8ee34d77/diagram-generator），它面向 Draw.io、Mermaid、Excalidraw 等格式的生成与编辑，并覆盖网络拓扑、系统架构、流程图、UML 等常见类型。
这是什么¶
Diagram生成器 是社区来源（community）的 Agent Skill，当前版本 1.1.7，由发布者 u_8ee34d77 维护，在 SkillHub 分类为 design-media。
一句话定位：通过工具在对话中生成与编辑 Draw.io / Mermaid / Excalidraw 图表，并支持自动化配置与较灵活的参数设置。官方说明中标注 requires_api_key=false，即不依赖额外 API Key 即可按 Skill 约定使用。
它主要解决的是：在需要效率、自动化、批量处理或工作流优化时，把「出图」纳入 Agent 能力，而不是每次单独打开外部编辑器从零搭画布。官方也明确写出：不适用于需要人工创意判断的任务；更适合独立开发者、企业团队以及自动化工作流场景。
核心功能¶
以下能力均来自 SkillHub 页面与抓取资料中的简介，未展开的实现细节以安装后的 SKILL.md 为准。
- 多格式图表：支持 Draw.io、Mermaid、Excalidraw 的生成与编辑。
- 图表类型：网络拓扑、系统架构、流程图、UML 等常见技术图示。
- 自动化与参数：支持自动化配置和灵活的参数设置，便于在不同应用场景下复用同一套出图流程。
- 使用边界（Use when）：在需要提升效率、自动化流程、批量处理、工作流优化时使用；避免用于强依赖主观创意判断的出图任务。
安装与启用¶
SkillHub 提供两种常见方式：让 AI 按官方安装文档操作，或在本机用 skillhub CLI 安装到当前 Agent 的 skills 目录。安装目录必须指向 Agent 实际读取的 skills 路径，否则技能不会被识别。
方式一：提示词安装¶
将下面意图发给已支持 Skill 安装的 AI（文案来自 SkillHub 技能页）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@u_8ee34d77/diagram-generator`。
AI 会按 SkillHub 安装与优先源配置 检查 CLI、选择 skills 目录并完成安装。
方式二：skillhub CLI¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时可按官方文档执行完整安装（需联网）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时务必带上 --dir，例如 Cursor 常用路径为 ~/.cursor/skills/：
skillhub install @u_8ee34d77/diagram-generator --dir ~/.cursor/skills/
其他客户端的 skills 目录以 官方安装文档 为准，例如 Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。各环境路径不同，核实不到本机布局时，优先用方式一让 Agent 按文档定位目录。
经过上面的步骤，重启或刷新 Agent 后，对话中即可在符合 Skill 触发条件时调用 Diagram生成器。
典型用法¶
公开资料未附带逐步截图示例，可复现的用法可归纳为：安装 Skill 后，在对话中用自然语言描述图表类型、要素与关系，并指明目标格式（Draw.io / Mermaid / Excalidraw）或图示种类（如架构图、拓扑、流程图、UML）。
示例意图（需根据你项目真实组件名替换占位内容）：
请用 Mermaid 画一张三层 Web 架构流程图：客户端、API 网关、业务服务、数据库，并标出主要请求方向。
根据下面模块列表生成 Draw.io 可编辑的网络拓扑草图，包含防火墙、负载均衡与两台应用节点。
把这段时序说明整理成 UML 风格的 Excalidraw 草图，便于评审会上修改。
Agent 会按 Skill 内定义的工具与参数规则出图或返回可导入对应编辑器的源码；具体工具名、导出字段以安装包中的 SKILL.md 为准。
适用场景与注意¶
适合
- 设计文档、RFC、运维手册中需要快速产出架构图、拓扑图、流程图或 UML。
- 同一类图要批量生成或随需求变更反复迭代，希望减少在多个编辑器间复制粘贴。
- 团队已在 Cursor、Claude Code 等环境使用 Skills，希望把出图纳入统一工作流。
注意
- 官方明确不适用于依赖人工创意判断的制图任务；版式、美学与信息层次仍需人审。
- 分类为 design-media，与「纯代码生成」类 Skill 侧重点不同，预期产出是图表资产而非业务逻辑代码。
- SkillHub 抓取数据显示：评分 100000，下载 77 次，安装计数 0（统计随平台更新变化，以技能页为准）。
- 简介中的「适支持」等为原文表述，不影响对格式与场景的理解，细节以 v1.1.7 包内说明为准。
结尾¶
Diagram生成器把 Draw.io、Mermaid、Excalidraw 上的生成与编辑能力收拢到 Agent Skill 里，适合在自动化与工作流场景下出技术图，同时划清了不适合强创意判断的边界。安装与详情见 SkillHub：
- 技能页：https://www.skillhub.cn/skills/u_8ee34d77/diagram-generator
- API 坐标页：https://api.skillhub.cn/u_8ee34d77/diagram-generator
