用途:把拉取请求上的红色 CI 检查尽快变绿,以 GitHub CI 为最终判定,尽量减少本地等待。
主要能力:根据参数确定修复范围——运行 URL/ID 只修该运行中的失败作业,作业 URL 只修该作业,PR 编号/URL 修该 PR 的全部失败检查,无参数则用对话中提到的 PR 或当前分支的 PR;不会遍历用户其他打开的 PR。用 gh run view --job <job-id> --log-failed 从日志诊断,并结合 gh pr diff <pr> --name-only 判断失败是否与本次改动相关。疑似 flaky(超时、竞态、网络或 runner 错误、基线分支上同一测试通过)时用 gh run rerun <run> --failed 重跑一次,不改代码。若修复必须触碰 CLAUDE.md 中禁止代理推送的文件(如 .github/**、go.mod、go.sum、.golangci.yml),则停止该 PR 并说明所需改动。
使用方式:用 git worktree 获取检出,避免切换用户主检出分支;只做针对性修复;运行最窄的廉价检查(如对改动包运行同一 linter、单个测试 go test ./pkg -run '^TestName$' -count=1、构建或 vet 受影响包、编译 e2e 而不跑套件);以新提交推送,提交信息为 Fix CI: <简述>,不 amend。堆叠 PR 自底向上处理,依赖分支用 --force-with-lease 推送。3 个以上独立 PR 才考虑并行子代理。推送后逐 PR 报告,并用 gh pr checks <pr> --watch --interval 30 后台观察;目标检查仍红时自动回到诊断,每个 PR 首次推送后最多 2 轮自动修复。
适用场景:需要快速修复 GitHub Actions 上 PR 的失败检查,且希望避免本地重复跑完整测试套件。
限制:不运行完整套件、不循环测试验证稳定性;不绕过禁止推送文件清单;不修复目标范围之外的检查;不处理无法解析到 PR 的情况。具体安装方式与更多配置暂未提供。