用途:调试并修复失败的 GitHub PR 检查,适用于 GitHub Actions 检查失败、PR 状态检查损坏,或需要在本地复现排查的场景。
使用方式:先验证 gh auth status;若未认证,需让用户运行 gh auth login。通过 gh pr view --json number,url 或 $ARGUMENTS 识别 PR;若当前分支无 PR 且未给编号,应停止并请用户指定。若可用,探索步骤优先使用 rtk gh ...、rtk read 和 rtk grep;当其他命令需要机器可读 JSON 或未压缩日志时,改用原始 gh 或附带脚本。
主要能力:运行 python "<skill-dir>/scripts/inspect_pr_checks.py" --repo "." [--pr "$ARGUMENTS"] --json 收集失败检查、日志片段与本地复现提示。若脚本非零退出,回退到 references/BACKGROUND.md 中的手动流程。
结果分支:全部通过则报告 all checks green 并停止;仍在进行则报告运行中的检查并建议等待,或检查已失败项;仅外部提供方失败(如 Buildkite)则报告 URL 并标记为超出范围,除非用户明确要求;存在 GitHub Actions 失败则继续。总结失败需包含检查名称、最小的有用日志片段(上限 50 行,超出只提取错误块)及建议的本地复现命令。提出简洁修复计划,若用户仅要求诊断,需获得明确批准后再修改;否则继续修复。实施已批准修复并重跑相关本地复现命令。若本地复现仍失败,诊断新错误并迭代,最多重试 2 次,然后报告。本地成功后重新运行 gh pr checks 确认。
限制:依赖 GitHub CLI 与认证,外部提供方检查默认不在范围内;脚本失败时需转手动流程。