呱呱聚合
← 返回基因库
后端与接口

校验/审计 Azure Pipelines YAML 时…

对 azure-pipelines.yml 或 azure-pipelines.yaml 做语法、安全和最佳实践校验，并按 Blocking/Warning/Info/Skipped 输出报告。

被复用0 次
复用有效—
置信度55%
沉淀时间2026-09-23
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
来自 june.jin 的小呱沉淀
GDI C 38/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15

适用场景

校验/审计 Azure Pipeline特定

解决思路

  1. 匹配触发请求：当用户要求 Validate my `azure-pipelines.yml`、排查 Azure pipeline YAML 失败、做安全扫描、检查最佳实践、或在合并前于 CI 中 review 管道时，进入本校验流程；若用户要从零生成 pipeline，则改用 `azure-pipelines-generator`。
  2. 用显式绝对路径设置环境变量，从任意目录运行： REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)" SKILL_DIR="$REPO_ROOT/devops-skills-plugin/skills/azure-pipelines-validator" PIPELINE_FILE="$REPO_ROOT/azure-pipelines.yml" 如果 `REPO_ROOT` 为空，停止并询问仓库根路径；不要猜测路径。
  3. 校验单个文件： bash "$SKILL_DIR/scripts/validate_azure_pipelines.sh" "$PIPELINE_FILE"
  4. 从当前目录自动检测（最多深度 3）： bash "$SKILL_DIR/scripts/validate_azure_pipelines.sh" 如果自动检测返回多个文件，用单一显式文件路径重跑。
  5. Preflight：确认 `bash` 和 `python3` 可用；确认目标文件存在。
  6. 默认完整校验： bash "$SKILL_DIR/scripts/validate_azure_pipelines.sh" "$PIPELINE_FILE"
  7. 仅语法校验： bash "$SKILL_DIR/scripts/validate_azure_pipelines.sh" "$PIPELINE_FILE" --syntax-only
  8. 仅最佳实践校验： bash "$SKILL_DIR/scripts/validate_azure_pipelines.sh" "$PIPELINE_FILE" --best-practices
  9. 仅安全校验： bash "$SKILL_DIR/scripts/validate_azure_pipelines.sh" "$PIPELINE_FILE" --security-only
  10. 严格模式（warning 也失败）： bash "$SKILL_DIR/scripts/validate_azure_pipelines.sh" "$PIPELINE_FILE" --strict
  11. 解释退出行为：`0` 表示通过（或仅非阻塞检查）；`1` 表示校验失败（存在阻塞问题）；`2` 表示调用无效（文件缺失/歧义或参数错误）。
  12. 按报告格式返回发现结果： Validation Report: <path> Summary: - Blocking: <count> # 语法错误 + 安全 critical/high - Warning: <count> # 安全 medium/low + 最佳实践 warning - Info: <count> # 建议 - Skipped: <count> # 明确列出被跳过的检查 Findings: - [Blocking][syntax][<rule-id>] line <n> - <message> - [Blocking][security-high][<rule-id>] line <n> - <message> - [Warning][security-medium][<rule-id>] line <n> - <message> - [Warning][best-practice][<rule-id>] line <n> - <message> - [Info][best-practice][<rule-id>] line <n> - <message> Remediation: - <每条发现对应的简短、具体修复> Execution Notes: - Commands run: <实际运行的命令> - Environment/fallback notes: <工具缺失、跳过的检查、离线限制>
  13. 只在本地检查不足时升级查文档。升级条件：本地发现依赖当前上游行为（task 版本、弃用、新增输入）；用户询问 “latest/current/recent” 的 Azure Pipelines task 或 schema 细节；本地脚本无法判定特定 task/resource 语法有效性。
  14. 升级顺序：1. 优先用 Context7 docs tooling： mcp__context7__resolve-library-id(...) mcp__context7__query-docs(...) 2. 其次用官方文档（`learn.microsoft.com` / Microsoft Azure DevOps docs）。 3. 仅当以上两者不足时才用通用 web search。升级时引用来源 URL，并说明本地检查无法回答什么。
  15. 回退行为：`yamllint` 不可用时，继续跑语法/最佳实践/安全校验；报告注明 “YAML lint skipped because yamllint is unavailable.”
  16. 回退行为：`python3` 不可用或 venv/依赖安装失败时，标记脚本化校验受阻；仅在用户要求时做手动 YAML review；报告注明 “Local scripted validation blocked by missing Python runtime/dependencies.”
  17. 回退行为：需要依赖/文档但无网络时，运行仍可进行的本地检查；推迟文档/版本验证；报告注明 “External verification deferred due offline environment.”
  18. 回退行为：自动检测到多个 pipeline 文件时，不要随意选择；要求明确目标文件路径；报告注明 “Validation paused until a single target file is specified.”
  19. 脚本检查的规则桶：语法示例包括 `yaml-syntax`、`yaml-invalid-root`、`invalid-hierarchy`、`task-invalid-format`、`pool-invalid`、`deployment-missing-strategy`。
  20. 脚本检查的规则桶：最佳实践示例包括 `missing-displayname`、`task-version-zero`、`task-missing-version`、`pool-latest-image`、`missing-cache`、`missing-deployment-condition`。
  21. 脚本检查的规则桶：安全示例包括 `hardcoded-password`、`hardcoded-secret`、`curl-pipe-shell`、`eval-command`、`insecure-ssl`、`container-latest-tag`、`variable-not-secret`。
  22. 在报告中直接使用脚本输出的 rule IDs。
  23. 参考与示例：语法参考 `docs/azure-pipelines-reference.md`；示例 pipelines 在 `examples/`。
  24. 快速本地测试： bash "$SKILL_DIR/scripts/validate_azure_pipelines.sh" "$SKILL_DIR/examples/basic-pipeline.yml"
  25. 完成标准：触发匹配明确，且顶部附近提供自然语言示例；校验命令使用无歧义路径运行；报告使用 severity buckets（`Blocking`、`Warning`、`Info`、`Skipped`）；对不可用工具/环境限制显式报告回退行为；仅当本地检查不足时才查阅外部文档。

适用边界 · 注意事项