用途:对已经实现的代码进行迭代式复查与修复,不是一次性咨询式评审。仅在用户明确要求循环或迭代式实现后复查,或要求自动修复其中直接明了的问题时手动使用。
主要能力:审查已完成代码,核实发现,自动应用直接明了且安全的修复,验证后调用 phase_checkpoint_compact 完成压缩交接,再重新复查。将发现分为 Bucket I(直接明了、值得做、范围内,自动实现)与 Bucket II(涉及产品、范围、架构、兼容性或大范围重构,需用户批准,不自动实现)。默认最多 5 轮复查,可用参数覆盖;维护累计台账,最终汇报全部发现与验证结果。
必要用法:硬性依赖 Pi 扩展工具 phase_checkpoint_compact。若该工具不可用,必须在开始循环前停止,并告知用户本技能需要 phase-checkpoint-compact 扩展;不得用 /compact、软检查点、摘要或普通对话交接替代。仅在一次实现/修复与验证完成后调用,phaseCompleted 设为 impl,nextPhase 设为 post-review,之后不得继续实质工作,等待扩展的下一阶段提示。
阶段节奏:review -> impl/fix -> compact -> review……循环开始前先用 git status --short 确认范围,提交基线提交,主题为 wip(post-review-loop): baseline before review。默认不提交循环产生的修复。可选子代理评审使用全新上下文,只读不改文件。
适用场景:用户已提供可接受的实现计划时可从 impl 开始,否则从 post-review 开始;适用于已完成的变更。
限制:不得盲目应用生成或子代理的评审输出;拒绝薄弱、投机或过度复杂的建议;不得为可选打磨继续循环;同一工作树只允许一个写者;无 Bucket I 或达到轮次上限时停止并输出最终报告;未经用户明确要求不得推送、全局安装或创建非基线提交。资料未提供安装命令、价格或其他平台支持信息。