前言¶
流程圖、架構圖、時序圖往往要先在腦子裏理清結構，再對着 draw.io 拖節點、連箭頭。如果材料已經寫在需求說明或設計文檔裏，還要手工「翻譯」成圖，重複勞動多，改一版文檔就要重畫一版。
下面介紹 SkillHub 上的 Draw.io自動生成器（@user_509b3ac1/drawio-generator-pro）。它讓 Agent 根據你的文字描述或上傳的文檔，直接產出 draw.io 能打開的 XML 圖表文件，你再在官方編輯器裏查看和微調，而不是從零搭畫布。
這是什麼¶
Draw.io自動生成器 是一條面向內容創作的 Agent Skill（分類 content-creation，社區來源，當前版本 1.0.0）。發佈座標爲 @user_509b3ac1/drawio-generator-pro，維護方爲 SkillHub 用戶 user_509b3ac1。
一句話定位：把自然語言流程描述或文檔內容，轉換成 draw.io 可編輯的 .drawio 文件（底層爲 draw.io 使用的 XML 格式）。Skill 標註 requires_api_key=false，不依賴額外 API Key。
核心功能¶
依據 SkillHub 官方簡介，已覈實的能力包括：
- 自然語言 → 圖表：用戶用文字描述業務流程時，生成流程圖類
.drawio文件。 - 文檔 → 圖表：用戶上傳文檔時，從文中提取流程或結構，再生成對應圖表。
- 多類圖示：在用戶明確要求時，可面向架構圖、時序圖、網絡拓撲圖等常見 draw.io 圖示類型生成文件。
生成完成後，Skill 要求 Agent 必須告知用戶：用 draw.io 網頁版 app.diagrams.net 或桌面客戶端打開 .drawio 文件，進行查看和手動微調。Agent 側負責產出文件，最終排版與細節仍以 draw.io 爲準。
安裝與啓用¶
安裝流程以 SkillHub 通用說明爲準：skillhub.cn/install/skillhub.md。也可把下面提示詞發給支持 Skill 的 AI，由它按文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_509b3ac1/drawio-generator-pro`。
若本機已有 SkillHub CLI，可先檢查版本，再安裝到當前 Agent 能識別的 skills 目錄（安裝時必須帶 --dir，否則默認落在 ./skills/ 可能不會被加載）：
command -v skillhub && skillhub --version
未安裝 CLI 時，可用官方腳本完整安裝（含 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
安裝本 Skill 示例（將 <skills 目錄> 換成你當前環境的路徑）：
skillhub install user_509b3ac1/drawio-generator-pro --dir <skills 目錄>
常見客戶端的 skills 目錄（來自 SkillHub 安裝文檔）：
| 環境 | 路徑 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
安裝後按你所用客戶端的要求重啓或刷新 Agent，使 Skill 生效。SkillHub 頁面統計（截至頁面展示）：下載約 6499 次，安裝約 215 次；評分字段在商店中爲 100000 量級展示，具體算法以 SkillHub 爲準。
典型用法¶
官方未提供固定 CLI 子命令；用法是在已啓用該 Skill 的對話裏，用自然語言說明要畫的圖或提供文檔。下面三類場景與 SkillHub 簡介一致，可直接復現思路：
1. 業務流程 → 流程圖
向 Agent 描述步驟、分支與起止，並說明需要 .drawio 輸出，例如：
根據下面流程生成 draw.io 流程圖，保存爲 .drawio 文件：
用戶提交訂單 → 校驗庫存 → 庫存不足則通知用戶，充足則創建支付單 → 支付成功則發貨，失敗則取消訂單。
2. 上傳文檔 → 提取併成圖
將含有流程或架構說明的文檔交給 Agent，要求提取結構並生成圖表文件（具體上傳方式取決於當前 Agent 是否支持附件）。
3. 指定圖示類型
在需求中寫明圖示類型，便於 Skill 對齊輸出形態，例如：
根據這段服務調用說明畫時序圖，輸出 .drawio，我稍後在 app.diagrams.net 裏改樣式。
收到文件後，用 draw.io 打開覈對節點與連線，再按需改顏色、佈局和圖例。
適用場景與注意¶
適合誰
- 需要快速把文字需求或現有文檔變成可編輯圖示的開發者、產品、技術寫作者。
- 已習慣 draw.io 生態、希望保留「生成 + 手工精修」工作流的人。
限制與注意
- 輸出是
.drawio（XML），不是 PNG/SVG 截圖；分享靜態圖仍需在 draw.io 中導出。 - 複雜圖的一次生成結果可能需要較多手工調整；Skill 本身也強調在 draw.io 中微調。
- 圖示準確度依賴你對流程、角色、邊界的描述是否清楚；文檔結構混亂時，提取效果可能變差。
- 無需 API Key，但仍依賴你所用 Agent 對 Skill 與文件寫入的支持。
結尾¶
Draw.io自動生成器 把「寫清楚流程」和「在 draw.io 裏可編輯成圖」連在一起，減少從文檔到畫布的重抄成本。若要在本地 Agent 中安裝，以 SkillHub 安裝文檔和座標 @user_509b3ac1/drawio-generator-pro 爲準。
