用途:在 Codex 或 Claude Code 创建 PR(含草稿 PR)后,或需要继续推进智能体创建的 PR 通过 CI、评审评论、修复提交直至合并时使用。草稿 PR 被手动转为 ready 后也应立即进入轮询流程。若仓库工作流要求创建草稿 PR,且实现已通过本地验证,应在同一会话标记 ready 并开始轮询。
主要能力:通过 gh 处理 GitHub I/O;轮询 PR 状态、检查、失败日志、评论、标签与合并;在原有 worktree 中修复 CI 失败与评审发现;用日语回复每条评审评论;最多 4 次修复循环;仅在机器人评审完成且必需检查通过时自动合并,使用 squash merge;合并后清理 worktree。
使用方式:创建 PR 后记录编号与 head SHA,若 isDraft 为 true 且可评审则运行 gh pr ready "$PR",随后每 3 分钟轮询一次,最多 20 分钟。用 gh pr view、gh pr checks、gh api --paginate 获取状态与评论;Codex 评审以内联评论形式出现,需单独用 pulls/$PR/comments 端点获取,P1/P2 为阻塞项。修复后运行仓库常规验证(如测试、Ruff、mypy)再推送。合并命令为 gh pr merge "$PR" --squash --auto --delete-branch --match-head-commit "$HEAD_SHA"。
限制:不使用 @codex fix 或评论驱动的修复命令;不自动解决评审线程;空评论集视为评审未完成;20 分钟内无机器人评审则评论后停止不合并;自动修复不允许改 .github/workflows、权限、密钥、直接推 main 或重写历史;第 4 次修复仍失败或出现设计级问题则升级并停止合并。会话状态不持久化,会话丢失即停止。