# P0 基线与合同
本页从[工作包清单](工作包清单.json)投影。各包状态引用工作包清单；目标、文件或用例已列入不表示已验证。先读[总计划](总计划.md)与[执行规则](执行与验收.md)。
| 工作包 | 责任角色 | 前置包 | 交付结果 |
|--------|----------|--------|----------|
| [W00](P0-基线与合同.md#w00) 固定工作树、资料与数据边界 | 实施负责人 | 无 | 取得可复现基线，并明确新旧环境的隔离方式 |
| [W01](P0-基线与合同.md#w01) 落实合同与逐用例工作清单 | 设计与验证负责人 | [W00](P0-基线与合同.md#w00) | 把实现入口、用例和证据要求固定为实施基线 |
## W00 固定工作树、资料与数据边界
**交付目标：** 取得可复现基线，并明确新旧环境的隔离方式。
责任角色：实施负责人。前置：无。
### 工作内容
1. 记录当前 HEAD、已有修改、未跟踪文件和内容哈希；保留已删除状态，不能从 HEAD 新建后漏掉工作树变更。
2. 在受控私人批次目录保存代码差异、必要未跟踪内容及恢复清单；凭据只记获取位置。
3. 实施时建立隔离重写工作树；新应用连接独立目标库，开发和验证连接隔离测试库。
4. 分别盘点旧 PG、SQLite、参考原文、草稿、raw、归档与外部配置；未知值进入差异记录。
5. 明确本批次可执行动作、当前作者数据冻结边界和验证环境；已授权动作不重复询问。
### 文件、功能与用例
维护 223 个目标条目；精确范围见[分配索引](分配索引.md)，后续关联包及处理方式以 JSON 为准。代码入口包括：
- [.agents.local/AGENTS.md](../文件设计/私人资料.md#file-9ce56be9567dabdd)。
- [.agents.local/便签.md](../文件设计/私人资料.md#file-4d609a011b7542c2)。
- [.agents.local/skills/my-skills/](../文件设计/私人资料.md#file-b5cb33beb3dca20a)。
- [docs/目录.md](../文件设计/文档与研究证据.md#file-4ac167703727543d)。
- [docs/系统架构/目录.md](../文件设计/文档与研究证据.md#file-841971c0447f518c)。
- [docs/系统架构/新版设计/业务需求/目录.md](../文件设计/文档与研究证据.md#file-61b32a1cdf3bee45)。
- [docs/系统架构/新版设计/业务需求/目标系统完整功能清单.md](../文件设计/文档与研究证据.md#file-49ec7c13732289a9)。
- [docs/系统架构/新版设计/决策/0001-模块化单体.md](../文件设计/文档与研究证据.md#file-2406892e00edf933)。
- [docs/系统架构/新版设计/决策/0002-统一持久化.md](../文件设计/文档与研究证据.md#file-5998f848b1793e0e)。
- [docs/系统架构/新版设计/决策/0003-Skill与业务实现分离.md](../文件设计/文档与研究证据.md#file-0609100e03259a12)。
牵头功能：共享底座、基线或切换职责，支撑所依赖的功能包。
分配 0 个目标用例与 0 个退役裁决。数量只用于定位，新增功能仍按本包合同补独立用例。本包的新增能力先在 W01/本包入口形成用例与观察清单，不以没有旧用例解释为无需验证。
### 接受条件
- 内容快照可以重建当前工作树；源哈希、已有删除和私人数据范围可核对。
- 新旧入口和库用途明确，旧生产仍可运行；无默认正式库连接回退。
### 失败与回退
丢弃隔离重写产物即可回到原工作树；不得重置原目录或用旧 HEAD 覆盖用户修改。
### 依据
[阅读指南](../阅读指南.md)；[现有文件处置清单](../现有文件处置清单.json)；[存储与对象关系](../数据模型/存储与对象关系.md)。
## W01 落实合同与逐用例工作清单
**交付目标：** 把实现入口、用例和证据要求固定为实施基线。
责任角色：设计与验证负责人。前置：[W00](P0-基线与合同.md#w00)。
### 工作内容
1. 核对 129 项功能的工作包归属，补出各包的新功能正例、反例与边界场景。
2. 逐条处理分配用例的 given/when/then、参数行和差异说明；内部形状断言不机械复制。
3. 优先定稿 CAS、正式提交、任务范围、raw 归档、知识分流、中文选区和旧数据确认语义。
4. 固定首批公开接口及错误合同；未知处在所属文档解决，不向代码散布临时解释。
5. 记录用例拆分、合并和退役理由；计划条目不等同测试完成。
### 文件、功能与用例
维护 37 个目标条目；精确范围见[分配索引](分配索引.md)，后续关联包及处理方式以 JSON 为准。代码入口包括：
- [tests/单元/test_正文格式与选段.py](../文件设计/测试与夹具.md#file-b48679e6bd6d9299)。
- [tests/单元/test_偏好作用域与撤回.py](../文件设计/测试与夹具.md#file-885767cbbe906676)。
- [tests/单元/test_定稿清单与导出.py](../文件设计/测试与夹具.md#file-ebb3ee75378df6b2)。
- [tests/契约/test_HTTP合同.py](../文件设计/测试与夹具.md#file-00a68bffe9d957cc)。
- [tests/契约/test_事件游标与重连.py](../文件设计/测试与夹具.md#file-ff57e0922290bb54)。
- [tests/契约/test_动态结构投影与版本.py](../文件设计/测试与夹具.md#file-5928ca50070419ec)。
- [tests/集成/test_上游依赖并发变更.py](../文件设计/测试与夹具.md#file-c7cc8d0c62381e56)。
- [tests/集成/test_取消恢复与未知调用.py](../文件设计/测试与夹具.md#file-a341b64872d19c3f)。
- [tests/集成/test_事实来源变更.py](../文件设计/测试与夹具.md#file-759781b567ede1c9)。
- [tests/集成/test_分支合并与回退.py](../文件设计/测试与夹具.md#file-32047b8520a483fb)。
牵头功能：共享底座、基线或切换职责，支撑所依赖的功能包。
分配 0 个目标用例与 3 个退役裁决。数量只用于定位，新增功能仍按本包合同补独立用例。本包的新增能力先在 W01/本包入口形成用例与观察清单，不以没有旧用例解释为无需验证。
### 接受条件
- 每个工作包有可操作的输入、输出与验收；首批保护用例有独立夹具和准确环境。
- 测试文件仅定位来源，所有旧用例均有归属；不存在整文件“已迁移”作为行为证据。
### 失败与回退
尚未执行数据或业务变更；调整计划与合同并重新核对受影响工作包。
### 依据
[测试用例重写](../验证设计/测试用例重写.md)；[命令与作者决策](../接口契约/命令与作者决策.md)；[正文结构与中文选区](../接口契约/正文结构与中文选区.md)。