跳到主要内容

ADR-001 — 工程范式：Harness Workflow + 里程碑切片 + 走通骨架试点

决策​

FinBayes 第一阶段工程化按以下范式推进：

  1. M0 走通骨架：一个任务类型 × 一个市场 × 一个入口 × 一个状态对象端到端打通（1-2 天），验证契约在代码上落得下
  2. 后续里程碑切片（M1 / M2 / M3 / ...）：按维度（任务类型 / 市场 / 入口 / 状态对象）渐进 thicken
  3. 每个里程碑过三检 review gate：
    • 战略保真度（机械 grep + 实质语义人工核查，双层）
    • 契约回归（与上一里程碑的接口字段级差异向后兼容）
    • 认知质量评估（具体方法待 OQ-002 / 后续 CHAP-20 / CHAP-21 定义）

上下文​

FinBayes 第一阶段涉及 7 个任务类型 × 2 个市场 × 4-5 个入口 × 5 个状态对象 × 综合输出质量验收。这个范围一次性落下，单点失败成本极高，单个实施 Agent 或单人难以承担。同时战略白皮书承认商业模式仍有未决问题（单位经济 / vs 通用 AI 留存竞争 / L1-L3 商业强度），需要 early ship + 冷启动数据验证，不能等"完整闭环"再上线。

后果​

收益：

  • 切片小，单个 Agent 或单人能承担
  • 里程碑可并行（如判断记录持久化与 Watchlist 注册表是独立线，可同时推进）
  • M0 走通骨架 1-2 天内出最小 demo，早期发现工具栈、接口、状态写入路径上的问题
  • 三检 review gate 把契约保护分摊到每个里程碑，替代"一次冻结契约后只允许向后兼容"的硬约束

成本：

  • 总体规划复杂度高于"一次性落最小完整闭环"
  • 里程碑间依赖关系需要在 status.md 显式标出，避免多 Agent 并行撞车
  • review gate 工作量分摊到每个里程碑，单次 review 投入分散但总投入增加

备选方案​

考虑过未采用：约束型 Goal 范式（G0 审计 + G1 一次性落最小完整闭环 + 冻结产品契约 + G2 只 additive）/ 纯走通骨架（只打 thin slice 不切里程碑）/ 领域驱动设计的子域划分（FinBayes 单边界范围不需要）/ 固定时间盒敏捷迭代（认知产品完工定义难按时间精确）。

关联​

  • 走通骨架 + 里程碑切片的具体实施由 Harness Workflow 与里程碑规范文档承接
  • 三检 review gate 中"战略保真度"的双层检查在 CHAP-03 § 关键质量属性一 展开
  • 三检 review gate 中"认知质量评估"方法待 OQ-002 解决