🔍 它到底是什么

azure-validate 是微软 Azure Skills 套件里的部署验证技能包。它和 azure-prepare（生成计划）、azure-deploy（执行部署）组成了完整的部署工作流——azure-validate 是三步曲里的中间环节，负责在部署之前对计划做全面检查。

装了这个技能包之后，你的 AI 助手（GitHub Copilot、Claude Code、Cursor 等）就拥有了自动审查 Azure 部署计划的能力。你只需要对 AI 说“帮我验证一下当前部署计划”，它就会读取 .azure/plan.md 文件，从语法、权限、配额、成本等多个维度进行校验，并给出详细的验证报告。

这个技能最大的价值在于把隐患消灭在部署之前。很多线上故障其实都是因为部署前的检查没做足——比如权限不够导致创建失败、配额不足导致资源申请被拒、配置错误导致服务启动不了。azure-validate 让 AI 帮你把这些坑提前踩一遍，确保计划没问题了再执行部署。

⚙️ 主要功能：AI 能帮你做什么

📋 部署计划语法与结构校验

azure-validate 会检查 .azure/plan.md 文件的格式是否正确、字段是否完整、依赖关系是否合理。比如：

  • 计划文件是否包含必要的资源清单
  • 资源之间的依赖顺序是否合理（比如数据库要先于应用创建）
  • 参数类型和值是否合法
  • 部署策略（azd/Bicep/Terraform/CLI）是否明确

🔐 权限与访问控制检查

技能包会模拟执行部署所需的权限，检查当前登录的 Azure 账号或服务主体是否具备：

  • 对应资源提供者（如 Microsoft.Web、Microsoft.ContainerService）的注册状态
  • 目标资源组或订阅的写入权限
  • 密钥保管库、网络等依赖资源的访问权限
  • 如果使用托管标识，检查标识是否已正确分配

📊 配额与容量验证

Azure 订阅对每种资源类型都有配额限制。azure-validate 会调用 Azure 配额 API，检查当前订阅的剩余配额是否足以创建计划中的资源。比如：

  • 虚拟机的 vCPU 配额
  • 存储账户数量限制
  • 容器实例的 CPU/内存配额
  • 区域特定的资源可用性

如果配额不足，AI 会明确提示你申请提额或调整资源规格。

💰 成本估算与预算预警

验证过程中，技能包会调用 Azure 定价 API，根据计划中定义的资源类型、规格、区域、使用时长等因素，生成一份预估成本报告。你可以提前知道这次部署大概要花多少钱，避免月底收到意外账单。如果成本超出你预设的预算阈值，AI 也会发出警告。

🧪 部署前“干跑”测试（What-if）

对于 Bicep 和 Terraform 部署，azure-validate 支持执行 what-if 操作——模拟部署过程，但不实际创建资源。它会告诉你：哪些资源会被新建、哪些会被更新、哪些会被删除，以及变更的影响范围。这让你对部署的“副作用”心里有数。

📝 生成详细验证报告

所有检查项完成后，AI 会生成一份结构化的验证报告，内容包括：

  • 总体验证状态（通过 / 警告 / 失败）
  • 每个检查项的详细结果
  • 存在的问题及修复建议
  • 预估成本和配额使用情况

报告会追加到 .azure/plan.md 文件中，或者单独生成一个 .azure/validation-report.md 文件，方便你和团队审阅。

📥 第一次怎么安装

提前准备好这几样东西：

  • 一个 Azure 订阅（免费账号就可以）
  • Azure CLI（v2.60.0及以上），并已用 az login 登录
  • Git 和 Node.js（Azure MCP 服务器依赖）
  • 一个支持 MCP（模型上下文协议）的 AI 编程环境
  • 最关键的前提：你的项目里已经有一个 .azure/plan.md 部署计划文件（可以用 azure-prepare 技能包生成）

安装方式一：命令行安装（通用）

npx skills add https://github.com/microsoft/github-copilot-for-azure --skill azure-validate

在终端执行这条命令，技能包就会自动下载并配置到你的 AI 编程环境中。

安装方式二：VS Code 用户（推荐）

在 VS Code 扩展市场搜索 GitHub Copilot for Azure 并安装。扩展安装后，azure-validate 等 Azure 技能会自动安装。如果没自动装，可以在命令面板（Ctrl+Shift+P）执行：

  • @azure: Install Azure Skills Globally（全局安装）
  • @azure: Install Azure Skills Locally（当前工作区）

安装方式三：Claude Code 用户

在 Claude Code 会话中执行：

/plugin marketplace add microsoft/azure-skills
/plugin install azure@azure-skills

装完之后不需要额外配置，技能会自动生效。只要项目里有 .azure/plan.md，AI 就会在需要时自动调用验证能力。

🎯 主要应用场景

🚦 部署前必经安检

任何一次生产环境部署之前，都应该先跑一遍 azure-validate。它像机场安检一样，帮你筛查出权限不足、配额不够、语法错误等问题，避免部署到一半失败导致服务中断。

💰 成本管控与预算审批

在财务审批环节，团队管理者往往需要知道每次部署大概花多少钱。azure-validate 自动生成的成本估算报告，让预算审批有据可依，也能帮助开发人员优化资源配置，控制云成本。

🧑‍🤝‍🧑 团队协作与代码审查

多人协作时，部署计划的变更可能影响其他人。azure-validate 生成的验证报告可以作为部署评审的一部分，让所有团队成员清楚看到即将发生的资源变更和潜在风险。

🔄 CI/CD 流水线集成

在 GitHub Actions 或 Azure DevOps 的 CI 流水线中加入 azure-validate 步骤，可以在合并代码之前自动验证部署计划。如果验证失败，流水线直接中断，避免有问题的计划被部署到任何环境。

🧠 新手学习与辅导

对于刚接触 Azure 部署的开发者，azure-validate 不仅指出问题，还会给出修复建议。它像一个耐心的师傅，边检查边教学，帮助新人快速掌握部署规范。

💡 使用案例

案例一：首次部署前的全面验证

你用 azure-prepare 生成了第一个完整的部署计划，准备上线生产环境。在真正执行前，你在 AI 助手里输入：“验证我的部署计划，检查所有权限和配额”。azure-validate 会扫描整个计划，发现你的订阅在目标区域没有足够的 vCPU 配额来创建虚拟机。AI 会提示你申请配额，并给出申请链接和操作步骤。你处理完配额问题后再验证一遍，直到所有检查项通过，才放心执行部署。

案例二：成本超预算预警

你的团队有一个每月云花费预算。在每次生成新部署计划后，你都会让 azure-validate 做成本估算。一次验证中，AI 报告新计划每月成本将比当前环境高出 30%，并指出是由于你配置了更高规格的数据库。你根据报告调整了数据库规格，成本降回预算之内，避免了一次月底账单惊吓。

案例三：多环境验证差异

你的项目有开发、测试、生产三套环境，每套环境的计划文件略有不同。在部署到生产前，你让 AI 分别验证三个计划文件，并对比结果。azure-validate 发现生产环境计划中引用的 Key Vault 在目标订阅中不存在，而开发和测试环境用的是另一个 Key Vault。AI 提示你修正生产计划的资源引用，避免部署时因找不到密钥而失败。

案例四：CI 流水线自动拦截问题计划

你在 GitHub 仓库中配置了 CI 流水线，每当有 Pull Request 修改 .azure/plan.md 文件时，流水线会自动触发 azure-validate。一次 PR 中，AI 验证失败，原因是计划里引用了一个不存在的虚拟网络子网。流水线直接标记为失败，并附上验证报告。提交者根据报告修正后重新提交，合并后部署顺利通过。这让团队避免了一次因配置错误导致的线上事故。

🧰 适合哪些 AI 工具

azure-validate 是基于 SKILL.md 标准的 Azure 技能包，支持所有主流 AI 编程助手：

  • GitHub Copilot for Azure（VS Code / Visual Studio）—— 官方集成，装扩展即用
  • VS Code + Azure MCP 扩展 —— 轻量组合，同样生效
  • Claude Code —— Anthropic 的 AI 编程助手，完美兼容
  • Cursor —— 国内开发者用得很多的 AI IDE
  • GitHub Copilot CLI —— 命令行场景下的 Copilot
  • OpenClaw / Windsurf —— 其他支持 MCP 协议的工具
  • Codex CLI / Goose —— 开源的 AI 编程命令行工具

不管你用哪款 AI 编程助手，只要它支持 MCP 协议，azure-validate 就能装上用起来。

📌 写在最后

azure-validate 是 Azure 部署三部曲中承上启下的关键环节。它不像 azure-prepare 那样负责“创意”，也不像 azure-deploy 那样负责“执行”，它负责的是确保前面做的计划是靠谱的，让后面的部署能顺利执行。

很多开发者习惯于“写完就部署”，遇到报错再回头改。这种模式在复杂环境中非常低效，甚至可能引发生产故障。azure-validate 把验证工作前置，让 AI 帮你做全面的部署前检查，把问题提前暴露出来。

对于追求稳定性和效率的团队来说，这个技能包能显著减少部署失败率、降低云成本超支风险、提升团队协作质量。装上它，让你的每次部署都多一层保障。