用途:在 run-plan 执行完成后,独立验证实现是否与计划一致。审查者与执行者不共享任何信息,判断依据只有计划文件路径与代码库当前状态,不接收执行日志、worker 输出、diff、任务完成摘要或会话历史。
主要能力:直接读取磁盘上的计划文档,提取目标、范围、任务列表与验收标准、文件结构映射、提交结构、测试命令;逐项检查计划指定文件是否存在、内容是否符合要求;逐项判定每条验收标准是否满足;自行运行计划中所有测试命令及完整测试套件以检查回归;比对实际 git 日志与计划提交结构(仅作信息记录);输出 PASS 或 FAIL 的二元判定,结果取所有条件的 AND,不设条件通过或部分通过。
使用方式:唯一输入为计划文件路径,如 docs/engineering-discipline/plans/YYYY-MM-DD-<feature-name>.md。审查文档保存至 docs/engineering-discipline/reviews/YYYY-MM-DD-<feature-name>-review.md(用户偏好可覆盖默认位置),包含文件检查、测试结果、验收标准、建议性发现、总体评估与后续行动。代码库仅读不改,发现问题只报告不修复。
适用场景:run-plan 执行完毕之后;用户要求“review the work”“verify the implementation”“check if the plan was executed correctly”;实现已完成但需独立验证时。
限制:run-plan 进行中、没有计划文档、或目标是通用代码审查时不适用。计划文件缺失或不可读、测试环境未就绪、计划格式无法解析时应停止并告知用户。占位符、调试代码、提交信息不匹配、风格问题仅作为建议性发现,不影响判定,除非其导致验收标准失败。计划修订日志中相对目标削弱标准的修订本身应判为 FAIL。计划文档不完整或格式异常时的具体解析规则暂未提供。