用途：驱动一个 GitHub PR 走完 CI、代码审查与 QA，直到可合并。它不是脚本，而是由代理充当编排循环，只使用标准 gh CLI 命令，适用于任意 GitHub 仓库。
主要能力：先发现仓库实际存在的验证层（CI、PR 审查机器人、QA 机器人），只轮询已配置的层；轮询 CI 检查、审查状态与 QA 报告；对失败进行分类（代码问题则修复，网络/基础设施等偶发问题则重跑，每个 SHA 最多重跑 3 次）；处理审查评论，回复并解决审查线程；保持 .pr/ 目录下由代码派生的产物同步；全部通过后执行 gh pr ready。
使用方式：需要已认证且有仓库权限的 gh CLI 和一个 PR 分支。先推送并创建草稿 PR（gh pr create --fill --draft），再按步骤轮询各验证层，修复后提交推送并重新请求审查，然后回到轮询。轮询节奏：CI 未完成时每 30–60 秒；CI 通过等待审查/QA 时从 60 秒指数退避至最多 1 小时，状态变化时重置。
限制：仅适用于 GitHub 仓库；仓库没有的验证层会被视为通过，不会等待不存在的层；遇到基础设施故障、权限问题或无法安全解决的歧义时停止并需要人工介入；不执行破坏性 git 命令，只在 PR 头分支工作；Windows PowerShell 等价命令见 references/windows.md。