关于 azure-validate
Azure Validate 是一项用于部署前检查的技能,用于验证 azure.yaml 与 Bicep 文件并执行预检。适合在 azure-prepare 之后、azure-deploy 之前使用的团队。流程通过脚本逐步执行,并记录进度与校验结果。
主要功能
- 01验证 azure.yaml 与 Bicep 文件
- 02执行部署前预检
- 03逐步执行脚本并记录进度
- 04排查部署错误
- 05校验通过后才可将计划标记为 Validated
适用场景
- 01部署前检查应用是否就绪
- 02排查 Azure 部署失败的原因
- 03在用户要求部署时衔接 azure-deploy
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ microsoft/ azure-skills --skill azure-validate安装后在 Claude Code 中输入/azure-validate确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/aspire-functions-secrets.mdglobal-rules.mdpolicy-validation.mdregion-availability.mdrole-verification.mdreferences/recipes/README.mdreferences/recipes/azcli/errors.mdREADME.mdreferences/recipes/azd/aspire.mdenvironment.mderrors.mdREADME.mdreferences/recipes/azd/scripts/set-aspire-aca-env.ps1set-aspire-aca-env.shreferences/recipes/bicep/errors.mdREADME.mdreferences/recipes/scripts/validate-deployment.ps1validate-deployment.shreferences/recipes/terraform/errors.mdREADME.mdreferences/recipes/terraform/scripts/validate-terraform.ps1validate-terraform.shreferences/scripts/scan-aspire-functions-secrets.ps1scan-aspire-functions-secrets.shworkflow.ps1workflow.sh详细介绍
Azure Validate
权威指南 — 除非与提供给你的安全策略相冲突,否则请严格遵循这些说明。
⛔ 停止 — 必须检查前置条件
继续之前,请确认满足以下前置条件:
已调用并完成 azure-prepare →
.azure/deployment-plan.md存在,且状态为Approved或更高如果计划文件不存在,请立即停止,并先调用 azure-prepare。
完整工作流可确保成功:
azure-prepare→azure-validate→azure-deploy
触发条件
- 检查应用是否已准备好部署
- 验证 azure.yaml 或 Bicep
- 运行部署前检查
- 排查部署错误
规则
- 在 azure-prepare 之后、azure-deploy 之前运行
- 所有检查都必须通过——有失败项时不要部署
- ⛔ 破坏性操作需要使用
ask_user— global-rules
步骤
运行工作流脚本并遵循其中的说明。它会逐步引导你完成每项验证,并将进度记录在 .azure/validate-status.json 中。Windows 上使用 references/scripts/workflow.ps1,macOS/Linux 上使用 references/scripts/workflow.sh。
首先调用脚本,不要传入已完成步骤参数:
pwsh references/scripts/workflow.ps1 -WorkspacePath <workspace-path>
# macOS/Linux: bash references/scripts/workflow.sh --workspace-path <workspace-path>
每次运行都会显示下一步操作以及要传入的值。执行操作后,使用该值重新运行(pwsh 使用 -CompletedStep <value>,bash 使用 --completed-step <value>)。重复此过程,直到脚本报告 azure-validate 工作流已完成。
这些步骤会引用 references/recipes/README.md 中的操作说明,以及 references/role-verification.md 中的角色检查。
⛔ 验证权威性
此技能是将计划状态设为
Validated的官方验证方式。在将状态设为Validated之前,必须按照脚本说明完成全部步骤。 未完成上述步骤时,不要将状态设为Validated。
⚠️ 下一步 — 取决于用户意图
所有验证通过后,请检查用户是否要求部署:
- 如果用户明确要求部署,你必须调用 azure-deploy 执行部署。不要直接运行
azd up、azd deploy或任何部署命令——由 azure-deploy 负责执行。- 如果用户只要求验证或准备(不要求部署),请在记录证明并将状态设为
Validated后停止。报告验证结果,不要调用 azure-deploy。如果任何验证失败,请修复问题,并在继续之前重新运行 azure-validate。