用途:当用户要求调试或修复在 GitHub Actions 中运行的失败 PR 检查时使用。通过 gh 定位失败的 PR 检查,获取 GitHub Actions 日志,总结可操作的失败片段,提出修复计划,并在获得明确批准后实施。
主要能力:验证 gh 认证;解析 PR(默认当前分支 PR,也可指定编号或 URL);检查失败的 GitHub Actions 检查;对非 GitHub Actions 的检查仅标记为外部并报告 URL;汇总失败检查名称、运行 URL 和日志片段;生成计划并在批准后实施;建议重新运行测试和 gh pr checks 确认。
使用方式:先运行 gh auth login 完成认证,并用 gh auth status 确认(通常需要 repo 和 workflow 权限)。快速开始:python "{baseDir}/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>",加 --json 可获得机器友好输出。手动回退:gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow;对每个失败检查从 detailsUrl 提取 run id,运行 gh run view <run_id> --json name,workflowName,conclusion,status,url,event,headBranch,headSha 和 gh run view <run_id> --log;若日志显示仍在进行,可用 gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" > "<path>" 获取作业日志。
适用场景:GitHub Actions 中失败的 PR 检查调试与修复。限制:不处理 Buildkite 等其他提供商;非 GitHub Actions 检查仅报告 URL;实施前必须获得明确批准;需先完成 gh 认证。