用途:在智能体通过 gh pr create 创建 PR(含流程要求的草稿 PR),或草稿 PR 转为 ready for review,或用户要求继续推进智能体 PR 的 CI、评审、修复与合并时使用。先按 pr-maintainer 执行无草稿后置条件,再进入循环;PR 可评审时不要停在 URL 上。
主要能力:有界的基于时间的轮询循环,以目标停止条件终止。每轮用 gh 采集四类状态:PR 字段(number、isDraft、headRefOid、mergeStateStatus、reviewDecision、statusCheckRollup、labels)、检查运行状态、PR issue 上的机器人 reaction(+1 为干净,eyes 为进行中)、内联评审评论。每轮必须执行全部四项检查。
循环结果:continue(CI 仍在运行、尚无 chatgpt-codex-connector[bot] reaction、CI 绿但评审未发);repair(CI 失败,或评审状态为 COMMENTED 且评论含 P1/P2 徽章,则在 PR worktree 修复、验证、推送并按 pr-maintainer 用日语回复,计入修复次数);escalate(达到修复上限、同一边界反复出现或需要禁用变更,则开设计 issue、用日语评论并停止);merge(必需检查全部通过、isDraft 为 false、机器人 +1、无未处理 P1/P2 阻塞结论,才 squash 合并并清理 worktree);timeout(轮询窗口内无终态则用日语评论并停止)。仅 mergeStateStatus=CLEAN 与空 reviewDecision 不满足合并门槛。continue 时等待轮询间隔后自动开始下一轮,不得空闲等待人工触发。
参数:轮询间隔约 3 分钟,总窗口最多 20 分钟(约 6 至 7 轮);在会话记忆中保存循环次数与最近检查的 head SHA,用 todo 记录修复次数。
等待机制因智能体而异:Claude Code 使用 ScheduleWakeup 自调度,回退为有界 bash until 循环,禁止 sleep && 下一步;Codex 使用会话内联轮询。若导入目标的 CLAUDE.md / AGENTS.md 有 wait 机制章节(如 "pr-autoloop 実装")则优先遵循,否则用默认并报告所用机制。
关系与限制:本技能只是自主循环层,不定义政策;草稿门、修复规则、修复上限(4)、日语评审回复、设计升级、合并条件、合并后 worktree 清理均来自 pr-maintainer 技能及仓库 PR 维护 ADR/策略。如有冲突,政策以 pr-maintainer 为准,本技能仅在轮询之间不停滞等待人工这一点上优先。不得将其用作通用自主编码循环;空评审/空评论集不等于干净评审,表示评审尚未完成。
未提供的价格、平台支持范围等信息暂未提供。