用途:监控分支或拉取请求的 CI 检查,持续修复失败,直到所有必需检查通过。它强调以 gh pr checks 作为 PR 关联检查的事实来源,因为该命令覆盖所有 PR 关联检查,而 gh run list 只覆盖 GitHub Actions。
主要能力与工作流:先解析当前分支对应的 PR;在等待前先检查当前 PR 检查状态;若检查已失败,优先诊断这些失败;若检查仍在等待,则用 gh pr checks --watch --fail-fast 进行监视;每次推送后重新检查完整的 PR 检查集合并重复,直到全部变绿。
常用命令: gh pr view --json number,url,headRefName gh pr checks --json name,bucket,state,workflow,link gh pr checks --watch --fail-fast gh run view <run-id> --log-failed
约束与限制:尽量让每次修复只针对单一失败原因;不要用 --no-verify 绕过钩子强行推进;若失败明显与 PR 无关且 main 上似乎已修复,应合并最新 main,而不是把无关修复塞进 PR;若失败是偶发性的,重试一次并报告偶发证据;每次推送后都要重新运行 gh pr checks --json name,bucket,state,workflow,link,因为检查集合可能变化。
输出:当前 CI 状态、失败摘要与已应用的修复、检查变绿后的 PR URL。
适用场景:需要盯着 PR 检查并反复迭代修复 CI 失败的开发流程。限制:资料未提供安装方式、收费、价格、支持平台等更多信息。