该技能用于监控分支或拉取请求的 CI 检查,并迭代修复失败,直到所有必需检查通过(变绿)。
用途
当需要观察某个分支或 PR 并针对 CI 失败反复调整时使用。它以 gh pr checks 作为事实来源,因为它包含所有附加到 PR 的检查,而 gh run list 只覆盖 GitHub Actions。
主要能力
- 解析当前分支对应的 PR。
- 在等待前先检查当前 PR 的检查状态。
- 若检查已经失败,优先诊断这些失败。
- 若检查处于待定状态,使用 gh pr checks --watch --fail-fast 进行监视。
- 每次推送后重新检查完整的 PR 检查集合,并重复直到全部通过。
使用方式
技能提供以下命令:
解析当前活动的 PR
gh pr view --json number,url,headRefName
检查所有附加的检查
gh pr checks --json name,bucket,state,workflow,link
监视待定检查并快速失败
gh pr checks --watch --fail-fast
当失败检查链接到 GHA 运行时,查看 GitHub Actions 日志
gh run view <run-id> --log-failed
适用场景
适用于需要持续跟踪 PR 检查状态、修复 CI 失败并确认所有必需检查通过的开发工作流。
限制与边界
技能强调将仓库审查、本地编辑、推送分支、创建或更新 PR、合并视为不同效果。需验证目标仓库与当前用户授权,针对每个外部写入操作分别确认。若尚未获得推送或 PR 发布授权,应完成本地分支、差异、检查和草稿 PR 文本,使批准成为最后一步。除非单独请求,否则不要合并。
护栏
- 尽量将每次修复限定于单一失败原因。
- 不要使用 --no-verify 绕过钩子来强行推进。
- 若失败明显与 PR 无关且看起来已在主分支上修复,则合并最新主分支,而不是用无关修复使 PR 膨胀。
- 若失败为偶发,重试一次并报告偶发证据。
- 每次推送后重新运行 gh pr checks --json name,bucket,state,workflow,link,因为检查集合可能发生变化。
输出
- 当前 CI 状态
- 失败摘要与已应用的修复
- 检查变绿后的 PR URL