# P1-13 prerequisite-fixes 文件确认与介绍

> 日期:2026-05-04 / 触发:Neo 在 04b P1-13 反馈
> Neo 提供线索路径:`\docs\specs\p4-prerequisite-fixes`

## 一、确认结果

**Neo 提供的路径正确,文件确实存在。** P1-13 原冲突中提到的"P5.2-prerequisite-fixes"是**记忆错位**,实际是 **P4-prerequisite-fixes**(Kiro spec 风格三件套):

```
docs/specs/p4-prerequisite-fixes/
├── design.md       (技术设计)
├── requirements.md (需求文档)
└── tasks.md        (任务拆分)
```

## 二、这个文档做什么(业务介绍)

**全名**:**P4 前置依赖修复**(不是 P5 的前置)。

**触发原因**:P4 核心业务层(任务系统 + 备注系统 + 触发器机制)实现并通过属性测试后,对比 SPEC 发现 6 处实现偏差,这些偏差会**阻塞 P6 前端任务模块开发**,所以前置修复。

**来源报告**:`docs/reports/P4-spec-vs-implementation-gap-analysis.md`

## 三、6 个定点修复

| # | 修复点 | GAP 编号 | 影响模块 | 实施状态(根据 design.md) |
|---|---|---|---|---|
| T1 | 任务列表返回已放弃任务(active + abandoned 都返) | GAP-3 | task_manager.py | **已实现,需验证** |
| T2 | 召回完成检测器仅匹配 high_priority_recall + priority_recall(不误判 follow_up_visit / relationship_building) | GAP-6 | recall_detector.py | **已实现,需验证** |
| T3 | 备注回溯重分类器冲突处理(冲突时跳过 / 顶替 / 跳过创建) | GAP-7 | note_reclassifier.py | **需修改** |
| T4 | 回访任务完成条件改为"有备注即完成"(不依赖 AI 评分) | (新增) | note_service.py + note_reclassifier.py | **需修改** |
| T5 | trigger_scheduler last_run_at 事务安全(handler + last_run_at 同一事务) | GAP-9 | trigger_scheduler.py | **需修改** |
| T6 | 任务生成器 cron 改 04:00 → 07:00(匹配门店营业节奏) | (新增) | trigger_scheduler.py 默认值 | **种子已改,默认值仍 4:00,需修** |

## 四、与 Wave 1-5 的关系

**这 6 个修复点不在 Wave 0 的 39 条文档冲突清单里**(本身是"实现偏差"不是"文档冲突"),但与 Wave 1-3 的代码 D Bug 修复方向高度一致:

- T3 / T4 涉及备注 + 任务系统逻辑,Wave 1-3 走查时会自然碰到
- T5 触发器事务安全,Wave 1 沙箱验证会暴露
- T6 cron 默认值,Wave 4 调度验证会发现

**推荐**:把 P4-prerequisite-fixes 的剩余 T3 / T4 / T5 / T6 纳入 **Wave 1 ~ Wave 3** 一并修(估算 1 工作日内可完成)。

## 五、对 04b P1-13 原结论的修正

原结论(P1-13):
> "P5.2-prerequisite-fixes 文件是否应存在但缺失" — 标 **C 待补**

**修正**:
- 不是 P5.2,是 **P4**
- 文件**已存在**,在 `docs/specs/p4-prerequisite-fixes/`(Kiro 风格三件套)
- 6 个修复点中 3 个已完成,3 个未完成
- 建议改判定为:**B 现状对 + Wave 1-3 推进剩余修复**

## 六、给 Neo 的决策提问

1. 是否同意把"P5.2"在 04b P1-13 改名为"P4-prerequisite-fixes"?
2. 剩余 T3 / T4 / T5 / T6 是否纳入 Wave 1-3 修?
3. P0-1 的 SPI 调研中也提到过 "P5.2 文件",同样应修正为"P4-prerequisite-fixes"?

---

> 本文件解决 P1-13 文件存在性问题。文档冲突已落地,无需进一步调研。
