用途:在完成任务、实现主要功能或合并到主分支前,通过派发 software-forge:code-reviewer 子代理来审查代码,尽早发现问题,避免问题累积。核心原则是“尽早审查、频繁审查”。
何时请求审查:强制场景包括子代理驱动开发中每个任务完成后、完成主要功能后、合并到 main 前;可选但有价值的场景包括卡住时(获取新视角)、重构前(基线检查)、修复复杂 bug 后。
使用方式:先获取 git SHA,例如 BASE_SHA=$(git rev-parse HEAD~1) 或 origin/main,HEAD_SHA=$(git rev-parse HEAD)。然后使用 Task 工具,类型为 software-forge:code-reviewer,填写 code-reviewer.md 模板,占位符包括 {WHAT_WAS_IMPLEMENTED}、{PLAN_OR_REQUIREMENTS}、{BASE_SHA}、{HEAD_SHA}、{DESCRIPTION}。最后处理反馈:Critical 问题立即修复,Important 问题在继续前修复,Minor 问题记录待后续处理;若审查者有误,可附理由反驳。
与工作流集成:子代理驱动开发中每个任务后审查;执行计划时每批(3 个任务)后审查;临时开发则在合并前或卡住时审查。
限制与红线:不要因为“很简单”而跳过审查,不要忽略 Critical 问题,不要带着未修复的 Important 问题继续,不要与有效的技术反馈争辩。若审查者有误,应提供技术理由、代码或测试证明,或请求澄清。模板见 requesting-code-review/code-reviewer.md。