用途:req-code-review 用于在完成较大实现任务后、合并到主分支前、完成重构或跨模块改动后、修复复杂问题后,以及需要判断实现是否满足方案与验收要求时,发起面向落地质量的系统性代码审查。它强调审查必须基于需求与设计证据,而非只看代码表面。
主要能力与规则:先定义审查语义输入,再映射到文件、分支、提交范围或目录;先读取实现方案,再看其他材料与代码。审查角色按项目情况动态定义,须覆盖设计一致性、正确性、可维护性、测试与上线风险。必须使用 SubAgent 发起审查,中大型任务默认并行 3 到 5 个,小型任务至少 2 个;主代理负责归并结论、去重与落盘。只输出有证据的问题,每条给出影响、严重级别、定位和可执行建议;最终结果保存为 Markdown 文件。
发起时需补齐三类输入:implementation_plan(本次实现依据)、output_dir(输出目录)、other(设计文档、验收标准、历史审查记录、代码目录、分支、提交范围等)。若未给代码范围,优先从当前分支或最近一次完整改动推断;若未指定输出目录,按已存在的审查输出目录、通用文档目录下的 reviews/、./docs/reviews/ 的顺序推断。若缺少实现方案,默认停止正式审查并提示补充;只有用户明确接受基于现状代码的轻量审查时才继续。
流程:整理审查上下文,建立证据链并输出审查基线摘要;动态定义审查角色;用 SubAgent 并行审查,每个 SubAgent 只拿到角色定义、基线摘要、必要文档与代码范围及输出格式要求;主代理合并去重、统一严重级别并按类别归组,对照历史审查记录标注重复、已解决和新引入问题。最终报告结构固定,包含总体评价、详细问题列表、与历史审查对比、风险评估、整改 Checklist 和建议改进。若目录不存在先创建,写入失败则在会话中输出完整报告并说明原因。
限制:资料未提供具体安装命令、收费信息或支持的平台。没有实现方案时默认不进行完整审查;代码范围无法推断时先输出待确认范围,暂不启动 SubAgent。审查范围过大时应说明覆盖与未覆盖范围,避免制造已全量审查的假象。