azure-diagnostics skill 是什麼、怎麼安裝使用：讓智能體按流程排查 Azure 線上故障（App Service、容器應用、AKS）

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

這個 Skill 做什麼

線上出問題時，最容易犯的錯是一頭扎進日誌。azure-diagnostics 給智能體定了一個固定的排查順序。description：使用 AppLens、Azure Monitor、資源健康狀態和安全的分診流程調試 Azure 上的生產問題。觸發場景列了一長串：App Service 高 CPU 和部署失敗、容器應用 503 或目標端口不匹配、Functions 的遙測在改配置後消失、AKS 的 Pod 掛起和崩潰循環、虛擬機遠程桌面或 SSH 連不上、Event Hubs 與 Service Bus 的連接和消息鎖問題等。

快速診斷流程五步：確認症狀 → 查資源健康（Azure 自己是否正常）→ 看日誌 → 分析指標 → 調查近期變更。

規則裏有幾條體現了「安全分診」：

• 先用你已經提供的證據。如果你要求只基於證據分析、或不允許訪問線上環境，它就不查詢也不修改 Azure，只從給定的日誌、指標和時間線推斷，並說明哪些是假設。
• 有 AppLens（通過 Azure MCP 提供的診斷工具）時優先用它。

按服務分了排障指南：容器應用（鏡像拉取失敗、冷啟動、健康探針、端口不匹配）、App Service（高 CPU、部署失敗、崩潰、響應慢、證書與自定義域名）、Functions、AKS、虛擬機連接、消息服務。目錄裏有五十多個文件，含常用的日誌查詢語句，以及給 AKS、App Service、容器應用採集證據用的 PowerShell 和 Bash 腳本。

怎麼安裝

azure-diagnostics 隨微軟的 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）》。

怎麼用

• 「我的容器應用一直返回 503，幫我排查」。
• 「昨晚改了連接字符串之後 Function 的遙測就沒了，這是日誌和時間線，只基於這些分析，不要動線上」。
• 「AKS 上有幾個 Pod 一直 Pending，查原因」。

適合誰 / 侷限

適合在 Azure 上跑服務、又沒有專職運維的開發團隊，值班時拿來做第一輪排查。侷限：能查到什麼取決於你的帳號權限和資源是否接了日誌與監控，沒開 Application Insights 的應用能看的很少；它給的是診斷和修復建議，根因涉及業務代碼時仍要回到代碼裏查。

注意事項

• 許可：MIT。
• 會讀取線上環境的日誌和配置：日誌裏可能有用戶數據和密鑰片段，注意這些內容會進入模型上下文；處理敏感系統時用它的「僅證據」模式，或用只讀權限的身份登入。
• 目錄裏的診斷腳本會在本機執行 az、kubectl 等命令，運行前可以先看一遍腳本內容。
• 重置虛擬機密碼、修改網絡規則這類修復動作會改動線上資源，讓它先說明打算做什麼，確認後再執行。