drawio-skill 是什麼、怎麼安裝使用：讓 AI 生成可編輯 draw.io 架構圖的 Skill（自檢重疊、支持 Mermaid 轉換）

本文根據 Agents365-ai/drawio-skill 倉庫中英文 README 整理，資料核對於 2026-10-11。功能較多且更新快，以倉庫 README 為準。

是什麼

draw.io（diagrams.net）是使用最廣的免費畫圖工具之一，文件格式是 XML。drawio-skill 讓智能體直接寫出 .drawio 文件——關鍵詞是可編輯：產物不是一張圖片，而是你可以在 draw.io 裏繼續拖拽修改的源文件。

README 給它的定位比「畫圖」更進一步：把自然語言和真實的系統來源變成可維護的架構模型。除了生成和導出，它還能在不丟棄你手工調整過的佈局的前提下做增量同步、從同一個模型投影出多個視圖、檢查架構約束、查詢依賴關係等。GitHub 倉庫描述裏列的來源包括代碼、Terraform、Kubernetes、SQL、OpenAPI 等。

流程上有一個實用的設計——自檢：技能先規劃佈局、寫 XML、導出，然後檢查自己導出的 PNG，自動修復元素重疊、標籤被截斷、連線堆疊等問題（README 說最多兩輪），之後再接受你最多五輪的修改意見。

截至 2026-10-11，GitHub 顯示該倉庫約 1.0 萬 Star、707 Fork，最近一次推送在 2026-10-02。

包含哪些 Skill

倉庫提供一個技能，README 列舉的能力包括：

• 從描述生成：一句話得到可編輯的 .drawio；
• Mermaid 轉原生 draw.io（需要較新版本的 draw.io）：把思維導圖、甘特圖、時間線、用戶旅程、餅圖、桑基圖、看板等 28 種 Mermaid 標準圖轉成帶佈局、可編輯的 draw.io 圖；
• 從真實來源生成：先把來源解析成圖的中間數據，再排布成圖；
• 導出為圖片等格式，以及生成可交互的講解頁面。

怎麼安裝

分兩步。第一步，安裝 draw.io 桌面版（技能通過它的命令行導出），macOS 上是：

bash
brew install --cask drawio

其他系統的安裝方式見 README。

第二步，安裝技能：

bash
npx skills add Agents365-ai/drawio-skill -g

也可以手動克隆到技能目錄。

怎麼用

• 「畫一張我們系統的架構圖：網關、三個微服務、消息隊列、兩個數據庫，存成 arch.drawio」；
• 「根據這個倉庫的 Terraform 配置生成部署架構圖」；
• 「把這段 Mermaid 流程圖轉成 draw.io 文件，我要手動調整」；
• 「圖裏的日誌服務和監控服務重疊了，調一下佈局」。

適合誰 / 不適合誰

適合： 團隊本來就用 draw.io 畫架構圖、希望 AI 出初稿後人工精修的工程師；需要讓圖和基礎設施配置保持同步的平台團隊。

不適合： 不想在本機裝 draw.io 桌面版的人；只要一張好看的示意圖、不需要繼續編輯的場景（本站介紹過的 Diagram Design、Archify 更直接）；沒有圖形介面的伺服器環境，導出步驟可能需要額外配置。

注意事項

• 許可證：MIT。
• 會執行命令：調用本機的 draw.io 命令行導出文件，並讀取你指定的代碼和配置作為來源。
• 圖是模型的理解：從代碼或配置生成的架構圖可能漏掉或畫錯依賴，用於文檔和評審前要人工核對。
• 維護狀態：最近推送 2026-10-02，有中文 README 和在線文檔。
• 第三方技能安裝前瀏覽 SKILL.md。