science-campaign-design

1# Campaign 设计：从研究问题到可分片的任务
2 
3## 四层拆解
4 
5```
6Campaign（一个课题的一次冲顶）
7  └─ Workstream（S0–S11 中的一段，有独立 gate）
8       └─ Task（一个可验收的交付，有 owner 与 gate）
9            └─ Shard（一次模型调用能做完的最小单元）
10```
11 
12- **Campaign** 与课题一一对应，有唯一 `campaignId`；跨课题不复用。
13- **Workstream** 必须有 `stage`（S0…S11）与 `gate`；没有 gate 的 Workstream 不允许存在。
14- **Task** 是派单单位，必须有唯一 owner（L2 岗位）与 `acceptance`。
15- **Shard** 是执行单位，必须有稳定 `idempotencyKey`，同一 key 重跑不得产生第二份产物。
16 
17## 拆到哪一层为止
18 
19判断标准只有一条：**这一层能否单独验收**。
20 
21- 能验收 → Task。
22- 不能验收，但能并行 → 继续拆到 Shard。
23- 拆完还说不清"什么叫做完" → 不是粒度问题，是目标没定义，回 S0。
24 
25## 分片粒度经验值
26 
27| 分片类型 | 一片的量 | 理由 |
28| --- | --- | --- |
29| 文献 | 50–200 条记录/片 | 低于 50 上下文浪费；高于 200 单次摘要质量下降 |
30| 全文精读 | 3–8 篇/片 | 需要逐段引用时按篇切，不要按段落切 |
31| 统计 | 1 个检验/片 | 假设检查与效应量必须同片，拆开就对不上 |
32| 作图 | 1 张图/片 | 尺寸、字号、误差棒说明是整图属性 |
33| 写作 | 1 节/片 | 引言/方法/结果/讨论各自风格不同，混写必串味 |
34| 写作-润色 | 800–1500 字/片 | 超过就要拆，否则一致性无法检查 |
35| 代码执行 | 1 个命令/片 | 便于定位失败与重跑 |
36 
37**不许按"平均分"切**。1000 条文献分 5 片是 200 条/片，分 20 片是 50 条/片，都合法；
38分 50 片是 20 条/片，属于过度分片，协调成本超过收益。
39 
40## Shard 的最小字段
41 
42```json
43{
44  "shardId": "lit-0031",
45  "taskId": "task-lit-map",
46  "role": "shard-worker",
47  "kind": "literature",
48  "input": { "query": "...", "window": "2019-2026", "offset": 150, "limit": 200 },
49  "acceptance": { "minRecords": 150, "requireDoi": true },
50  "idempotencyKey": "task-lit-map:2019-2026:150:200",
51  "maxAttempts": 3,
52  "votes": 1
53}
54```
55 
56`idempotencyKey` 由 `taskId + 分片输入指纹` 组成，不含时间戳、不含随机数。
57包含时间戳的 key 等于没有幂等。
58 
59## Gate 怎么设
60 
61一个 Task 的 gate 必须满足三条：
62 
631. **可机器判**：来自工具输出，不是"读起来还行"。例如 `science_stats` 返回了
64…