azure-resource-visualizer skill 是什麼、怎麼安裝使用：把 Azure 資源組畫成 Mermaid 架構圖

本文根據 microsoft/azure-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 54.8 萬次；所在倉庫 microsoft/azure-skills 在 GitHub 約 1555 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

接手別人留下的 Azure 環境，第一件事是弄清「這些資源之間是什麼關係」，門戶裏一個個點開看很慢。這個技能讓智能體替你讀一遍再畫出來。description：分析 Azure 資源組，生成詳細的 Mermaid 架構圖，展示各個資源之間的關係；觸發說法包括創建架構圖、可視化 Azure 資源、分析資源組、繪製資源拓撲。

SKILL.md 規定了四步流程：

1. 選資源組：你沒指定時，列出可用的資源組和所在區域，編號讓你選，等你回答後再繼續。
2. 發現與分析：查詢資源組裏的全部資源，逐個記錄名稱與類型、規格檔位、區域、關鍵配置、網絡設定（虛擬網絡、子網、私有終結點）、身份與訪問（託管身份、角色分配）和依賴關係；跨訂閱的批量盤點用 Azure Resource Graph 查詢，目錄裏有一份查詢寫法參考。
3. 構圖：把網絡連接、數據流向、身份關係等畫成 Mermaid 圖。
4. 寫文件：按模板生成 [資源組名]-architecture.md，包含標題資訊、兩三段架構概述、資源清單表、完整的 Mermaid 圖、關鍵連接與數據流說明，以及觀察到的問題和建議。

後面還有質素標準、邊界情況處理和 Mermaid 語法規範，目錄裏附了一份示例圖和一份文檔模板。它優先使用 Azure MCP 工具，沒有相應工具時退回到 az 命令行。

怎麼安裝

azure-resource-visualizer 隨微軟的 Azure 插件一起安裝，插件同時配置好 Azure MCP Server。Claude Code 裏（命令來自倉庫 README）：

text
/plugin marketplace add microsoft/azure-skills
/plugin install azure@azure-skills

Gemini CLI 用 gemini extensions install https://github.com/microsoft/azure-skills，Codex 用 codex plugin marketplace add microsoft/azure-skills；GitHub Copilot 的裝法見 README。真正操作雲資源前，本機要裝好 Azure CLI（az）並登入，部署類場景還要 Azure Developer CLI（azd）。

倉庫整體介紹和其他安裝方式，詳見本站《azure-skills 是什麼、怎麼安裝：微軟官方 Azure Skills 插件（技能 + Azure MCP Server，讓智能體真正操作 Azure）》。

怎麼用

• 「把資源組 rg-prod-web 畫成架構圖」。
• 「我不確定有哪些資源組，先列出來讓我選」。
• 「重點標出哪些資源走私有終結點、哪些暴露在公網」。

生成的 Markdown 可以直接放進倉庫的文檔目錄，GitHub 等平台能直接渲染其中的 Mermaid 圖。

適合誰 / 侷限

適合接手存量環境的工程師、寫架構文檔和做安全評審前想先有一張全景圖的人。侷限：圖是按資源配置推斷的關係，應用層面的調用（比如代碼裏寫死的某個接口地址）它看不到；資源很多的資源組畫出來會很擁擠，需要你要求按層或按子系統拆開；它反映的是查詢那一刻的狀態，環境變了要重新生成。

注意事項

• 許可：MIT。
• 只讀操作：流程裏是查詢和寫本地 Markdown 文件，不修改雲資源；用只讀權限（如讀取者角色）的身份登入就夠了。
• 輸出裏有資源名稱、網絡結構等內部資訊，對外分享前先脫敏。
• 資源配置會進入模型上下文，涉及敏感環境時按公司的規定處理。