1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | azure-virtual-machines-MicrosoftDocs-Agent-Skills |
| 作者/维护者 | Microsoft（MicrosoftDocs 组织） |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-virtual-machines |
| 许可证 | CC-BY-4.0（GitHub API 获取） |
| GitHub Stars | 所属合集仓库 722（GitHub API，2026-08-29；该数字属整个合集，不代表本技能自身热度） |
| Forks | 117（GitHub API） |
| 最新版本 | 内容生成时间 2026-08-16（SKILL.md metadata.generated_at），对应提交 2026-08-17（GitHub API） |
| 安装方式 | 复制 skills/azure-virtual-machines 目录（含 SKILL.md 及 3 份参考文件）至 agent 的 skills 目录即可 |
2. 功能介绍与亮点
该技能是微软官方 docs2skills 工具从 Microsoft Learn 文档批量生成的 Azure Virtual Machines 专家知识库，正文含 SKILL.md 主索引（约 63KB）与 3 份分主题参考文件（configuration.md、integrations.md、deployment.md），合计约 94KB，是同系列 Azure 文档技能中目前已知内容总量最大的一份（此前纪录由单文件 64KB 的 Cloud Adoption Framework 保持，本技能凭多文件结构合计反超）。覆盖九大类主题：
- 故障排查：内核/AKS、包更新、休眠、网络/NSG、磁盘加密、扩展、还原点、Trusted Launch、Image Builder 等常见问题
- 最佳实践：性能、扩缩容、成本、高可用、存储、加密、Linux/Windows 调优、HPC/InfiniBand、迁移
- 决策指南：VM/磁盘/镜像选型、成本与预留规划、Linux/AKS/Oracle/GPU-HPC 工作负载设计与迁移
- 架构与设计模式：计算舰队模式、低延迟/NUMA 布局、集群/共享磁盘设计、跨云高可用与容灾架构
- 限额与配额：VM 规格、磁盘与存储限额、GPU/HPC 能力、专用主机装箱约束
- 安全（独立于参考文件之外，主文件内含）：磁盘加密（ADE/CMK/主机双重）、Key Vault、证书、Trusted Launch/MSP、RBAC/策略
- 配置（
configuration.md）：存储/磁盘、网络、NVMe/InfiniBand/GPU、Linux/Windows 代理与扩展、维护补丁、SSH/WinRM - 集成与代码模式（
integrations.md）：备份、还原点、磁盘快照管理、维护事件、监控、元数据、Oracle/SQL 集成脚本 - 部署（
deployment.md）：镜像定制、存储/加密变更、原地系统升级、蓝绿与滚动部署、跨区域/可用区迁移
正文是带分类索引的导航表，调用时按需通过 mcp_microsoftdocs 或 fetch_webpage 拉取对应 Microsoft Learn 文档最新正文，内容随官方文档更新自动保持新鲜，避免训练数据过时。主要亮点：官方出品、四文件协同覆盖 VM 从故障排查、架构设计到日常运维部署的完整生命周期，且明确标注了与同系列相邻技能（数据科学 VM、大型实例、SQL Server on VM、VM 规模集）的边界，避免功能重叠混淆。
3. 适用场景
所属分类：DevOps 与基础设施
面向直接操作 Azure IaaS 计算资源的角色：云运维/SRE 工程师排查 VM 内核、网络、加密或休眠故障时；架构师设计 Oracle/OpenShift on VM、GPU/HPC 集群或跨云高可用方案时；平台工程师规划 VM 选型、成本优化与迁移（如 v6/v7 规格迁移）时；以及需要落地磁盘加密、Trusted Launch 等安全配置的合规团队。核心价值集中在 Azure 虚拟机这一具体计算资源的深度运维知识，是单个 IaaS 服务层面的操作手册，而非跨领域的战略框架。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 标准 SKILL.md 格式，skills/ 目录直接可用；官方仓库描述明确面向“AI coding assistants” |
| Codex | ⚠️ 需适配 | Codex 加载 skills 的路径与 MCP 工具调用方式与 Claude Code 不同，需手动确认 mcp_microsoftdocs 在 Codex 环境下的等价配置，未专门核验 |
| OpenClaw | ❓ 未验证 | 未找到 OpenClaw 官方或社区关于该技能的适配说明 |
| Hermes Agent | ❓ 未验证 | 未找到 Hermes Agent 官方或社区关于该技能的适配说明 |
技能正文明确依赖网络访问和 mcp_microsoftdocs/fetch_webpage 两种取数方式之一，任何支持这两类工具调用的 agent 理论上均可运行，且 fetch_webpage 是通用网页抓取能力、非专有工具，不构成额外准入门槛；仅 Claude Code 有官方明确指向。
5. 推荐理由
Azure VM 的运维知识（内核调试、加密、HPC 调优、镜像构建、跨区迁移）散落在上百份独立的 Microsoft Learn 文档里，人工检索效率很低。这个技能把故障排查、最佳实践、决策、架构、配额、安全、配置、集成、部署九大板块压缩成一份可直接对话使用的索引，主文件之外另配 3 份专题参考文件进一步细分配置/集成/部署三类高频操作场景，正文只存导航结构、实际内容按需实时抓取官方最新版本。适合任何日常与 Azure VM 打交道、又希望 agent 给出可追溯官方依据而非泛泛而谈的运维与架构团队。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Microsoft 为 Azure Virtual Machines 服务的所有者，属第一方官方出品；所属合集仓库 722 stars 未达到子技能可借力的高星门槛，本技能自身暂无独立第三方讨论数据支撑更高档位 |
| 可用性 | 9 | 单目录复制即用、无付费依赖；SKILL.md 主索引 + 3 份参考文件合计约 94KB，是同系列技能中目前已知内容总量最大的一份；对应提交发生于 2026-08-17，距今约 12 天，属近期维护 |
| 安全性 | 9 | 纯文档索引类技能，无 shell 执行；联网行为仅限拉取 Microsoft Learn 公开文档、无用户数据外发；无需 API Key；正文及全部参考文件均未发现可疑指令；License（CC-BY-4.0）明确 |
综合评分：8.3
安全检查清单逐项结果：① 无 shell 命令执行 ② 联网仅用于拉取公开文档，目标透明（learn.microsoft.com） ③ 无需 API Key/凭据 ④ 对 SKILL.md 及 configuration.md/integrations.md/deployment.md 全部四份文件逐一检索，未发现可疑指令或混淆代码 ⑤ 官方出品，无造假迹象 ⑥ License 明确（CC-BY-4.0）⑦ 该子技能对应提交 2026-08-17，所属仓库最近提交同日期，维护活跃。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| AWS EC2 Management（第三方社区技能，mcpmarket.com 收录） | 面向 AWS EC2 的实例生命周期管理与网络配置知识 | 覆盖 AWS 单云的 EC2 实例操作；本技能覆盖 Azure VM 全生命周期（故障排查、架构、配额、安全、配置、集成、部署七大板块），云厂商与内容深度均不同 |
| azure-kubernetes-service-MicrosoftDocs-Agent-Skills | 微软官方 AKS 容器编排知识库，聚焦 Kubernetes 集群运维 | 面向容器编排这一更高抽象层；本技能面向裸金属/IaaS 层面的虚拟机本身，两者服务于不同的计算范式，适合分别处理容器化与非容器化工作负载 |
| azure-cloud-adoption-framework-MicrosoftDocs-Agent-Skills | 微软官方云采用框架，覆盖战略、着陆区、治理的企业级顶层决策 | 聚焦跨领域的战略与治理决策，不涉及具体服务操作细节；本技能聚焦 VM 这一具体资源的深度运维知识，两者可配合使用（CAF 定战略与着陆区，本技能做 VM 层面的具体实施） |
本技能的差异化在于：它是同系列中内容总量最大、覆盖单一计算资源最全面的技能，四份文件把 VM 的故障排查、架构设计、配置、集成、部署拆分成可独立索引的模块，既不像 CAF 停留在战略层面，也不像 AKS 技能局限于容器编排，专注服务好直接操作虚拟机这一最基础、最广泛的 IaaS 场景。
8. 用户评价
该技能目前在第三方平台尚无独立具名用户评价——它是 docs2skills 工具批量生成的官方文档索引技能，GitHub issues 中未见针对 azure-virtual-machines 单个子技能的讨论，社区反馈集中在 MicrosoftDocs/Agent-Skills 整个合集层面（如 front matter 合规性审计）。
9. 其他补充
docs2skills 是微软内部用于把 Microsoft Learn 文档批量转换为 Agent Skills 格式的生成器，同一仓库下还有 azure-vm-scalesets、azure-data-science-vm、azure-large-instances、azure-sql-virtual-machines 等紧密相关但边界明确划分的技能，SKILL.md 正文已在 description 字段注明各自适用场景，避免误装。
10. 安装使用方式
- 克隆或下载
MicrosoftDocs/Agent-Skills仓库，或直接下载skills/azure-virtual-machines目录（含 SKILL.md、configuration.md、integrations.md、deployment.md 四份文件） - 将该目录完整复制到所用 agent 的 skills 加载路径下（如 Claude Code 的
.claude/skills/） - 确保 agent 环境已安装并可调用
mcp_microsoftdocs工具（参见仓库内 MCP 安装指南），或允许 agent 使用fetch_webpage作为兜底取数方式 - 无需重启，触发方式为直接向 agent 提出 Azure VM 故障排查、架构设计、配置或部署相关问题，agent 会依据 SKILL.md 的分类索引自动定位主文件或对应参考文件并抓取官方文档作答
11. 注意事项
- 该技能高度依赖网络访问，离线环境下无法拉取远程文档正文，只能看到本地索引
- 若长期未见更新（
generated_at超过 3 个月），SKILL.md 正文会提示用户拉取仓库最新版本，注意留意该提示 - 内容聚焦 VM 本身，若涉及数据科学 VM、大型实例、SQL Server on VM 或 VM 规模集等相邻场景，SKILL.md 已明确指引改用对应专项技能，避免误用