前言¶

技术文档、投标材料、运维手册里经常要交架构图、系统图或网络拓扑。不少团队仍以 Microsoft Visio 为交付格式，或要求图能在 Visio 里二次编辑。手写矢量、在 draw.io 与 Visio 之间来回导出，常遇到布局乱、连线标注丢失、文件打不开等问题。下面介绍 SkillHub 上的 WorkBuddy Visio — Visio 兼容架构图生成器（坐标 @user_6c3897e4/workbuddy-visio）：在 Agent 对话中按需求生成 draw.io（.drawio） 与 SVG，面向 Visio 兼容与文档插图场景。

这是什么¶

WorkBuddy Visio 是社区来源（community）的 Agent Skill，分类为 dev-programming，当前版本 1.1.0，发布者为 user_6c3897e4。官方简介说明其能力：使用 draw.io 与 SVG 生成 Visio 兼容的架构图；标签标明 requires_api_key=false，安装后一般无需额外 API Key 即可按 Skill 指引工作。

Skill 在 SkillHub 的页面为 WorkBuddy Visio — Visio 兼容架构图生成器；元数据接口为 https://api.skillhub.cn/user_6c3897e4/workbuddy-visio（页面展示评分 100000，下载 1572 次，安装计数为 0——以 SkillHub 页面实时数据为准）。

核心功能¶

以下能力均来自官方简介，未在资料中出现的细节不展开：

1. 架构 / 系统 / 网络类图示
   面向 Visio 或技术文档所需的架构图、系统图、网络图。

2. 分层控制系统图与连线标注
   支持带连接关系说明的分层、控制系统类示意图。

3. draw.io XML 转稳定 SVG
   将 draw.io 侧 XML 转为相对稳定的 SVG，便于嵌入文档或再处理。

4. 疑难文件排查
   当 Visio 或 draw.io 无法打开某图时，可作为排查与修复方向的触发场景。

5. 可编辑文本的专业布局
   强调专业排版，并保留可编辑文本，而非纯位图插图。

官方给出的触发场景（用户提出下列需求时可启用该 Skill）包括：Visio 或技术文档用图；分层控制系统图与连接标注；draw.io XML 转 SVG；打不开图的排障；需要专业布局且文字可编辑的任意图示。

安装与启用¶

SkillHub 推荐通过其 CLI 安装，并必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。

1、安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行完整安装（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

2、安装本 Skill¶

按 SkillHub 安装说明，将技能装到当前环境的 skills 目录。坐标为 @user_6c3897e4/workbuddy-visio。

skillhub install user_6c3897e4/workbuddy-visio --dir <skills 目录>

常见路径（以安装文档为准，按你实际使用的客户端选择）：

• workbuddy：~/.workbuddy/skills/
• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可向 AI 发送 SkillHub 页面提供的安装提示词：「请根据 https://skillhub.cn/install/skillhub.md，安装 @user_6c3897e4/workbuddy-visio。」

安装完成后，按你所用客户端的要求重启或刷新 Agent，使 Skill 被加载。

典型用法¶

资料中未附带逐步复制的命令行示例；用法遵循通用 SKILL.md 模式：Skill 安装并启用后，在对话中用自然语言描述图示需求，Agent 按 Skill 内规则生成 .drawio 与 SVG 等产物。

可与官方触发说明对齐的表述示例（意图需你根据真实系统改写，勿当作固定模板）：

1. 「为三层 Web 应用画架构图，要 Visio 能打开的 draw.io 源文件，并导出 SVG 放进设计文档。」
2. 「画带 PLC / 上位机分层的控制系统图，连线上标注信号名。」
3. 「这份 draw.io XML 转一版布局稳定的 SVG。」
4. 「Visio 打不开这个图，帮我按 Skill 流程排查并给出可编辑文本的版本。」

经过上面的步骤，输出文件格式与是否可直接用 Visio 打开，取决于生成内容与本地 Visio / draw.io 版本；Skill 侧目标是 Visio 兼容与 可编辑文本，具体兼容性需在本地验证。

适用场景与注意¶

适合谁

• 需要在 Agent 辅助下快速出图，且交付物倾向 draw.io / SVG / Visio 工作流 的开发者、架构师、技术写作者。
• 文档体系仍依赖 Visio 或要求矢量、可改字的插图，而不是截图。

注意

• 评分、下载量等以 SkillHub 技能页 为准；与第三方转载数据不一致时以官方页面为准。
• 无需 API Key 仅表示 Skill 标签配置；你本地是否还有 draw.io、Visio 等工具仍自行准备。
• 复杂图的版式与标准符合度依赖对话描述是否清晰；生成后建议在目标工具中打开检查连线、字体与图层。

结尾¶

WorkBuddy Visio 把「Visio 兼容架构图 + draw.io / SVG」收敛成一条可安装的 Agent Skill：在 dev-programming 分类下，用明确触发场景覆盖架构图、分层控制图、格式转换与排障等需求。若你正在 SkillHub 或 workbuddy / Cursor 等环境扩展图示能力，可从官方页安装 v1.1.0 的 @user_6c3897e4/workbuddy-visio 试用。

• SkillHub 页面：https://www.skillhub.cn/skills/user_6c3897e4/workbuddy-visio
• 安装说明：https://skillhub.cn/install/skillhub.md
• API 元数据：https://api.skillhub.cn/user_6c3897e4/workbuddy-visio