review-design-contracts

审查设计契约

在不进行模型投票或以 LLM 充当裁判的情况下，优先保证质量地审查设计。审查全程保持目标文档不变。

在 review.config.json 中仅使用 low 或 high 配置子代理推理强度：明确且范围小的检查用 low，复杂的契约或架构推理用 high。保持派发的任务描述不变。

选择一种操作

严格从用户明确请求中选择一种模式，不能隐式切换：

• review：启动新的设计审查，且不修改目标。
• apply-fixes：验证并处理已接受队列、编辑目标，然后停止并交给独立审查任务。
• verify-fixes：独立审查已编辑目标。只有当前任务被明确要求运行 verify-fixes 且未编辑该目标时才能进入。

完成 apply-fixes 绝不授权同一任务进入 verify-fixes，即使已提供队列运行目录也是如此。

开始审查

1. 阅读 references/review-protocol.md。
2. 确认当前 Codex 任务提供 Native spawn_agent、wait_agent 和 interrupt_agent。任一不可用时，在创建运行前停止；不要退回到 CLI 或 API 模型后端。
3. 将 <skill-directory> 解析为包含此 SKILL.md 的绝对目录。
4. 执行 references/review-protocol.md 中的权威预检查。先检查目标的 frontmatter 和直接设计链接。目标自称子设计，或委派了没有可解析路径的重要契约时，只做该文档所述的、有界的同目录和已声明索引搜索。直接关系支持的、明确且非 observed 的总设计自动纳入；否则除非未解决的外部契约对审查很重要，否则把目标视作自包含。此预检查不得调用其他技能。
5. 检查目标仓库的 docs/REPO_MAP.md 和 docs/ARCHITECTURE.md。任一缺失时，以仓库上下文初始化模式调用 $repo-map-first；相关地图说法可能过时或矛盾时，以仓库上下文验证模式调用它。保留审查目标和权威来源。观察到的地图可定位文件，但不能确立规范性权威。架构审查所需仓库上下文仍有重要歧义时，创建运行前停止并报告 INSUFFICIENT_INPUT。
6. 在仓库根目录运行：

node <skill-directory>/scripts/review-design.mjs prepare <design.md>

用户指定的权威项重复使用 --authority <path> 添加；预检查找到的每个明确权威项重复使用 --discovered-authority <path> 添加。不要将后者用于 observed 文档，也不要用于仅凭相邻位置、编号、时间顺序或语义相似性推断的关系。用 --retry-of <old-run-directory> 重试 FAILED 或 INVALIDATED 运行；绝不复用旧中间产物。

1. 对 prepare 或 advance 返回的每个任务描述，使用以下精确映射调用 Native spawn_agent：

task_name        ← agent_task_name
message          ← spawn_message
fork_turns       ← fork_turns
model            ← model
reasoning_effort ← reasoning_effort

不得修改任何映射值。一个返回批次可以同时包含 L2 和互不依赖的 L3 任务；每个覆盖一个候选项或一组有界的相关候选项，分别派发。每批任务数不得超过 max_parallel_subagents。

1. 等待已派发任务，不要解读其最终消息。遵循 references/review-protocol.md 的超时和迟到响应协调规则；只有指定 response.json 存在时任务才成功。一个或多个活跃任务生成响应时运行 advance；Runner 会处理完成工作、保留未完成的同级任务，并为每个空闲槽生成替代项：

node <skill-directory>/scripts/review-design.mjs advance <run-directory>

派发所有返回的重试或下一阶段描述，并持续等待它们和 waiting_for 中的 ID；不得随意等待整个批次屏障，也不得手动合并任务响应。