用途:审查当前工作区改动(默认)、暂存改动、分支间或提交区间差异,覆盖代码、文档、配置、基础设施等非代码产物,找出正确性缺陷、遗漏更新、过期文档与约定漂移。
主要能力:以报告驱动,所有发现写入 plans/reports/code-review-{date}-{slug}.md 并附 file:line 证据;禁止臆测,需 grep 3 个以上既有示例确认约定;检查 DRY、YAGNI/KISS 与正确性缺陷;代码变更时执行易改性与简化门禁,行为变更时执行集成测试覆盖门禁(每个行为变更需有覆盖测试与规格 TC);交叉核对相关文档、测试规格与 README。
使用方式:按阶段执行——Phase 0 影响范围(存在 .code-graph/graph.db 时先调用 $graph-blast-radius)、变更类型、计划合规、表面检测;Phase 1 用 git status、git diff、git diff --cached 收集差异并建报告;分支对比用 git diff <base>...<head> 与 git diff --name-only <base>...<head>;提交区间用 git diff <base>..<head>。随后逐文件审查、最终汇总、文档分诊。独立模式下发现需经 $why-review --validate-findings 验证后再修复,并从 Phase 0 重新全量复审,直至整轮零发现;收敛后必须运行 $docs-update。在 $workflow-review-changes 内则在报告后停止,由父流程负责验证与文档更新。
适用场景:提交前或交接前的差异审查、分支对比、行为变更的测试与规格同步检查。
限制:需具备 git 与项目文档结构;缺失或过期的项目配置、文档索引、lessons.md 等需先运行 $project-init 或相应初始化路由;Codex 镜像或 AGENTS.md 缺失时需用户运行 $sync-codex,不自动执行;若某步骤或工具在当前环境无法运行,应停止并询问用户。具体收费、平台支持等信息暂未提供。