前言¶
写设计文档或评审材料时，架构关系往往已经写在 README、接口说明或对话里，却要再花一轮时间把同一套结构画进 PPT 或 Visio。手工拖形状、对齐连接器，改一版逻辑就要重画一遍。下面介绍 SkillHub 上的「架构图一键生成」，它把 ContextWeave 的能力封装成 Agent Skill，让模型从自然语言、文件或代码里抽出结构，并直接产出可继续编辑的图文件。
这是什么¶
「架构图一键生成」是社区发布的 Agent Skill，坐标为 @user_814dbe54/contextweave-interactive-architecture，当前版本 1.2.12，分类为 design-media，标签标明 requires_api_key=false（不依赖额外 API Key）。维护方为 SkillHub 用户 user_814dbe54。
Skill 的定位是：使用 ContextWeave 生成或修改架构图、流程图、思维导图和复杂信息图；从代码、文件或自然语言中提取结构与关系，并产出实际可用的图文件。它解决的是「结构已有、成图成本高」的问题，而不是替代通用绘图软件里的每一类图形。
核心功能¶
以下能力均来自 SkillHub 官方简介，安装后由 Agent 按 Skill 说明调用 ContextWeave 完成。
- 图类型：架构图、流程图、思维导图、复杂信息图。
- 输入来源：自然语言描述、项目文件、代码中的组件与依赖关系等（由 Agent 解析后交给 ContextWeave）。
- 导出格式：
- CW（ContextWeave 原生）
- SVG、HTML（便于嵌入或预览）
- 可编辑 PPTX（未特别说明时，使用原生形状与连接器导出）
- 原生 VSDX（Visio，同样默认原生形状与连接器） - 修改已有图：简介写明支持「生成或修改」，可在已有 CW 等产物上迭代结构，而不必从零重画。
明确不覆盖的范围（官方说明）：统计图表、手绘插画、像素级排版类需求不适合用本 Skill。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。在 SkillHub 页面上，官方给出的安装指引是：让 AI 根据 SkillHub 安装文档 安装坐标 @user_814dbe54/contextweave-interactive-architecture。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 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 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。常见路径如下（摘自官方安装文档）：
| Agent / 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
以 Cursor 为例，安装命令形如：
skillhub install @user_814dbe54/contextweave-interactive-architecture --dir ~/.cursor/skills/
也可在对话中直接提示 Agent：「请根据 https://skillhub.cn/install/skillhub.md，安装 @user_814dbe54/contextweave-interactive-architecture。」由 Agent 按文档完成 search/install 与目录选择。
安装或更新 Skill 后，按你所用客户端的惯例重启或刷新 Agent，确保新 Skill 被加载。
典型用法¶
官方页面未提供固定脚本示例，用法本质是：在已启用该 Skill 的 Agent 里，用自然语言说明「要什么图、依据什么材料、要什么格式」。下列表述与简介一致，便于复现思路（具体文件名与仓库路径请换成你的项目）。
- 从文字生成架构图并导出 PPTX
向 Agent 说明系统边界、主要服务与调用关系，并明确要求导出可编辑 PPTX，且使用原生形状与连接器。Skill 会走 ContextWeave 生成结构图并给出 PPTX 文件。
- 从代码或配置文件提炼流程图
提供模块入口、状态机或部署清单等文本/代码片段，要求生成流程图，输出 SVG 或 HTML 便于放进文档。
- 迭代修改
若已有 CW 或上一轮生成的图，说明要增删的节点或连线，要求「在现有图上修改」并再次导出所需格式。
- 需要 Visio 协作时
指定导出 VSDX，便于团队在 Visio 中继续编辑；默认行为同样是原生形状与连接器，而非整页位图。
每一步无需单独记 ContextWeave 命令行；由 Skill 约束 Agent 的输出形态与格式选择。
适用场景与注意¶
适合谁
- 需要把架构、流程或长文里的层次关系快速变成结构化图示的开发者、架构师、技术写作者。
- 交付物要进 PPT 汇报 或 Visio 流程库，且希望保留形状级可编辑性，而不是一张静态截图。
使用注意
- 本 Skill 面向结构图与信息图，不要用来画折线图、柱状图等统计图表。
- 不负责插画风格或杂志级排版；复杂视觉稿仍需专业设计工具。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 132721；安装数在页面上可能随统计方式变化，以 SkillHub 实时数据为准。
- 用户线索中的 API 地址
https://api.skillhub.cn/user_bddf3fe6/contextweave-interactive-architecture与页面坐标user_814dbe54的展示路径不同，安装与引用请以坐标@user_814dbe54/contextweave-interactive-architecture及 SkillHub 技能页为准。
结尾¶
「架构图一键生成」把 ContextWeave 的成图与多格式导出收敛进一个 Skill，减少从描述到可编辑 PPTX/VSDX 的重复劳动。若你已在用 Cursor、Claude Code 等支持 Skills 的客户端，可按上文安装到对应 skills 目录后直接试用。
- SkillHub 技能页：https://www.skillhub.cn/skills/user_814dbe54/contextweave-interactive-architecture
- 安装说明：https://skillhub.cn/install/skillhub.md
- 线索中的官方 API 入口：https://api.skillhub.cn/user_bddf3fe6/contextweave-interactive-architecture
