Sync: Labs-FinTecAI FinClaw Project Doc Audit
- 日期：2026-05-14
- 批次：Batch 8C-2
- Owner：Labs-FinTecAI Admin
- Controller Owner：FinClaw Controller
- 状态：Completed / audit only
1. 本批结论
Batch 8C-2 完成 FinClaw 项目层文档体系 audit。
本批确认：
- FinClaw 已有成熟的项目正式入口三件套：战略白皮书、产品定义、MVP 产品定义；
- 第一版对象、术语、V1 PRD、design kickoff、协作计划和两个 P0 task packets 已形成设计支撑层；
- 参考体验报告已被保留为证据层，且多数报告已经写明不可反向覆盖产品定义；
- V1 PRD 仍是
Draft / 可启动下游设计，完整 Design Packet 尚未完成； - User Journey、Product Object and Schema、UI / UX、Agent Orchestration、Evaluation and Trial Acceptance、Trial Operations 仍有下游产物缺口；
- 当前不应把 FinClaw 项目层 audit 误写为项目正文统一重写完成。
本批不证明 FinClaw 项目层重构完成，只证明项目层文档体系已完成首轮 audit，并形成 Batch 8D / 8E 的输入。
2. 文档角色清单
| 文档 | 当前角色 | Audit 结论 | 后续动作 |
|---|---|---|---|
projects/finclaw/strategic-whitepaper.md | canonical / strategy | 当前战略主文档已收束，定位、生态边界、完整态和 cognition-not-execution 口径清楚 | Keep；Batch 8E 可做 low-context rewrite-lite，补 reader walkthrough / explicit acceptance links |
projects/finclaw/product-definition.md | canonical / product-definition | 当前产品定义承接战略并给出阅读顺序、用户、对象、场景和 Agent 继承约束 | Keep；Batch 8E 可补更多样例、用户旅程入口和工程承接链接 |
projects/finclaw/mvp-product-definition.md | canonical / mvp-definition | 第一阶段用户、市场、主路径、对象、技能层和边界清楚 | Keep；Batch 8E 可补量化成功指标、时间盒、trial evidence 链接 |
projects/finclaw/design/foundation/product-object-and-advisor-design.md | support / design-baseline | Thread 生命周期、字段、顾问职责和输出契约清楚；不是产品入口 | Keep；下推到 schema、UX、Agent 和 evaluation |
projects/finclaw/design/foundation/terminology-and-object-naming.md | support / terminology-baseline | 术语收束有效，已防止 Action Suggestion / watchlist / signal 反向污染正式口径 | Keep；后续 schema / UI / eval 必须继承 |
projects/finclaw/design/v1/v1-design-kickoff-packet.md | support / design-control | 明确 Design Packet 未完成，列出 DAG、gate、输出合同和禁止范围 | Keep；作为下游设计执行控制面 |
projects/finclaw/design/v1/v1-prd.md | support / prd-draft | 可启动下游设计，但正文明确不是完整 Design Packet 或试运营验收完成 | Keep；工程前必须补齐下游设计与验收计划 |
projects/finclaw/design/v1/v1-collaboration-and-task-packet-plan.md | support / collaboration-plan | 已拆出协同规则和 P0 task packets | Keep；作为多人 / 多 Agent 设计执行计划 |
projects/finclaw/design/task-packets/v1-user-journey-interaction-flow-task-packet.md | task / active-design-task | 明确产出 User Journey，不产出 UI、schema 或工程代码 | Execute in design lane；完成后回写设计支撑层 |
projects/finclaw/design/task-packets/v1-product-object-schema-design-task-packet.md | task / active-design-task | 明确产出对象与 schema 设计，不定义订单、账户、私钥或执行字段 | Execute in design lane；完成后回写 schema / API / persistence 边界 |
projects/finclaw/reference-experience/README.md | evidence-index | 证据层索引清楚，明确参考报告不能直接定义产品边界 | Keep；新增报告必须绑定产品对象或评测问题 |
projects/finclaw/reference-experience/martinpmm-finclaw-evaluation.md | evidence / reference-experience | 对持续关注、团队 brief、source provenance 和 degraded cognition 有参考价值 | Keep as evidence；吸收结论必须回写 product / evaluation |
projects/finclaw/reference-experience/fin-chelae-finclaw-evaluation.md | evidence / reference-experience | 可参考个性化、channel 和工具组织，但生产 / meme launch / channel 面不可直接吸收 | Keep as evidence；保留边界警示 |
projects/finclaw/reference-experience/aifinlab-finclaw-evaluation.md | evidence / runtime-evaluation | Docker/OpenClaw chat rerun 提供运行证据；技能语境、实时数据和状态真实性有限 | Keep as evidence；不要当作实现蓝本 |
projects/finclaw/reference-experience/aifinlab-skill-layer-evaluation.md | evidence / skill-layer-evaluation | 技能 taxonomy、数据降级和候选能力已有深批次结论 | Keep as evidence；候选能力需按 FinClaw 对象模型重写 |
projects/finclaw/reference-experience/aifinlab-team-alignment-brief.md | sync-support / team-brief | 已把 aifinlab 价值从实现复用转成团队认知对齐 | Keep；等待个人域复核输入 |
projects/finclaw/reference-experience/aifinlab-personal-domain-review-checklist.md | task / review-checklist | 用于个人域复核，不增加新事实 | Execute when reviewer input exists |
projects/finclaw/reference-experience/finrobot-evaluation.md | evidence / report-pipeline-reference | 适合报告生产型参考项目，不能套用聊天 case 或工程仓库定位 | Keep as evidence；横向对比需单独标注 |
projects/finclaw/reference-experience/external-evaluation-repositories-synthesis.md | evidence / external-eval-synthesis | 外部评测仓库为 case library 补充，不替代真实参考项目体验 | Keep as evidence；后续合并到 evaluation layer |
controllers/finclaw/state.md | controller-state | 可恢复 Controller 当前边界，但仍停留在 Batch 4 pickup 后的任务队列 | Update with Batch 8C-2 audit input |
3. Canonical / Support / Evidence / Open Gap
| 分类 | 条目 |
|---|---|
canonical | strategic-whitepaper.md、product-definition.md、mvp-product-definition.md |
support | product-object-and-advisor-design.md、terminology-and-object-naming.md、v1-design-kickoff-packet.md、v1-prd.md、v1-collaboration-and-task-packet-plan.md |
task | v1-user-journey-interaction-flow-task-packet.md、v1-product-object-schema-design-task-packet.md、aifinlab-personal-domain-review-checklist.md |
evidence | reference-experience/README.md 及各参考体验 / 技能层 / 外部评测报告 |
controller-state | controllers/finclaw/state.md |
open-gap | 完整 Design Packet、User Journey、Product Object and Schema Design、UI / UX Interaction Design、Agent Orchestration Design、Evaluation and Trial Acceptance Plan、Trial Operations Plan、工程 API / persistence 契约、真实试运营数据、reader testing、量化成功指标、时间盒、kill criteria、JSON 样例、状态机图、可运行 evaluation / trial closeout evidence |
4. FR 映射
| FR | 本批处理 |
|---|---|
| FR-003 | 将 FinClaw 项目文档分为 canonical、support、task、evidence、controller-state 和 open-gap，避免参考报告、task packet 或 Controller state 被误读为正式产品事实源。 |
| FR-004 | 明确 FinClaw 项目层已有成熟定义，但本批仍只是 audit，不是项目正文 rewrite closeout。 |
| FR-011 | 识别正式三件套较完整，但仍需要低上下文 reader walkthrough、具体样例、路径化阅读和视觉 / 状态锚点继续增强。 |
| FR-014 | 标出 V1 下游设计、schema、UI / UX、Agent 编排、评测验收、试运营计划和工程承接仍未完成。 |
| FR-015 | FinClaw 已比其他项目更具体地定义首发用户、市场、对象和主路径，但量化指标、时间盒、kill criteria 和 trial evidence 仍需补齐。 |
| FR-016 | 明确 PRD / kickoff / task packet 的完成只证明设计启动，不证明工程进展、试运营进展或项目完成。 |
| FR-017 | 标出 JSON 样例、状态机可视化、用户旅程文档、UI 线框、真实验收 case 和 trial closeout evidence 仍属于 open-gap。 |
5. Admin Rewrite Authorization 输入
当前不建议 Admin 在 Batch 8C-2 中直接统一重写 FinClaw 项目正文。
原因：
- FinClaw 三份 canonical 已经是当前项目事实源，且已在 2026-05-13 完成较深产品收束；
- 设计支撑层明确区分了
support、task和evidence，直接重写容易打断下游 Design Packet DAG； - V1 尚缺的是下游设计与验收产物，不是缺少一份新的上位产品定义；
- 参考体验层已经通过使用边界防止反向覆盖产品定义，应继续通过吸收矩阵和 evaluation 回写，而不是由 Admin 直接改写为产品事实。
建议 Batch 8D 对 FinClaw 的默认决策为：
Controller-owned rewrite plan with Admin rewrite-lite option, not immediate Admin unified rewrite.
如果用户明确授权 Admin 统一重写 FinClaw 项目正文，应将范围限定为：
- 三份 canonical 的 low-context rewrite-lite：补 reader walkthrough、具体样例、验收链接、trial evidence 链接；
- 不改变已收束的产品边界和 cognition-not-execution 口径；
- 不替代 User Journey、schema、UI / UX、Agent Orchestration、Evaluation and Trial Acceptance、Trial Operations 的下游产物。
6. 后续动作
FinClaw Controller 后续应优先处理：
- 执行
V1 User Journey and Interaction Flowtask packet； - 执行
V1 Product Object and Schema Designtask packet； - 补
UI / UX Interaction Design、Agent Orchestration Design、Evaluation and Trial Acceptance Plan、Trial Operations Plan； - 将
evaluation/finclaw/的 case schema、cases 和参考体验吸收结论连接到 V1 PRD / MVP 验收； - 为三份 canonical 补量化成功指标、时间盒、kill criteria、样例和 reader testing evidence；
- 将工程仓库
/Users/mlabs/Programs/fin-claw的 object / API / test / UI 迁移输入与 V1 设计产物对齐。
Admin 下一步进入 Batch 8C-3：AI Trading Matrix project-doc-audit。