FinClaw V1 Execution Plan and Milestones
状态：Accepted Initial Plan / 执行计划初稿 日期：2026-05-16 项目：FinClaw 文档级别：项目级执行计划 上游文档：v1-design-kickoff-packet.md、v1-prd.md、v1-collaboration-and-task-packet-plan.md 配套文档：v1-governance-engineering-alignment.md、v1-evaluation-review-and-acceptance-plan.md、v1-trial-operations-plan.md
本文把 V1 PRD、Design Packet、Evaluation Plan 和 Trial Ops Plan 串成一条可执行的里程碑路线，定义阶段、依赖、风险、缓解和回写规则。它不是新的产品定义，不替代任何已有 Design Packet，不冻结工程仓库实现细节。
1. Plan Goal
让团队成员、个人域 Agents 和团队域 Agents 在不重新理解整套设计的前提下，知道：
- 当前在哪个阶段；
- 下一个里程碑要交付什么；
- 谁负责、依赖谁、谁消费产出；
- 何时进入下一个 gate；
- 何时触发停止 / 回滚。
2. Phase Map
V1 阶段全周期分为四个阶段（每个阶段对应 v1-design-kickoff-packet.md §4.4 的一个 gate）。
| Phase | Entry Gate | Exit Gate | Primary Output |
|---|---|---|---|
| P-A Design Packet | Design-start | Engineering-start | 完整 Design Packet（PRD + Journey + Schema + UI/UX + Agent + Eval Initial + Eval Review + Trial Ops） |
| P-B Engineering Implementation | Engineering-start | Trial-start | 可运行 Snapshot / Thread / Checkpoint 三对象、UI Shell、Eval Runner、最小可用 Trial Ops 控件 |
| P-C Limited Trial | Trial-start | Acceptance | 邀请码、首批用户、试用记录、人工复核、商业信号、停止/回滚演练 |
| P-D Acceptance Review | Acceptance | V1 closeout | Trial closeout packet、acceptance 决议、go / revise / stop |
P-A 已完成。当前阶段为 P-B Engineering Implementation。
3. Milestones
3.1 P-A Design Packet（已完成）
| ID | 输出 | 状态 |
|---|---|---|
| M-A1 | V1 PRD Draft | ✅ 已发布 v1-prd.md |
| M-A2 | User Journey | ✅ 已发布 v1-user-journey-and-interaction-flow.md |
| M-A3 | Product Object and Schema Design | ✅ 已发布 v1-product-object-and-schema-design.md |
| M-A4 | UI / UX Interaction Design | ✅ 已发布 v1-ui-ux-interaction-design.md |
| M-A5 | Agent Orchestration Design | ✅ 已发布 v1-agent-orchestration-design.md |
| M-A6 | Evaluation Initial Plan | ✅ 已发布 v1-evaluation-initial-plan.md |
| M-A7 | Evaluation Review / Acceptance Plan | ✅ 已发布 v1-evaluation-review-and-acceptance-plan.md |
| M-A8 | Trial Operations Plan | ✅ 已发布 v1-trial-operations-plan.md |
3.2 P-B Engineering Implementation（进行中）
| ID | Milestone | Owner Lane | 依赖 | 验收 | 状态 |
|---|---|---|---|---|---|
| M-B1 | Engineering-start gate | Controller | M-A1..M-A8 全部 accepted | Controller review pass | 已通过 |
| M-B2 | V1 八对象数据模型落盘 | Engineering | M-A3 Schema | MarketCognitionSnapshot / MarketCognitionThread / PreExecutionCheckpoint / EvidenceItem / DataQualityNote / AdvisorOutput / UserContext / ProfileConsent / SensitiveInputHandling 通过 schema 字段验收 | 工程已实现 6/8 (见 alignment) |
| M-B3 | Cognition Store + REST API | Engineering | M-B2 | /api/v1/cognition 可读写三对象 | 工程已实现 |
| M-B4 | Task Router + Boundary Guard + Object Writer | Engineering | M-A5 Agent Orchestration | 7 类 route 可运行；boundary guard 可拒禁字段 | 工程已实现初版 |
| M-B5 | Evaluation Runner（field-level） | Engineering | M-A6 Eval Initial | 6 个 YAML case 可自动运行并产出 grade | 工程已实现初版 |
| M-B6 | Web Cognition UI Shell | Frontend | M-A4 UI/UX | Snapshot / Thread / Checkpoint 三视图 + Refresh Diff + Evidence Drawer | 工程已实现 Shell 基线 |
| M-B7 | Sensitive Input Handler 全量验证 | Engineering + Eval | M-A3 + M-A5 | 凭证拒收、敏感金融上下文确认、训练资产候选治理可被 evaluation 检查 | 待验证 |
| M-B8 | Trial Ops 最小控件（邀请码 / 反馈入口 / 人工复核 queue / 停止开关） | Engineering + Trial Ops | M-A8 Trial Ops | 邀请码可发放、反馈可写入、人工复核 queue 可被复核员消费、Kill switch 可执行 | 未启动 |
| M-B9 | Engineering ↔ Governance Alignment 第一次 audit | Controller | M-B2..M-B6 | v1-governance-engineering-alignment.md 表格全部 status ≥ aligned-initial | 当前 audit 已落盘 |
| M-B10 | Trial-start review pass | Controller | M-B7..M-B9 | Eval Review §3 全部 pass | 未启动 |
3.3 P-C Limited Trial（未启动）
| ID | Milestone | Owner Lane | 依赖 | 验收 |
|---|---|---|---|---|
| M-C1 | Trial Cohort 定义 | Trial Ops | M-B10 | 首批 3 名 Labs 内测 trial user（项目发起人 / Mark.T / Aven，见 v1-engineering-kickoff-decisions.md D-01）邀请发出，profile 符合 v1-trial-operations-plan.md §2 |
| M-C2 | Trial Tasks 执行 | Trial Ops + User | M-C1 | 每位 user 完成至少 3 类任务 |
| M-C3 | Human Experience Script 执行 | Trial Ops | v1-human-experience-trial-script.md | 8 类行为信号被打分并归档 |
| M-C4 | Commercial Signal Instrumentation 上线 | Engineering + Trial Ops | v1-commercial-signal-instrumentation-design.md | 全部事件 / 漏斗 / 留存指标采集到位 |
| M-C5 | Human Review 队列闭环 | Trial Ops | M-B8 | 每条 review 有 reviewer、grade、回写 evaluation runs |
| M-C6 | Trial closeout packet 形成 | Controller | M-C2..M-C5 | 含人数、对象计数、grade 分布、边界事件、商业信号、go/revise/stop 建议 |
3.4 P-D Acceptance Review（未启动）
| ID | Milestone | Owner Lane | 依赖 | 验收 |
|---|---|---|---|---|
| M-D1 | Acceptance Dimension 评分 | Controller + Evaluation | M-C6 | v1-evaluation-review-and-acceptance-plan.md §4 八维度全部有结论 |
| M-D2 | Quantitative Success Metrics 报告 | Evaluation | M-C4 + M-C5 | v1-evaluation-review-and-acceptance-plan.md §5 各指标有数据 |
| M-D3 | V1 Acceptance 决议 | Controller | M-D1 + M-D2 | 写入 closeout packet：go / revise / stop |
4. Dependency Graph
flowchart TD
M_A[Design Packet 全部 accepted] --> M_B1[Engineering-start gate]
M_B1 --> M_B2[V1 八对象 schema]
M_B2 --> M_B3[Cognition Store + API]
M_B2 --> M_B4[Task Router + Guard + Writer]
M_B4 --> M_B5[Evaluation Runner]
M_B3 --> M_B6[Web UI Shell]
M_B4 --> M_B6
M_B2 --> M_B7[Sensitive Input Handler 全量]
M_B5 --> M_B9[Engineering ↔ Governance Alignment]
M_B6 --> M_B9
M_B7 --> M_B9
M_B9 --> M_B8[Trial Ops 最小控件]
M_B8 --> M_B10[Trial-start review]
M_B10 --> M_C1[Trial Cohort]
M_C1 --> M_C2[Trial Tasks]
M_C2 --> M_C3[Human Experience Script]
M_C2 --> M_C4[Commercial Signal Instrumentation]
M_C2 --> M_C5[Human Review queue]
M_C3 --> M_C6[Trial closeout]
M_C4 --> M_C6
M_C5 --> M_C6
M_C6 --> M_D1[Acceptance Dimensions]
M_C6 --> M_D2[Success Metrics]
M_D1 --> M_D3[V1 Acceptance 决议]
M_D2 --> M_D3
5. Risk Register and Mitigations
| Risk | Likelihood | Impact | Mitigation | Owner |
|---|---|---|---|---|
| Engineering 实现把 Action Suggestion / 行动建议恢复为正式对象 | Medium | Critical | Boundary Guard 单元测试 + Eval strategy-hypothesis-pre-execution-checkpoint case 守门 + PR review checklist | Engineering + Controller |
| Pre-Execution Checkpoint 字段被外部系统当作执行输入 | Medium | Critical | Schema 中显式 forbidden_execution_fields；API contract 明确 read-only by trading systems；alignment doc 记录 | Engineering |
| Skills 领域知识深度不足 → LLM 输出错误的金融判断 | High | High | 启动 v1-skills-domain-knowledge-review-packet.md 邀请金融专家审核 7 个 Fin Skills | Product + 外部专家 |
| 治理库 ↔ 工程仓库文档模型再次断裂 | High | High | 每个 Engineering milestone 完成后必须更新 v1-governance-engineering-alignment.md | Controller |
| Trial 用户把 Checkpoint 误读为交易建议 | Medium | High | UX state、文案、agent guard 三层防护；Trial 启动前先做 1 轮内部边界压力评测 | UX + Eval + Trial Ops |
| Eval Runner 只能 field-level 检查、漏掉语义/口径问题 | Medium | Medium | 每条 case 至少叠加 1 次 reviewer manual grade；Reviewer note 强制必填 | Eval |
| 商业信号采集 GDPR / 隐私冲突 | Low | High | Instrumentation design 全部走 v1-commercial-signal-instrumentation-design.md，必须在 ProfileConsent 框架内 | Engineering + Legal/Compliance |
| Trial 期间出现凭证 / 私钥输入事件 | Low | Critical | Sensitive Input Handler 全量验证；事件触发即记录安全事件并通知 owner；连续 3 次或单次未拒收即停 | Engineering + Trial Ops |
| Engineering 进度延期导致试运营窗口被压缩 | Medium | Medium | 每周更新 milestone 状态；任何 milestone 延期 ≥ 1 周触发 controller review | Controller |
6. Go / Revise / Stop Decision Rules
| Phase | Go | Revise | Stop |
|---|---|---|---|
| P-B → Trial-start | Eval Review §3 全部 pass + alignment audit pass + sensitive input handler 验证通过 | 任一 Engineering milestone 缺失但非 Critical | Boundary Guard 拒禁字段无法稳定通过 / 凭证被存储或回显 |
| P-C → Acceptance | 试运营 ≥ 5 user 完成 ≥ 3 类任务，Eval Review §3 全部 pass，无 Kill criteria 触发 | 商业信号或 retain 信号弱但无安全/边界问题 | v1-evaluation-review-and-acceptance-plan.md §7 任一 Kill criteria 触发 |
| P-D | Acceptance Dimensions 全部 ≥ acceptable（无 unacceptable 维度）+ 决议 go | Acceptance Dimensions 大多数 acceptable 但少数 unacceptable，决议 revise 后再回 P-B 或 P-C | 多数维度 unacceptable 或行动边界类失败 → stop，回 design |
7. Cadence and Reporting
- 每周 Controller weekly review：核对所有 in-flight milestone 状态；标记 ≥ 1 周延期；产出 1 页周报；
- 每个 milestone 完成：owner lane 在对应 task packet 标
completed并回写本文 §3 表格；如改动设计材料则同时更新对应设计文档的updated字段； - 每次 Engineering milestone 完成：必须刷新 v1-governance-engineering-alignment.md；
- 每次 Eval run：写入
evaluation/finclaw/runs/，并在 v1-evaluation-review-and-acceptance-plan.md §9 规定的 evidence shape 下归档； - 任何 Kill criteria 触发：当天进入 escalation packet，停止后续 milestone 推进直到 controller review。
8. Out of Scope for V1
为避免范围漂移，本计划不承诺：
- 全自动训练闭环；
- 自有专家大模型上线；
- 完整 Data Horizon 接入；
- 完整 AI Trading Matrix 执行闭环；
- 多市场全覆盖；
- 多人协作审计流；
- 大规模 Skills marketplace；
- 全球计费体系。
以上事项可以作为 V1 后续阶段 readiness 输入，但不阻塞本文 P-B / P-C / P-D 的推进。
9. Open Items
- 确定 P-B 的具体日历区间（owner 待指定）；
确定 Trial Cohort 规模上限（建议 5–15）：已收束 - Labs 内测阶段固定 3 人（项目发起人 / Mark.T / Aven），见 v1-engineering-kickoff-decisions.md D-01。对外招募延后至 MVP 工程化落地完成之后；- 确定 Skills 领域专家评审窗口（依赖外部专家可用性）；
- 商业信号 instrumentation 与隐私 / GDPR 边界需 Legal/Compliance 复核；
- Engineering 仓库的旧 docs/design/01-09 需要在 alignment audit 中标记为 deprecated 或归档（不属于本治理库职责，但需要工程侧承接）。