跳到主要内容

FinClaw MVP Engineering Alignment

状态：Compressed active handoff 更新时间：2026-05-10 角色：FinClaw Program Controller 历史归档：packets/sync/archive/finclaw-mvp-engineering-alignment-2026-05-09-full-history.md

1. 当前权威入口​

本文件是低上下文续接入口，不再保留完整历史变更流水。

当前应优先读取：

  1. projects/finclaw/strategic-whitepaper.md
  2. projects/finclaw/product-definition.md
  3. projects/finclaw/mvp-product-definition.md
  4. source/project-prealignment/finclaw/product-definition-supplement.md
  5. evaluation/finclaw/case-library.md
  6. projects/finclaw/reference-experience/martinpmm-finclaw-evaluation.md
  7. packets/sync/finclaw-program-controller-handoff-2026-05-09.md

工作台材料仍保留在：

  • packets/sync/finclaw-reference-experience-2026-05-09/

但团队同步和后续评测应优先使用 projects/finclaw/reference-experience/ 下的正式知识库文件。

2. Program Controller 边界​

Program Controller 负责跨材料、跨工程、跨个人域 Agent 的协调和对齐：

  • 维护 FinClaw 当前权威上游输入；
  • 识别早期工程实现与上位产品定义的偏差；
  • 组织参考项目实际体验评测；
  • 输出团队成员和个人域 Agent 可消费的同步材料；
  • 为后续 open-cowork / 工程任务拆解准备输入。

Program Controller 不负责：

  • 直接改 /Users/mlabs/Programs/fin-claw 代码；
  • 写工程接口契约或系统对接设计；
  • 让早期工程 PRD 或参考项目能力反向覆盖上位战略、产品定义和 MVP 定义；
  • 替代 owner 做最终产品边界裁决。

3. 当前稳定结论​

  1. /Users/mlabs/Programs/fin-claw 是早期工程探索资产，可保留 runtime、任务流、SSE、session persistence、API / frontend 骨架和测试基底。
  2. 旧工程中的 MarketIntelligence + ActionSuggestion 语义不应作为上位 MVP 对象定义继续推进。
  3. 当前上位产品语言应围绕 Structured Market Cognition Snapshot、Market Cognition Thread、Pre-Execution Checkpoint 和金融认知链路。
  4. FinClaw MVP 的核心边界是 evidence-bounded market cognition，不是交易执行或自动投资建议。
  5. 参考项目体验阶段不应用 FinClaw 自身风险边界提前裁剪参考项目；风险边界和术语替换放在后置 FinClaw alignment 中处理。

4. 团队认知对齐状态​

已确认推进顺序：

  1. 先补参考项目 / 竞品 / 实际使用体验校准；
  2. 再完善和矫正 FinClaw 产品理解；
  3. 再定义团队认知对齐完成标准；
  4. 最后进入工程任务拆解。

当前已完成第一批参考项目中的 martinpmm-Finclaw 正式体验评测。

5. 正式入库材料​

已形成两个可供团队成员 M / E 及其个人域 Agent 复用的正式知识库文件：

  • evaluation/finclaw/case-library.md
  • projects/finclaw/reference-experience/martinpmm-finclaw-evaluation.md

命名约定：

  • 文件名保持稳定；
  • 不在文件名中编码版本号或日期；
  • 版本、基线日期、评测日期和状态写在文件内容中。

6. Case Library 基线​

evaluation/finclaw/case-library.md 当前状态为 V1.1 / FinClaw evaluation baseline with benchmark adapters。

它包含：

  • UX-*：入口、部署、能力声明和人工体验基线；
  • Cognition-Matrix-*：Universal Cases Matrix，覆盖宏观 / 微观、跨资产、策略、周期、情绪、突发、数据缺口、团队 handoff；
  • Real-Chat-*：真实自由 chat 补充，覆盖口语、模糊、焦虑、短追问、实际查询、概念混用、新手困惑、下一步观察和行动意图；
  • Report-Pipeline-*、Benchmark-Financial-*、Multimodal-*、Safety-*：报告生产、金融 benchmark、多模态和安全 adapter 层；
  • result collection schema；
  • A / B / C / D / N/A Rate schema；
  • action advice scoring rule；
  • model / runtime telemetry rule。

后续参考项目评测应使用该文件作为统一 case library。

7. martinpmm-Finclaw 正式评测基线​

martinpmm-finclaw-evaluation.md 当前状态为 V1 / Official reference experience evaluation。

本轮覆盖：

  • Cognition-Matrix-01~Cognition-Matrix-18
  • Real-Chat-01~Real-Chat-12
  • 共 30 个 case。

运行信息：

  • 模型：gemini-3-flash-preview
  • 入口：/Users/mlabs/Programs/martinpmm-Finclaw/.venv/bin/finclaw agent -m
  • 总耗时：约 681 秒
  • 估算 token：约 47,200
  • tool calls：172

Rate 汇总：

  • A：9
  • B：20
  • C：1
  • D / N/A：0

Side-effect cleanup：

  • Real-Chat-12 创建过 3 个 cron jobs；
  • 测试后已全部撤销；
  • finclaw cron list 返回 No scheduled jobs.；
  • /Users/mlabs/.finclaw/cron/jobs.json 中 jobs 为空；
  • WATCHLIST.md mtime 未变化。

8. 下一批建议​

下一批应选择一个方向，不要并行展开：

  1. 将正式入库文件同步到 Labs-FinTecAI-Gov 对应知识库位置；
  2. 启动第二个本地参考项目体验评测，优先候选：Chelae-FinClaw 或 aifinlab-FinClaw；
  3. 基于 case-library.md 和 martinpmm-finclaw-evaluation.md 草拟团队成员 M / E 的参考项目体验同步说明；
  4. 回到 /Users/mlabs/Programs/fin-claw，用当前参考体验基线重新审视 MVP 工程对齐问题。

9. 停止点​

当前批次完成：

  • 旧长 handoff 已压缩；
  • 完整历史已归档；
  • case library 已正式入库；
  • martinpmm 第一轮正式评测报告已正式入库；
  • 后续不应再从旧阶段报告、per-case logs 或版本化修正记录恢复工作。