前言¶

寫技術文檔、做方案評審時，把業務流程或系統架構講清楚，通常要藉助繪圖工具。但手繪圖形費時間，截圖貼到文檔裏又不好維護：流程一改，圖就得重畫，版本一多，圖和文檔經常對不上。

這個 Skill 走另一條思路：不畫圖，而是生成圖的描述代碼（Mermaid / PlantUML），代碼可以直接渲染成流程圖、架構圖、時序圖、ER 圖，改起來就是改幾行文本。下面介紹它的具體能力、啓用方式和使用上要注意的地方。

這是什麼¶

「流程圖架構圖生成」（座標 @kunlungrowth/diagram-as-code，版本 1.0.0）是一個面向大模型 Skill 生態的代碼生成 Skill，發佈者爲「崑崙增長」，來源標註 enterprise，分類 dev-programming。

它解決的問題很明確：用戶用自然語言描述業務流程或系統架構，Skill 負責把這些描述轉成 Mermaid 或 PlantUML 代碼，用戶再把代碼粘貼到支持渲染的環境裏出圖。整個過程不需要用戶自己掌握繪圖語法。

核心功能¶

根據官方頁面提供的資料，已覈實的能力有三項：

1、雙格式輸出：生成 Mermaid 或 PlantUML 代碼，兩種格式在渲染生態裏都比較通用，Mermaid 適合文檔、Wiki 類場景，PlantUML 適合更正式的架構建模場景。

2、覆蓋四類圖：流程圖、架構圖、時序圖、ER 圖。流程類、結構類、時間維度和數據關係類圖都有對應語法，說明 Skill 內部對這幾類圖都做了支持，而不是隻做流程圖。

3、觸發詞驅動：官方給出的觸發詞是「流程圖、架構圖、Mermaid、時序圖」。也就是說，對話裏出現這些詞時，Skill 就會被激活，用戶不需要記專門的命令。

另外，頁面元數據裏標註了 requires_api_key=false，即啓用這個 Skill 不需要額外的 API Key。

安裝與啓用¶

已抓取的資料中沒有給出安裝命令，也沒有 Cursor / Codex CLI / Claude Code 等具體客戶端的接入步驟，頁面上顯示的安裝數爲 0，因此這一步只能按現有信息說明，不展開命令。

可覈實的入口有兩個：

SkillHub 頁面：https://www.skillhub.cn/skills/kunlungrowth/diagram-as-code
API 地址：https://api.skillhub.cn/kunlungrowth/diagram-as-code

Skill 座標是 @kunlungrowth/diagram-as-code，如需在客戶端裏配置，用這個座標定位。

典型用法¶

官方資料給出的用法路徑是三步：描述業務流程或系統架構 → Skill 生成 Mermaid / PlantUML 代碼 → 代碼渲染成圖。

舉例來說，向 Skill 描述一個訂單處理流程，期望得到的是一段 Mermaid 代碼。下面這段是 Mermaid 流程圖的標準語法，可以說明產出的形式：

graph TD
    A[下單] --> B{支付成功?}
    B -- 是 --> C[發貨]
    B -- 否 --> D[取消訂單]

把這段代碼放進支持 Mermaid 渲染的 Markdown 環境，就會顯示成一張流程圖。用戶改流程時，改的是這段文本，而不是重新畫圖。

時序圖、ER 圖同理，產出分別是 Mermaid / PlantUML 裏對應的語法塊，渲染依賴的是渲染環境本身對這些語法的支持，Skill 只負責把描述轉成代碼。

適用場景與注意¶

適合這幾類人：經常寫技術文檔、設計文檔的工程師；需要在方案評審裏快速出圖的人；團隊裏圖和文檔維護脫節、想用代碼方式管理圖的人。

需要注意的點：

1、渲染能力不在 Skill 裏。Skill 只產代碼，出圖要依賴支持 Mermaid / PlantUML 渲染的環境（如各類 Markdown 編輯器、文檔平臺、PlantUML 服務端）。先確認你要用的文檔環境支持哪種語法，再選輸出格式。

2、描述質量決定圖的質量。Skill 是根據自然語言描述生成代碼，架構層級、節點關係這些信息如果描述裏沒交代清楚，生成的圖也會有遺漏。複雜系統建議分模塊描述，而不是一次性塞一段長描述。

3、資料有限，落地前建議先試一次。官方資料沒有給出安裝命令和客戶端接入說明，安裝數爲 0，說明公開的使用案例很少。在把它放進正式流程之前，建議先用一個簡單流程驗證輸出語法和目標渲染環境是否兼容。

結尾¶

這個 Skill 的價值在於把「畫圖」變成「寫描述 + 渲染代碼」，流程改動只體現在文本上，圖的維護成本和文檔一致。對於已經在用 Mermaid / PlantUML 的團隊，它省的是記語法和寫代碼的時間；對於還沒用上的團隊，它提供了一個低門檻的入口。

官方地址：https://api.skillhub.cn/kunlungrowth/diagram-as-code，SkillHub 頁面：https://www.skillhub.cn/skills/kunlungrowth/diagram-as-code