前言¶
寫設計文檔或評審材料時，架構關係往往已經寫在 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
