---
name: "review-routes"
description: "评审已有合成路线的拓扑、逐步反应先例、库存声明和证据缺口。用于比较 AiZynthFinder、PaRoutes 或结构化多步路线并生成专家复核队列。"
---

# 合成路线证据评审

## 能力

对已有合成路线执行确定性、非生成式证据评审：

- 读取 normalized route、AiZynthFinder JSON 或 PaRoutes v2 JSON；
- 校验单根、连通、无环的 `mol → reaction → mol` 交替路线树；
- 规范化 target、intermediate、terminal precursor 和每个单步反应；
- 用 route/step hash 和 `curation_record_id` 精确绑定
  `curate-reactions` Artifact；
- 独立验证 `search-reactions` v1.1 Artifact，并按 lookup、transformation、
  similarity 或 component query 核对当前 step；
- 传播 rejected、review、zero hit、timeout、source error 和 license 缺口；
- 检查库存快照、显式项目约束和重复路线；
- 分维度展示路线，不生成隐藏综合分数；
- 输出 weakest steps 和专家 review queue。

适用于：

- “检查这几条逆合成路线各有什么证据缺口”；
- “比较 AiZynthFinder 输出的几条路线”；
- “逐步检查路线中的反应先例”；
- “哪些路线步骤只有相似反应，没有精确先例”；
- “检查路线前体库存声明和来源许可”。

## 执行流程

1. 确认输入是已有路线 JSON，不接收 pickle，不调用路线生成模型。
2. 显式确认 `input_profile`、来源 SHA-256 和 `routes_fingerprint`。
3. 验证路线树并生成稳定 `route_signature/step_reaction_hash`。
4. 如提供第五、第六 Skill artifact，分别执行 curate record 精确绑定和 Search
   query/result step binding，禁止按数组位置、任意 result mode 或自报 hash
   猜测。
5. 运行：

```bash
python scripts/review_routes.py \
  --input route-review-request.json \
  --output route-review.json
```

6. 校验：

```bash
python scripts/validate_output.py route-review.json
```

7. 报告路线 disposition、逐步 evidence level、库存/许可缺口、显式约束和
   review queue。

## 支持的输入 Profile

```text
normalized_route_v1
aizynthfinder_json
paroutes_v2_json
```

首版最多 20 条路线、每条最多 50 步、总节点最多 5000。

## 强制边界

- 固定 `rdkit==2025.9.2`；
- 核心不依赖 AiZynthFinder、Syntheseus、OpenAI4S 或模型权重；
- 只读取 JSON，禁止 pickle 或可执行反序列化；
- 不生成、补全或自动修复路线；
- 不运行 forward/round-trip、可行性、条件、yield 或安全模型；
- backend rank/score 原样保留，不跨 backend 归一化；
- exact、transformation、similar、component、zero hit 和 provider failure
  必须分开；
- 条件和产率仅为来源报告证据，不自动迁移到目标步骤；
- 库存必须关联快照；route export 的 `in_stock` 只标记为来源报告；
- 缺失许可保持 `null`，不得猜测；
- 缺失 curation evidence 必须进入 `partial/review_required`，不得解释为 ready；
- 无效 curation Artifact、ID 或 hash 只 blocked 对应路线，禁止整批隐式失败；
- 缺失 Search evidence 进入 `partial/review_required`；无效、错 step 或 blocked
  Search Artifact 只 blocked 对应路线；
- match level 只由 Search operation 推导，similar/component 不得升级为 exact；
- 不删除重复路线，只分组；
- 默认只输出 `dimensions_only`，不计算综合总分；
- `ready_for_expert_review` 仅表示证据包可交给专家，不表示路线可行、安全、
  最优、可放大或可直接实验；
- 不访问网络，不调用商业库存、路线生成器或远程反应数据库。

## 与其他 Skill 的关系

```text
curate-reactions
单步反应结构、角色、产率和质量状态
        ↓
search-reactions
单步先例、相似度、条件、产率、来源和许可
        ↓
review-routes
多步拓扑、逐步证据覆盖、最弱步骤和专家复核队列
```

完整输入输出、状态、规则和科学边界见
`references/输入输出与科学边界.md`；curate v1.1 的精确绑定规则见
`references/CurateArtifact消费合同.md`；Search v1.1 的 query/result 绑定见
`references/SearchArtifact消费合同.md`。