1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | azure-resource-visualizer-microsoft-azure-skills | — |
| 项目自述名称 | Azure Resource Visualizer | SKILL.md |
| 作者/维护者 | Microsoft（Azure Skills Plugin 团队） | GitHub API |
| 来源链接 | https://github.com/microsoft/azure-skills/tree/main/skills/azure-resource-visualizer | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 1,363 / 224（合集仓库整体，非该子技能单独数据） | GitHub API |
| 最新版本 | 1.2.1（SKILL.md metadata） | SKILL.md |
| 安装方式 | APM 统一安装 / 各 Agent 插件市场（见第 10 章） | 官方 README |
2. 功能介绍与亮点
该技能让 agent 连接到用户自己的 Azure 订阅，自动发现指定资源组内的全部资源，逐项分析其类型、SKU/层级、网络配置（VNet、子网、私有终结点）、身份与访问（托管身份、RBAC）等信息，识别资源之间的网络连接、数据流向、身份关联与配置依赖，最终生成一份带 Mermaid 架构图的 Markdown 说明文档。
核心亮点：
- 自动发现 + 关系建模：不需要用户手工梳理资源清单，技能自行调用 Azure MCP 工具或
azCLI 完成资源盘点与关系推导。 - 分层可视化：按网络、计算、数据、安全、监控等维度分组，用 Mermaid 子图呈现层次结构，并在节点标签中标注 SKU、层级等关键配置。
- 主动的敏感信息防护：SKILL.md 明确要求密钥、连接字符串等敏感值一律用占位符表示，禁止把真实密钥写入图表。
- 产出物可复用：生成独立的 Markdown 文件（含资源清单表格 + 图表 + 关系说明），可直接提交进代码仓库或分享给团队，而非一次性对话输出。
- 该技能是 Microsoft 官方 Azure Skills Plugin（2026 年 3 月发布）后续迭代新增的能力之一，插件仓库近期（数日内）仍有跨技能的同步更新提交，处于持续维护状态。
3. 适用场景
所属分类：DevOps 与基础设施
适用于云架构师、平台工程师、SRE 及刚接手陌生 Azure 环境的开发者：
- 架构评审前，快速生成当前资源组的可视化拓扑，辅助讨论
- 新成员入职，用一份图文文档讲清楚现有 Azure 部署长什么样
- 生产环境排查时，先摸清资源间的依赖关系再定位问题
- 为合规或审计场景整理一份资源关系说明文档
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 ✅ | 官方在 Claude Code 插件市场直接提供安装（/plugin install azure@claude-plugins-official），SKILL.md 随插件安装进 skills 目录 |
| Codex | 原生支持 ✅ | 官方提供 Codex CLI 插件市场安装（codex plugin marketplace add microsoft/azure-skills），并可在 Codex 内通过 /skills 单独启停该技能 |
| OpenClaw | 未验证 | 官方渠道列出的是 GitHub Copilot、Cursor、Gemini CLI、IntelliJ IDEA 及经 APM 统一安装支持的 “OpenCode”（与 OpenClaw 为不同项目），未见 OpenClaw 相关说明 |
| Hermes Agent | 未验证 | 官方渠道未提及 |
5. 推荐理由
这是 Microsoft 官方团队持续维护的只读 Azure 基础设施可视化能力：一次对话把一个陌生资源组变成带说明的架构图文档，安全边界清晰（只读、不改动线上资源），特别适合初中级用户在不熟悉 Azure 门户操作的情况下快速看懂现有部署。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Microsoft 官方团队维护；所属插件仓库整体 1,363 星/224 fork，该数字属于整个合集，不代表本技能自身热度；本技能目前暂无独立于合集之外的第三方引用或讨论数据 |
| 可用性 | 8 | SKILL.md 含完整工作流程、成功标准、Mermaid 语法规范，并配有示例图与文档模板文件；需要用户已具备 Azure 订阅并完成 CLI/MCP 登录配置；所属插件仓库近期仍有更新提交，维护活跃；不产生额外付费依赖 |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell/权限范围 | 仅执行只读 Azure 查询（资源列表/详情），SKILL.md 正文明确写明“绝不修改或删除 Azure 资源（只读分析）” |
| ② 运行时联网外发 | 仅连接用户自己的 Azure 订阅 API，无第三方外发 |
| ③ 凭据处理 | 复用用户已有的 Azure CLI 登录态/托管身份，技能本身不额外收集或存储凭据 |
| ④ 可疑指令 | 未发现注入迹象；反而主动要求对密钥等敏感值使用占位符、禁止写入真实密钥到图表中 |
| ⑤ 作者信誉 | Microsoft 官方仓库维护 |
| ⑥ License | MIT，明确 |
| ⑦ 维护时间 | 所属仓库近期（数日内）有更新提交 |
综合评分：8.0（三项均值）
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 与本技能的差异 |
|---|---|---|
| cmb211087/azure-diagrams-skill（个人开发者项目） | 通用技术绘图技能，内置 800+ 图标，覆盖架构图、ER 图、业务流程图、时间线、线框图等多种图表类型 | 面向“从零绘制”任意类型技术图，不直接读取 Azure 实时资源；本技能连接 Azure MCP/CLI 抓取真实资源与配置，生成的图表反映当前实际部署状态 |
| Azure 门户内置资源视图 | 网页端原生功能，需在门户中逐个资源组点选查看拓扑 | 依赖人工在门户内浏览，不产出可保存分享的文档；本技能一次对话产出带图 Markdown 文件，可直接提交代码仓库 |
| 手工使用 draw.io / Lucidchart 绘制架构图 | 通用图表工具，人工绘制与维护 | 依赖人工整理资源清单、手绘连线，资源变更后需人工同步更新；本技能可随时基于最新资源状态重新生成 |
8. 用户评价
该技能目前在第三方平台尚无独立具名用户评价。其所属的 Azure Skills Plugin 由 Microsoft 官方于 2026 年 3 月发布并持续迭代，本技能是后续版本新增的能力之一；行业内已有独立技术博主（如持有多项 Azure 认证的 Microsoft MVP Thomas Thornton）撰文讨论“用 agent 技能自动生成 Azure 架构图”这一做法本身的价值，认为图表应与代码、文档并列成为“一等产出物”，但该文聚焦的是另一套基于 Draw.io MCP 的实现，未直接评价本技能。
9. 其他补充
该技能所属的 Azure Skills Plugin 同时提供 Azure MCP Server（200+ 结构化工具，覆盖 40+ Azure 服务）与 Foundry MCP，三者打包安装；本技能是插件内 27 个 Azure 技能之一，专注资源可视化这一单一场景。
10. 安装使用方式
- APM（跨多个 Agent 一次安装）：
apm install microsoft/azure-skills - Claude Code：
/plugin install azure@claude-plugins-official，或运行/plugin在插件市场搜索 “azure” - Codex CLI：先
codex plugin marketplace add microsoft/azure-skills添加市场，再通过/plugins安装azure，可用/skills单独启停本技能 - GitHub Copilot CLI：
/plugin marketplace add microsoft/azure-skills后/plugin install azure@azure-skills - Gemini CLI：
gemini extensions install https://github.com/microsoft/azure-skills - Cursor / IntelliJ IDEA：通过对应插件市场搜索 “Azure” 安装
安装后注意事项：需要已登录 Azure CLI（az login）并拥有目标资源组的读取权限；若通过 Azure MCP 使用，需要 Node.js 18+ 环境以启动 MCP 服务器；无需重启 Agent，安装完成后直接用自然语言请求“生成某资源组的架构图”即可触发。
11. 注意事项
- 复杂资源组（50+ 资源）建议按分层拆成多张图，避免单图过于拥挤，SKILL.md 已内置该分层建议
- 需要目标资源组的读取权限，权限不足时技能会提示需要检查的 RBAC 角色，但不会自动提权
- 生成的是静态时点快照，资源变更后需要重新运行才能得到最新拓扑
- 仅覆盖 Azure，不支持其他云厂商资源