用途:在还没有 Pull Request 的情况下,用有界循环把本地分支推进到干净状态。循环为审查 → 应用 → 简化 → 复审,发现保存在本地 .agent/{branch}/findings.jsonl,不涉及 GitHub。适用场景:自己的分支、提交 PR 前、离线迭代。
主要能力:
- 每轮先分派 branch-reviewer 子代理,对整个比较范围审查,发现以指纹记录在本地总线文件中,避免重复报告。
- 其次在当前上下文应用发现:按严重度从高到低,每处发现单独提交,可标记 applied、declined(附理由)或 flagged。
- 然后可选执行 Skill("polish", "simplify") 简化,并运行仓库自身的快速检查作为本地绿色门槛。
- 默认迭代上限 5 次;收敛条件为无新发现、无未解决发现且检查通过。
必要用法:常与上游 create-pr 的推送前步骤配合,也可单独用于 PR 前审查。关键参数包括 --base <ref>、--head <ref>、--cap N、--effort high、--no-simplify、--no-checks、--report、--include-untracked。分派 branch-reviewer 必须使用运行器的子代理分派工具,能力名可能为 Task 或 Agent,但绝不能使用 Skill("branch-reviewer", …)。若无法分派子代理,应跳过而非回退为自审。
限制:本技能不允许任何 GitHub 调用;发现只能通过已落地的修复或写明理由离开 open 状态,不允许删除或为凑零而关闭;flagged 必须报告;空 diff 不算通过;上限是硬限制,不得静默延长;一旦 PR 存在,收敛职责转交 review-loop。