需要生成或重构 Azure Pipelines YAML…

当用户要求生成、搭建、重构或转换 Azure DevOps 的 azure-pipelines.yml、stages/jobs/steps 或可复用模板时使用。

适用场景

解决思路

1. 执行时按规范关键词解读：MUST 表示必需，SHOULD 表示默认除非用户另有要求，MAY 表示可选。
2. 按确定性顺序执行：1) 分类请求模式；2) 捕获最低必需输入；3) 加载最低参考（渐进披露）；4) 使用质量清单生成 YAML；5) 验证（validator 技能、脚本回退或手动回退）；6) 按必需报告格式返回输出。
3. 如果某步骤因环境限制无法运行，使用该步骤的回退并继续。
4. 分类请求模式时，只选择恰好一个主模式：Basic CI、Multi-stage CI/CD、Docker、Kubernetes、Language-specific、Template-based、Snippet-only。
5. 按模式映射选择示例：Basic CI -> examples/basic-ci.yml；Multi-stage CI/CD -> examples/multi-stage-cicd.yml；.NET -> examples/dotnet-cicd.yml；Python -> examples/python-cicd.yml；Go -> examples/go-cicd.yml；Kubernetes -> examples/kubernetes-deploy.yml；Template-based -> examples/template-usage.yml + examples/templates/*.yml。
6. 在生成前收集必需输入：应用技术栈和包管理器；构建/测试命令和报告期望；部署目标（无、Azure 服务、Docker registry、Kubernetes）；环境流（dev/staging/prod）和分支门禁；服务连接、变量组、密钥处理；模板需求（是/否）。
7. 输入缺失时使用安全默认值：CI 分支为 main、develop；生产部署分支仅 main；代理镜像使用固定版本（例如 ubuntu-22.04）；部署镜像标签使用不可变 $(Build.BuildId)，绝不部署 latest。
8. 如果关键细节缺失，在最终输出中明确说明假设。
9. 优先读取本地参考；始终读 docs/yaml-schema.md、docs/best-practices.md。
10. 按条件读取参考：选择任务/输入时读 docs/tasks-reference.md；仅模板模式读 docs/templates-guide.md。
11. 然后只读与模式映射最接近的示例。
12. 参考缺失时回退：缺少示例则使用最近模式示例并注明替换；缺少文档章节则继续使用已知约定并标记不确定性；Snippet-only 请求只读安全输出所需的最少内容。
13. 最终响应必须包括 References used、References skipped or missing、Impact。
14. 仅在需要时升级到外部文档：本地文档没有所需任务信息、任务版本兼容性不清楚、排查任务特定失败时。
15. 外部文档升级顺序：Context7（mcp__context7__resolve-library-id -> mcp__context7__query-docs）；官方文档搜索（优先 Microsoft Learn）。
16. 如果网络/工具不可用，使用本地最佳已知指南继续，并添加 residual-risk 注释。
17. 应用生成清单中的安全要求：绝不硬编码密钥；使用服务连接和变量组/密钥；使用不可变部署镜像标签。
18. 应用生成清单中的版本管理要求：将 vmImage 固定到明确版本，不用 *-latest；固定任务主版本（Task@N）；仅当任务主版本为 0 时允许 @0。
19. 应用生成清单中的可靠性要求：使用显式 dependsOn；为长时间运行作业添加 timeoutInMinutes；使用分支门禁部署 condition 规则；部署阶段使用带 environment 的 deployment jobs。
20. 应用生成清单中的性能要求：在能改善依赖安装时间时使用 Cache@2；不需要完整历史时使用浅检出；仅发布必需工件。
21. 应用生成清单中的测试/可观测性要求：在 CI 中运行 lint/测试；用 condition: succeededOrFailed() 发布测试结果；可用时发布覆盖率。
22. 应用生成清单中的可维护性要求：为 stages/jobs/关键步骤添加 displayName；逻辑重复时使用模板；仅对非显然逻辑添加简短注释。
23. 验证工作流默认路径（完整管道生成必须）：生成或更新 YAML；用 azure-pipelines-validator 验证；修复发现；重新验证直到没有阻塞问题。
24. 如果验证器技能不可用但本地验证脚本存在，使用脚本回退：bash devops-skills-plugin/skills/azure-pipelines-validator/scripts/validate_azure_pipelines.sh <pipeline-file>。
25. 当技能和脚本都无法运行时的手动回退：检查 YAML 结构/缩进健全性；检查层级健全性（stages -> jobs -> steps）；检查任务格式健全性（Task@Major）；扫描密钥暴露（无明文凭据/令牌）；扫描部署安全（environment 使用、不可变部署标签）。
26. 使用回退时最终响应必须包括：Validation status: Manual fallback；Checks performed；Residual risk。
27. 仅可跳过验证的情况：仅片段 YAML；仅文档示例；用户明确要求跳过验证。
28. 输出契约要求最终响应必须包括：1) Pipeline YAML（或模板集）；2) 必需设置：服务连接、变量组/密钥、环境和审批/检查；3) 验证结果：validator 状态、脚本状态或手动回退状态；4) 假设；5) 使用的/跳过的参考及影响；6) 可选的后续改进。
29. 规范示例流程 A（完整多阶段生成）：1) 选择模式 Multi-stage CI/CD；2) 捕获 stack/deploy/service-connection 输入；3) 读 docs/yaml-schema.md、docs/best-practices.md 和 examples/multi-stage-cicd.yml；4) 添加请求的自定义（stages、分支门禁、environments、任务）；5) 用 azure-pipelines-validator 验证；修复并重跑；6) 返回 YAML + setup + validation + assumptions + references。
30. 规范示例流程 B（快速片段生成）：1) 选择模式 Snippet-only；2) 只读所需的最少参考章节；3) 用安全默认值生成聚焦 YAML 片段；4) 跳过完整验证并声明 Validation status: Skipped (snippet-only)；5) 返回 snippet + assumptions + references。
31. 完成定义：仅当所有适用检查通过才完成：显式选择请求模式；缺失输入有明确假设；YAML 遵循清单要求（安全、版本管理、可靠性、性能、可维护性）；记录验证路径（validator、脚本回退或手动回退）；最终响应遵循输出契约，包括参考和影响。

适用边界 · 注意事项

• 仅做验证/校验的请求，应改用 azure-pipelines-validator。
• 不适用于非 Azure DevOps/Azure Pipelines 的 CI/CD 平台生成请求。