Azure Resource Visualizer – Architecture Diagram Generator

Azure Resource Visualizer – Architecture Diagram Generator 是什么

Azure Resource Visualizer – Architecture Diagram Generator 会读取指定资源组的真实资源、配置和依赖，生成分层 Mermaid 架构图及配套 Markdown 文档。目标是解释计算、网络、数据、安全和监控资源如何连接，而不是画一张只列图标的概念图。

适用场景与选择边界

适合现有环境架构盘点、交接文档、评审和故障沟通；也可发现未连接、重复或缺少监控的资源。它不负责部署、成本优化或生产故障修复，也不能从资源清单推导未暴露的业务调用。需要设计未来企业基础设施时应使用 Enterprise Infra Planner。

核心能力与工作机制

它先列出资源组供用户选择，深度查询每个资源的 SKU、端点、身份、网络和引用，识别数据、身份与网络关系，再生成资源清单、图、关系说明和观察事项。

实际工作流

没有明确资源组时先列举并等待选择；随后查询全部资源，按层分类并从配置中验证连接。构造有意义的 Mermaid 节点与带标签连线，写入 Markdown，再检查语法、遗漏资源和未经证实的关系。

输入、输出与交付物

需要目标订阅、资源组以及图的用途；若有多个资源组必须明确选择，不能默认把不同环境混在一起。输出是包含标题、订阅与区域摘要、资源清单、Mermaid 图、关系解释和备注的 Markdown 文件，节点应带关键 SKU 或设置，连线说明数据、身份或网络流向。

依赖、账号与权限

需要 Azure 登录和目标范围的资源读取权限，优先用 Azure MCP，缺失时用 Azure CLI。写文档需要本地目录权限，但不需要修改云资源。

限制与安全风险

仅凭命名推断关系可能制造错误架构；敏感端点、内部 IP 和资源标识写入文档后可能泄露。图过大也会失去可读性，应保持完整清单并按层或子系统分组。正常流程只读取云资源并创建或更新本地 Markdown 图，不应修改 Azure 配置。若用户要求同时“修复架构”，那是另一项变更任务，需独立确认。

适合谁使用

适合云架构师、SRE、审计和需要理解陌生 Azure 环境的开发者。少量资源可直接用清单，不必强行生成复杂图。

上手与验收建议

先从单个非生产资源组生成图，确认命名和分层习惯，再扩展到生产。验收应将资源清单与 Azure 实际数量、类型和区域核对，逐条抽查关键连线的配置证据，并渲染 Mermaid 检查语法与布局；文档要注明时间和范围。

来源、版本与许可

本条目依据 Microsoft 官方 azure-skills 仓库固定提交中的完整 Azure Resource Visualizer – Architecture Diagram Generator Skill、skills.sh 市场详情和仓库 MIT 许可证整理，核验日期为 2026 年 9 月 20 日。来源未提供官方中文展示名，因此导航保留官方英文名称。

常见问题

1. Azure Resource Visualizer – Architecture Diagram Generator 主要解决什么问题？

Azure Resource Visualizer – Architecture Diagram Generator 会读取指定资源组的真实资源、配置和依赖，生成分层 Mermaid 架构图及配套 Markdown 文档。目标是解释计算、网络、数据、安全和监控资源如何连接，而不是画一张只列图标的概念图。适合现有环境架构盘点、交接文档、评审和故障沟通；也可发现未连接、重复或缺少监控的资源。

2. 开始前需要准备哪些输入和上下文？

需要目标订阅、资源组以及图的用途；若有多个资源组必须明确选择，不能默认把不同环境混在一起。需要 Azure 登录和目标范围的资源读取权限，优先用 Azure MCP，缺失时用 Azure CLI。写文档需要本地目录权限，但不需要修改云资源。

3. 执行后会得到什么结果或文件？

输出是包含标题、订阅与区域摘要、资源清单、Mermaid 图、关系解释和备注的 Markdown 文件，节点应带关键 SKU 或设置，连线说明数据、身份或网络流向。

4. 需要哪些账号、工具和最小权限？

需要 Azure 登录和目标范围的资源读取权限，优先用 Azure MCP，缺失时用 Azure CLI。写文档需要本地目录权限，但不需要修改云资源。仅凭命名推断关系可能制造错误架构；敏感端点、内部 IP 和资源标识写入文档后可能泄露。图过大也会失去可读性，应保持完整清单并按层或子系统分组。

5. 它会修改本地文件或云端资源吗？

正常流程只读取云资源并创建或更新本地 Markdown 图，不应修改 Azure 配置。若用户要求同时“修复架构”，那是另一项变更任务，需独立确认。

6. 哪些需求不应该交给这个 Skill？

它不负责部署、成本优化或生产故障修复，也不能从资源清单推导未暴露的业务调用。需要设计未来企业基础设施时应使用 Enterprise Infra Planner。

7. 遇到失败或结果异常时怎样处理？

查询不全时先检查订阅、资源组和权限，并把未覆盖类型标出；Mermaid 失败要验证节点 ID、特殊字符和 subgraph 结构。无法从配置证明的关系应标记未知，而不是猜测。

8. 如何验收结果确实可靠？

验收应将资源清单与 Azure 实际数量、类型和区域核对，逐条抽查关键连线的配置证据，并渲染 Mermaid 检查语法与布局；文档要注明时间和范围。