用途:dev-review 用于对实现进行单遍代码审查,结合规格符合性与质量检查,并通过置信度过滤只报告高优先级问题。触发条件为用户要求“审查代码”“检查实现质量”或“运行代码审查”。
主要能力:支持多种审查策略。默认在检测到 Codex 已安装并认证时使用 Codex 对抗式审查(不同模型家族,捕获 Claude 自审遗漏的问题);否则回退到单 Claude 审查者或并行 Claude 审查(3 个专门审查者:安全、性能、测试)。审查前强制要求测试证据:LEARNINGS.md 中必须包含实际测试输出(PASS/OK/SUCCESS 等),用户可见变更还需 E2E 证据,否则返回 BLOCKED。审查结果按置信度过滤,仅置信度 ≥ 0.8 的问题阻断。
使用方式:先检查上下文余量,正常(>35%)继续,警告(25-35%)完成当前步骤后调用 dev-handoff,严重(≤25%)立即调用 dev-handoff。加载约束后,重新读取 .planning/SPEC.md 和 .planning/PLAN.md。通过 rg -E "(PASS|OK|SUCCESS|\d+ passed)" .planning/LEARNINGS.md 检查测试输出。探测 Codex 可用性后询问用户选择审查策略。Codex 路径使用 node "$CODEX_SCRIPT" adversarial-review --wait 或后台运行。并行路径需 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 启用,创建团队并生成 3 个只读审查者,使用 review-package.sh 生成共享 diff 包,审查者仅允许 Read、Glob、Grep、Bash(read-only)。
适用场景:安全敏感变更、性能关键路径、测试密集型 PR、复杂 PR(4+ 文件)、高风险部署。不适用于简单修复(<50 LOC 单文件)、文档或配置变更、自动重构、内部工具。
限制:审查前必须有测试证据,否则阻断;用户可见变更缺少 E2E 证据不可批准;并行审查需实验性功能启用;Codex 不可用时静默回退,不提示安装;审查循环通过 REVIEW_STATE.md 管理,偏离主题需先暂停并声明,再恢复。