Skill 寫法圖鑑

azure-advisor

Microsoft | 雲端與基礎設施 | 原文 | MIT

查詢並管理 Azure Advisor 的建議與狀態

中文翻譯

---
name: azure-advisor
description: "使用 Azure Advisor 的建議。WHEN: \"show Advisor recommendations\", \"service retirements\", \"update recommendation status\"。不要用在:修復或補救(用 azure-advisor-actionability)。"
license: MIT
metadata:
  author: Microsoft
  version: "1.0.1"
---

# Azure Advisor

## 速查

優先用 Azure Advisor MCP 工具,不要用 Resource Graph 或一般的 ARM 工具。

| 意圖 | 工具 |
|---|---|
| 數量、分類統計、排名或前幾大類型 | `advisor_recommendation_summary` |
| 個別建議或受影響的資源 | `advisor_recommendation_list` |
| 完成、忽略、延後或重新啟用 | `advisor_recommendation_update` |
| 瀏覽建議類型 | `advisor_metadata_list` |
| 用 ID 取得單一類型 | `advisor_metadata_get` |
| 取得修復方式 | `advisor_remediation_get`,然後 `azure-advisor-actionability` |

## 流程

1. 確認 subscription 或 service group 的範圍。Resource group 範圍需要指定 subscription。
2. 重複使用已知的範圍和識別碼,只問缺少的值。
3. 彙總用 `summary`,逐筆紀錄用 `list`。絕對不要去數一份被截斷上限的 list。
4. 只呈現回傳的資料,包括截斷、存取限制和錯誤。

要修復單一建議的請求,導向 `azure-advisor-actionability` skill。其他情況就從表格挑工具,服務汰除(service retirements)也用 `summary` 或 `list`。

## 安全

更新建議狀態之前要先確認。修復的安全防護由 actionability skill 負責。

英文原文

---
name: azure-advisor
description: "Use Azure Advisor recommendations. WHEN: \"show Advisor recommendations\", \"service retirements\", \"update recommendation status\". DO NOT USE FOR: fixes or remediation (use azure-advisor-actionability)."
license: MIT
metadata:
  author: Microsoft
  version: "1.0.1"
---

# Azure Advisor

## Quick reference

Prefer Azure Advisor MCP tools over Resource Graph or generic ARM tools.

| Intent | Tool |
|---|---|
| Counts, breakdowns, rankings, or top types | `advisor_recommendation_summary` |
| Individual recommendations or affected resources | `advisor_recommendation_list` |
| Complete, dismiss, postpone, or reactivate | `advisor_recommendation_update` |
| Browse recommendation types | `advisor_metadata_list` |
| Get one type by ID | `advisor_metadata_get` |
| Retrieve remediation | `advisor_remediation_get`, then `azure-advisor-actionability` |

## Workflow

1. Identify subscription or service-group scope. Resource-group scope requires a subscription.
2. Reuse known scope and identifiers; ask only for missing values.
3. Use `summary` for aggregates and `list` for records. Never count a capped list.
4. Present only returned data, including truncation, access limitations, and errors.

Route requests to fix one recommendation to the `azure-advisor-actionability` skill. Otherwise choose the tool from the table, including `summary` or `list` for service retirements.

## Safety

Confirm before recommendation-state updates. The actionability skill owns remediation safeguards.