前言¶

畫架構圖常見的三條路都有代價：打開 Draw.io 拖框，圖存在工具裏，改完要重新導出；手寫 Mermaid，佈局靠渲染引擎，遇到複雜結構常常要反覆調語句；寫文檔時圖和正文分開維護，時間一長兩邊對不上。

下面介紹的 Skill 想把這些合併成一步：用自然語言描述要畫什麼，Skill 自己決定圖的類型和輸出形態，產出可以直接放進文檔或頁面的結果。

這是什麼¶

「架構圖專業繪製」是一個基於通用 SKILL.md 格式的 Agent Skill，座標 @user_d28c9161/smart-arch-diagram，由社區發佈者 user_d28c9161 發佈並維護，當前版本 1.0.0，分類 dev-programming，來源標記爲 community。

它解決的問題是：從一段需求描述到一張可用的圖，中間的選型和排版工作交給 Skill，人只需要把意圖說清楚。

核心功能¶

官方簡介列出的能力有三項，全部圍繞”從意圖到成品圖”這條鏈路：

1、智能意圖挖掘：從自然語言描述裏判斷要畫哪種圖、需要哪些節點和連線，不需要用戶手寫圖描述語法。
2、多模式渲染：同一個意圖可以走不同的渲染路徑，產出風格和複雜度不同的結果。
3、精美模板：提供現成的模板作爲起點，避免每次從空畫布開始排版。

覆蓋的圖類型：

• 系統架構圖
• 微服務架構
• 業務流程圖
• 時序圖
• 狀態機
• ER 圖

三種輸出模式¶

這是它和單純 Mermaid 生成器的主要區別。同一個 Skill 可以按場景選擇輸出形態：

1、HTML 模板：產出精美架構圖，適合放在內部文檔站點、Wiki 頁面或演示材料裏，樣式由模板控制。
2、內聯 SVG：產出靈活結構圖，適合需要二次編輯、嵌入現有頁面或與代碼一起版本管理的場景。
3、Mermaid 代碼塊：產出 Mermaid 源碼，適合直接寫進 Markdown 文檔、README 或 issue，由前端渲染。

選型建議：要好看、要對外展示，走 HTML；要能改、要嵌入頁面，走 SVG；要進代碼倉庫隨文檔一起維護，走 Mermaid。

安裝與啓用¶

已抓取資料裏沒有給出官方安裝命令，也沒有 Cursor / Codex CLI / Claude Code 各自的差異說明。這裏不補造命令，請以官方頁面爲準。

官方地址: https://api.skillhub.cn/user_d28c9161/smart-arch-diagram
SkillHub 頁面: https://www.skillhub.cn/skills/user_d28c9161/smart-arch-diagram
座標: @user_d28c9161/smart-arch-diagram
版本: 1.0.0
分類: dev-programming
來源: community
標籤: requires_api_key=false

有一點可以確認：requires_api_key=false，與簡介裏”零依賴離線可用”一致，說明它不依賴外部模型 API，也不需要配置密鑰。

典型用法¶

官方簡介沒有提供可復現的示例（沒有給出輸入樣例和對應輸出），這一節不補造案例。

按簡介描述的能力，用法是：在對話裏直接用中文或英文說明要畫什麼圖、包含哪些組件、組件之間怎麼調用，然後指定輸出模式。例如說明”畫一個微服務架構，包含網關、兩個服務和一個數據庫，用 Mermaid 輸出”——這是對能力範圍的描述，不是官方示例，實際措辭以你使用的 Agent 客戶端爲準。

適用場景與注意¶

適合的場景：

• 需要在同一份文檔裏混用多種圖（架構圖加時序圖加狀態機），不希望維護多個工具。
• 運行環境離線或不允許配置外部 API key。
• 圖要隨代碼一起進倉庫，傾向 Mermaid 或 SVG 這類文本可版本管理的形態。
• 團隊文檔需要統一模板，不希望每個人畫出來風格各異。

需要注意的地方：

• 來源是 community，不是官方維護，質量取決於發佈者更新。
• 當前版本 1.0.0，屬於初始版本。
• 抓取時點 SkillHub 頁面顯示評分 100000、下載 984 次、安裝 0 次。評分與下載量是平臺展示數據，安裝數爲 0 說明它還沒有經過大量實際部署驗證，選型時要留出驗證成本。
• 模板的精美程度和 Mermaid 渲染兼容性需要實際跑一次才知道，建議先拿一個真實圖試輸出，再決定是否接入文檔流程。

結尾¶

這個 Skill 的價值在於把”選型、排版、導出”三件事壓成一次對話：你說清楚意圖，它決定圖類型和輸出形態。零依賴、不需要 API key，意味着它可以在離線環境和 CI 文檔構建裏直接用，不需要額外申請密鑰。

缺點也明確：社區來源、1.0.0 版本、安裝數爲 0。適合作爲內部文檔產線的候選組件先試用，不適合作爲關鍵交付物的唯一依賴。

官方地址: https://api.skillhub.cn/user_d28c9161/smart-arch-diagram
SkillHub 頁面: https://www.skillhub.cn/skills/user_d28c9161/smart-arch-diagram