1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Azure Resource Graph（子技能，隶属 MicrosoftDocs/Agent-Skills 合集） |
| 作者/维护者 | Microsoft（MicrosoftDocs 官方文档团队） |
| 来源链接 | https://github.com/MicrosoftDocs/agent-skills/tree/main/skills/azure-resource-graph |
| 许可证 | CC-BY-4.0（GitHub API 获取） |
| GitHub Stars / Forks | 合集仓库整体 735 / 118（GitHub API 获取；该数字属整个合集，不代表本技能自身热度，见下方“跟同类相比”说明） |
| 最新版本 | 内容生成于 2026-08-31（SKILL.md 自带元数据） |
| 安装方式 | 克隆合集仓库后复制子目录到本地 skills 目录 |
2. 功能介绍与亮点
Azure Resource Graph 是 Azure 提供的大规模资源查询与治理引擎，可跨订阅、跨资源组用类 SQL 的 KQL 语法一次性查询成千上万个资源的元数据，避免逐个资源组调用管理 API 的低效方式。本技能把该服务的官方文档整理成结构化索引，覆盖六大板块：故障排查（告警集成、查询报错、Power BI 连接器问题）、最佳实践（避免限流的查询模式）、决策指南（GET/LIST API 与 Query 服务如何选择）、限额与配额（分页与大结果集处理）、配置（Bicep/ARM 部署共享查询）、集成与编码模式（CLI、PowerShell、REST API、Logic Apps、Power BI 连接器、资源变更历史查询）。
主要亮点：
- 官方一手来源：内容直接索引 Microsoft Learn 官方文档，避免第三方教程的滞后与错误。
- 多接口覆盖：CLI、PowerShell、REST、Power BI、Logic Apps 五种调用方式均有对应指南，覆盖脚本自动化到可视化报表的完整链路。
- 内容更新及时：索引内容于 2026-08-31 生成，仓库整体持续活跃维护。
3. 适用场景
所属分类：DevOps 与基础设施
适用于需要对 Azure 云环境做大规模资源盘点、合规巡检、成本分析或自动化治理的团队与个人——例如运维人员批量核查某类资源的配置是否合规、安全团队追踪资源变更历史、财务或架构团队通过 Power BI 生成跨订阅的资源报表。任何管理超过少量 Azure 资源的用户都可能受益，不限定特定角色。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——SKILL.md 格式原生识别，官方提供插件市场一键安装命令，文档抓取可用 mcp_microsoftdocs 或内置 WebFetch。
- Codex CLI：⚠️ 需适配——官方仓库列出 Codex CLI 安装路径，但 Codex 默认沙箱不带网络访问，本技能的文档抓取功能依赖联网，需用户显式开启网络权限才能完整发挥效果。
- OpenClaw：✅ 原生支持（格式层面）——SKILL.md 与 Claude Code 采用同一开放标准，可直接复制安装，但需自行确认平台是否提供等效的网页抓取工具。
- Hermes Agent：❓ 未验证——遵循同一 SKILL.md 开放标准，具体网络抓取能力未逐一核实。
5. 推荐理由
对任何管理多个 Azure 资源的用户来说，逐个资源组查询效率低下，而 Resource Graph 是官方给出的标准解法；本技能把该服务的全部官方文档整理成结构化索引并配好 CLI/PowerShell/REST/Power BI 多种落地路径，装上即可让 AI 助手直接给出可执行的查询与自动化方案。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方为 Microsoft 官方文档团队，属第一方产出；合集仓库整体 735 星，暂无该子技能自身的独立第三方证据（如具名评价、下载量数据） |
| 可用性 | 9 | 一条命令复制即用；文档覆盖故障排查/决策/配置/集成五大板块共 24 条官方链接；内容于 2026-08-31 生成，维护活跃；无付费依赖 |
| 安全性 | 9 | 纯文档索引类技能，不执行本地代码、不外发数据，仅按用户指令抓取公开的 Microsoft Learn 页面；License 明确；官方团队维护无造假迹象 |
综合评分：8.33
安全检查清单逐项结果：① 无 shell 命令执行 ② 联网行为仅限抓取公开文档页面、无数据外发 ③ 不要求任何 API key 或凭据 ④ SKILL.md 全文未见可疑指令或隐蔽外发迹象 ⑤ 作者为 Microsoft 官方文档团队，信誉良好 ⑥ License（CC-BY-4.0）明确 ⑦ 最近一次内容更新距今一周，维护活跃。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| Azure Policy 技能 | 面向策略合规的定义与执行 | 侧重“定规则、强制执行”；Resource Graph 侧重“查现状、跨订阅盘点”，两者常配合使用而非互相替代 |
| Azure Monitor / Log Analytics 类技能 | 面向运行时指标与日志 | 关注资源运行时的性能与日志数据；Resource Graph 关注资源的配置元数据与资产清单，查询对象不同 |
| 通用数据库查询类技能（如 ClickHouse、DuckDB） | 面向业务数据的 SQL 查询与分析 | 查询对象是用户自有的业务数据集；Resource Graph 专门针对 Azure 云资源本身的元数据，不通用于业务数据 |
8. 用户评价
该技能目前在第三方平台（Reddit、Hacker News、GitHub Discussions 等）尚无具名用户评价；已被 SkillsAuth、SkillsMP 等第三方技能市场收录展示，但均为目录索引而非用户评论。
9. 其他补充
本技能是 MicrosoftDocs/Agent-Skills 合集（覆盖 193 个 Azure/Microsoft 服务）中的一个子目录，各子技能可独立安装、互不依赖。
10. 安装使用方式
git clone https://github.com/MicrosoftDocs/agent-skills.git
cp -r agent-skills/skills/azure-resource-graph ~/.claude/skills/安装后无需重启，AI 助手会在用户提及 Azure Resource Graph 相关查询、CLI/PowerShell/REST 调用、Power BI 报表或资源变更历史等场景时自动触发该技能。技能运行时会尝试联网抓取 Microsoft Learn 页面获取完整文档内容，若网络不可用则仅能使用 SKILL.md 内置的分类目录与直链列表。
11. 注意事项
- 技能明确声明不适用于 Azure Monitor、Azure Policy、Azure Cost Management、Azure Resource Manager 场景，误用场景应改用仓库内对应的姊妹技能。
- 依赖网络访问拉取 Microsoft Learn 页面，离线环境下功能受限。
- 跨 Agent 兼容性仅确认 Claude Code 原生支持；Codex 需手动开启网络访问权限，OpenClaw、Hermes Agent 均需手动复制目录完成适配。