第二十五节 — 与里程碑 / 任务的对应
这一节回答：本架构文档的 27 章如何映射到工程实施仓的里程碑切片？M0 走通骨架是什么？后续里程碑怎么 thicken？
范式回顾
详见 ADR-001。要点：
- M0 走通骨架：1 任务类型 × 1 市场 × 1 入口 × 1 状态对象端到端打通（1-2 天），验证契约能在代码上落
- 后续里程碑切片：按维度（任务类型 / 市场 / 入口 / 状态对象 / 工程能力）渐进 thicken
- 每个里程碑过三检 review gate：战略保真度 + 契约回归 + 认知质量评估
本章不重复决策论证，只把 27 章映射到具体里程碑。
里程碑全景
这张图表达什么：里程碑的依赖序列。M0 必须最先；M1-M3 是基础能力扩展；M4-M5 是范围扩展；M6-M7 是工程闭环。其中 M2 → M4 与 M3 → M5 可一定程度并行。
这张图特意不表达什么：每个里程碑的工期（按完工定义而非时间盒，详见 ADR-001）；里程碑内的子任务（在 OpenSpec 提案中展开）。
M0 走通骨架
范围
| 维度 | M0 选什么 |
|---|---|
| 任务类型 | 即时认知请求（最常见 + 最简单链路） |
| 市场 | Crypto（数据 Provider 选项最多 / 限制最少） |
| 入口 | CLI（最易调试 + 无 UI 依赖） |
| 状态对象 | Fin Object（基础数据对象，无两步写入复杂度） |
M0 必须打通的链路
M0 覆盖的章节
| 章节 | M0 是否覆盖 |
|---|---|
| CHAP-01 至 CHAP-03 | ✅ 立架与目标 |
| CHAP-04 业务对象与关系 | ✅ 仅 Fin Object + Session（一个默认 Session） |
| CHAP-05 用户价值与认知流转 | ✅ 三层价值的"题眼回答"层 |
| CHAP-06 关键业务场景 | ✅ 仅 S1 即时认知请求 |
| CHAP-07 系统与外部世界 | ✅ Context 图最小子集 |
| CHAP-08 进程与服务划分 | ✅ 单进程 |
| CHAP-09 子系统组件 | ✅ 6 个子系统的最小可用版本 |
| CHAP-10 关键场景流转图 | ✅ 仅 S1 sequence |
| CHAP-11 状态对象生命周期 | ⚠️ Fin Object 仅 created 状态，不走两步写入 |
| CHAP-12 并发与异步处理 | ✅ asyncio.TaskGroup 基础 |
| CHAP-13 故障与降级路径 | ⚠️ 仅 L1 用户配置 Provider implement，L1' / L2 / L3 / L4 全部 stub（详见工程包 m0-walking-skeleton.md §2 接口子集表）。Provider 调用失败时仅记录降级事件 + 抛 ProviderNotReadyError（退出码 20），不真正切换 fallback。L1' 在 M1+ 上线。 |
| CHAP-14 部署形态 | ✅ 本地优先单机 |
| CHAP-15 数据存储划分 | ⚠️ 仅 State Store（SQLite） + 审计 trail；Cache / Credential / Config 简化 |
| CHAP-16 通信协议 | ✅ stdio + HTTPS Provider 调用 |
| CHAP-17 边界与安全 | ✅ 输入边界 hook（凭证识别）+ TLS 强制 |
| CHAP-18 可观测性 | ⚠️ 审计 trail + task_id trace，指标体系暂不实现 |
| CHAP-19 演化与版本管理 | ⚠️ semver 字段约定但不实际触发 migration |
✅ = 完整覆盖；⚠️ = 最小可用，后续里程碑 thicken；空白 = 不在 M0 范围
M0 验收
| 检查 | 通过条件 |
|---|---|
| 战略保真度 | verify-kb grep + 人工审查无禁词命中 |
| 契约回归 | M0 是基线，建立契约 baseline |
| 认知质量 | 手工跑 5 条样例输入，输出含反方 + 失效条件 + 题眼命中 |
| 边界 | 测试集 5 类凭证样式输入全部拒收 |
| 审计 trail | 每次 task 进入审计，含完整 Provider 调用链 |
M1 状态化
范围
- 引入 Session 多实例 + Session 切换
- 引入 Watchlist 与 Watchlist 内的 Fin Object
- 引入 Judgment Record 持久化
- 引入候选 → 已确认两步写入路径
覆盖章节增量
- CHAP-11 状态对象生命周期 → 完整 5 个状态机
- CHAP-15 State Store → 完整 8 张表
- CHAP-09 State Management 子系统 → 完整 candidate / confirmed 路径
M1 验收
- 用户在 Session A 创建一条 Judgment Record → 切换 Session B → 切回 A 仍可见
- candidate 状态对象等待用户确认；用户确认 / 拒绝 / 编辑路径都打通
- 用户主动修改画像 / 删除 Session 等动作齐全
M2 任务类型扩展
范围
- 加复盘任务（引用历史 Judgment Record）
- 加关注流任务（基于 Watchlist）
- LLM Function Calling 工具池扩展（clarify 工具上线）
覆盖章节增量
- CHAP-06 关键业务场景 → S3 复盘 + S4 关注流
- CHAP-10 关键场景流转图 → S3 + S4 + S5 sequence
M2 验收
- 复盘任务能正确引用历史 Judgment Record + 输出"信息缺口"
- 关注流任务能基于 Watchlist 当前状态给输出
- LLM 调 clarify 工具的频率 <20%（评估指标）
M3 入口扩展
范围
- TUI 入口（Textual / Rich）
- Web API（HTTP + WebSocket）+ 最小 Web UI
覆盖章节增量
- CHAP-07 外部接触契约 → 3 个入口完整
- CHAP-16 通信协议 → Web API 端点 + WebSocket
M3 验收
- 三入口（CLI / TUI / Web）等价场景输出一致
- Web API 鉴权（localhost only）+ contract_version 协议工作
- Web UI 能查看 Session / Judgment / 主动信号
M4 市场扩展
范围
- US Stocks 市场加入
- 新数据 Provider（如 yfinance / SEC EDGAR）接入
覆盖章节增量
- CHAP-04 Fin Object 类型 → 完整覆盖股票 / 板块 / 财报事件
- CHAP-06 任务类型 → S2 / S6 等场景在 US Stocks 上运行
M4 验收
- 同一任务类型在两个市场都能跑
- 数据 Provider 失败降级路径覆盖
M5 主动信号
范围
- Judgment Record 的失效条件被市场触及时自动触发新一轮认知
- Channel Adapter 选其一（推荐 Telegram，最简单）
覆盖章节增量
- CHAP-10 S4 关注流 sequence → 完整
- CHAP-09 Input Pipeline → Channel 入口完整
- CHAP-13 主动信号触发的批量任务
M5 验收
- 失效条件触及 → 5 分钟内 Channel 投递 + 落审计
- 投递失败重试 + 用户可在 Web 复盘
M6 评估闭环
范围
- Eval Set 第一版（冒烟 + 回归 + 抗扰）
- LLM-as-judge 工程
- nightly 真档评估
覆盖章节增量
- CHAP-20 测试体系 → 完整四层
- CHAP-21 评估闭环 → 完整闭环
M6 验收
- 评估能在 nightly 跑完 + 报告生成
- 历史失败 case 进入回归集 + 不再回归
- 评估软阈值跑通
M7 演化能力
范围
- Schema migration 真实演练（v1 → v2 测试）
- Prompt 版本化（ADR-009 落地）
- Provider 退役 / 工具退役流程演练
覆盖章节增量
- CHAP-19 演化与版本管理 → 完整
- CHAP-22 缺口管理 → 工程承接到位
M7 验收
- Schema migration 跑通 + 回滚演练成功
- Prompt 版本切换可观测 + 评估关联
- 一次 Provider 退役完整走完流程
里程碑间的依赖与并行
| 里程碑 | 必须前置 | 可并行 |
|---|---|---|
| M0 | 无 | 无 |
| M1 | M0 | — |
| M2 | M1 | — |
| M3 | M1（不依赖 M2） | M2 |
| M4 | M2 | M3 |
| M5 | M2 + M3 | M4 |
| M6 | M2 | M3 / M4 / M5 |
| M7 | M6 | — |
里程碑工作流落地（呼应 ADR-003）
每个里程碑按 OpenSpec + Archon + Claude Code 主控 + Codex 实施的协作模式（详见 ADR-003）：
| 阶段 | 谁做 | 产物 |
|---|---|---|
| Spec | Claude Code | OpenSpec 提案：task packet + 数据结构 diff + 验收口径 + 与本架构文档章节追溯 |
| 实施 | Codex（在 git worktree） | 代码 PR + 测试 + 文档更新 |
| Review | Claude Code | 跑确定性 gate + 跨文档一致性 + 出 review report |
| 认知质量评估 | 工作流维护者 + 跨 Agent 模拟 | 评估报告 |
| Merge + 移交 | Claude Code | 提案进 accepted + 更新 status |
关键约束：每个里程碑的 OpenSpec 提案必须显式追溯到本架构文档的章节（如 "M1 实施 CHAP-11 / CHAP-15 增量 + ADR-007 决策"）。
与其他章节的关系
- 工程范式来源 → ADR-001
- 工程实施栈与协作 → ADR-003
- 战略保真度 review gate → CHAP-03 / CHAP-17
- 契约回归依据 → CHAP-19 演化与版本管理
- 认知质量评估方法 → CHAP-21 评估闭环
- 每里程碑审计点 → CHAP-26 审计点
- 代码物理位置 → CHAP-27 代码仓位置映射