跳到主要内容

FinClaw V1 Collaboration and Task Packet Plan

状态：Design Collaboration Plan / Design Packet 已完成；Engineering / 评审 / Trial 阶段任务包已就绪 日期：2026-05-13 项目：FinClaw 文档级别：项目级设计协同与任务包计划 上游文档：strategic-whitepaper.md、product-definition.md、mvp-product-definition.md、product-object-and-advisor-design.md、v1-design-kickoff-packet.md、v1-prd.md 协同协议：packets/README.md、packets/sync/README.md、packets/escalation/README.md

本文用于把 FinClaw V1 设计阶段开放给团队成员、个人域 Agents 和团队域 Agents 协同参与。

本文不是新的产品定义，不替代 FinClaw V1 PRD，也不把 Labs-FinTecAI-Gov 变成日常任务看板。它只定义设计阶段怎样分工、怎样领取上下文、怎样产出可回写材料、哪些事项需要进入 packet、sync 或 escalation。

当前状态说明（2026-05-16）：V1 完整 Design Packet 已 accepted，进入 Engineering Implementation 阶段。设计阶段两个 P0 task packet（User Journey、Schema）已 completed；其余 5 份 Design Packet 文档（UI/UX、Agent、Eval Initial、Eval Review、Trial Ops）由对应 lane 直接产出（见 §5.3）。当前主线由 §5.2 列出的四个工程 / 评审 / 试运营任务包推进，整体节奏由 v1-execution-plan-and-milestones.md 串联。

1. 协同目标​

FinClaw V1 设计阶段需要从已收束的产品定义下推为可实现、可评审、可验收的设计材料。

协同目标：

  1. 让团队成员和 Agents 共享同一组事实源；
  2. 把 PRD 下游拆成可并行推进的设计 lanes；
  3. 让每个 lane 的输出能被其他 lane 消费；
  4. 避免个人域或团队域重新定义 FinClaw 产品边界；
  5. 保留分歧、风险、证据和待裁决项的回流路径；
  6. 为后续工程仓库、UI 原型、Agent 编排和试运营计划提供可执行输入。

2. 当前权威输入​

设计阶段所有参与者应从以下最小输入开始，不从目录树全量扫描。

用途必读材料
产品边界product-definition.md、mvp-product-definition.md
设计启动v1-design-kickoff-packet.md、v1-prd.md
对象和顾问product-object-and-advisor-design.md
术语命名terminology-and-object-naming.md
评测承接evaluation/finclaw/case-schema.md、evaluation/finclaw/cases/README.md
协同协议packets/README.md、packets/sync/README.md、packets/escalation/README.md

团队成员若只做单一 lane，可由 Controller 指定其中 3 到 5 份材料作为本轮上下文包。

3. 设计阶段 Lanes​

Lane责任主要输入主要输出回写位置
Product / PRD维护 V1 范围、用户、场景、验收和非目标V1 PRD + Kickoff PacketPRD 修订、需求分歧、验收口径v1-prd.md
UX / Interaction设计 C 端主路径、页面、状态、移动端体验V1 PRD + Journey + schemaUser Journey、Interaction Flow、UI / UX Designprojects/finclaw/design/
Object / Schema将 Snapshot、Thread、Checkpoint、Evidence、Advisor Output 转为字段和接口草案对象设计 + case schemaProduct Object and Schema Designprojects/finclaw/design/
Agent Orchestration设计 FinSkills、金融认知顾问、Claw 路由、分歧处理V1 PRD + Journey + schemaAgent Orchestration Designprojects/finclaw/design/
Evaluation把 case schema 和 cases 转成 V1 验收计划；先形成 Initial Plan 反向校验 UX / Agent，再形成 Review / Acceptance Plan 支撑 gateEvaluation namespace + PRD + Journey + schema 初稿；后续接入 UX / Agent 初稿Evaluation and Trial Acceptance Planevaluation/finclaw/ 或 projects/finclaw/design/
Trial Ops设计邀请码、试用、反馈、人工复核、商业信号PRD + Journey + UX + EvaluationTrial Operations Planprojects/finclaw/design/
Controller控制事实源、合并分歧、维护 packet 和公共入口全部上游材料协同任务包、sync / escalation、入口更新projects/finclaw/design/、packets/

4. 团队成员参与方式​

团队成员参与 V1 设计时，应按任务包领取上下文，而不是自行扩张范围。

每个任务包至少写清：

  • 任务名称；
  • 负责 lane；
  • 本轮目标；
  • 允许读取的材料；
  • 禁止或暂不读取的材料；
  • 预期输出；
  • 验收标准；
  • 是否允许修改正式文档；
  • 是否需要回写 PRD、设计文档、evaluation 或 packet。

推荐任务包格式：

# FinClaw V1 Task Packet: <任务名>

状态：Draft / Active / Review / Accepted / Blocked
Lane：
Owner：
日期：

## 1. 目标

## 2. 允许读取

## 3. 禁止范围

## 4. 输出要求

## 5. 验收标准

## 6. 回写位置

## 7. 分歧 / 风险 / 需裁决项

任务包可以保存在工程仓库、个人域 workspace、团队协作系统或 open-cowork 中；只有会影响治理事实源、跨 lane 边界、评测口径或生态协同的内容，才需要回写本仓库。

5. Design Packet 任务包优先级​

任务包优先级必须服从 Kickoff Packet 的 Design Packet DAG。P0 表示工程启动前置设计输出；P1 表示完整 Design Packet 必交付、但可在 P0 初稿后并行推进或在试运营启动前完成的输出。

5.1 设计阶段（P-A）任务包​

优先级任务包目标依赖Gate状态
P0V1 User Journey and Interaction Flow把自然语言入口、快照、线程、刷新、checkpoint 串成完整用户路径V1 PRDEngineering-startcompleted
P0V1 Product Object and Schema Design下推 Snapshot、Thread、Checkpoint、Evidence、Advisor Output 字段对象设计 + case schemaEngineering-startcompleted
P0V1 UI / UX Interaction Design输出 C 端主页面、状态、移动端约束和反馈入口User Journey + schemaEngineering-start设计已直接产出（见 §5.3）
P0V1 Agent Orchestration Design定义顾问层、Skills、路由、分歧处理和写入对象规则User Journey + schemaEngineering-start设计已直接产出（见 §5.3）
P0V1 Evaluation Initial Plan将结构化 cases 转成评测覆盖草案和边界压力清单，并反向约束 UX / AgentJourney + schema 初稿 + PRD + casesEngineering-start draft input设计已直接产出（见 §5.3）
P0V1 Evaluation Review / Acceptance Plan在 UX / Agent 初稿后补齐工程前置、试运营和验收评测合同Evaluation Initial Plan + UX 初稿 + Agent 初稿Engineering-start / Trial-start / Acceptance设计已直接产出（见 §5.3）
P1V1 Trial Operations Plan定义邀请码、反馈、人工复核、商业信号和试运营边界PRD + Journey + UX + EvaluationTrial-start设计已直接产出（见 §5.3）

5.2 工程实现 / 试运营 / 评审阶段（P-B / P-C）任务包​

优先级任务包目标依赖Gate状态
P0V1 Engineering Implementation Alignment把 Design Packet 在新工程仓库 /Users/mlabs/Programs/CurvatureLabs/finclaw/（D-10）落地，闭环 governance-engineering-alignment §9 11 项 Action Items完整 Design PacketTrial-startactive
P0V1 Skills Domain Knowledge Review邀请 ≥ 2 位金融专家审核 7 个 Skills、6 个 Advisors、6 个 Cases 的领域深度Engineering 6 个 case 可稳定产出样本Trial-start 前置pending
P1V1 Commercial Signal Instrumentation工程化落地 §14.7 商业信号埋点、漏斗、留存、周报Engineering AL-1 ProfileConsentAcceptance gate 量化指标pending
P1V1 Human Experience Trial Execution按 v1-human-experience-trial-script.md 执行 §14.5 人工体验观察Trial-start gate 通过Acceptance gate 八维度pending

5.3 关于 5 份设计文档为什么没有「设计阶段任务包」​

UI / UX、Agent Orchestration、Evaluation Initial、Evaluation Review、Trial Ops 这 5 份设计文档在 V1 Design Packet 中直接由 Controller / 对应 lane 产出，没有再独立创建「设计产出型」task packet。原因：

  1. 这些设计的输入、输出、禁止范围、验收口径都已在 v1-design-kickoff-packet.md §4.5 Output Contract Matrix 中明确，再写一份 task packet 只会造成信息重复；
  2. 这 5 份设计的状态都是 accepted-initial-design，已通过 Controller review；
  3. 后续真正需要 task packet 化的不是「再产出一遍设计」，而是「把设计落到工程 / 试运营 / 评审」——这部分由 §5.2 的四个任务包承担。

如果未来需要对其中任一设计做大幅修订（例如 UI / UX 重构、Agent 路由重整），届时再启动一个「修订型 task packet」，不在本计划中预先创建。

当前 P-A 阶段已完成。当前主线是 §5.2 的四个工程 / 评审 / 试运营任务包，整体节奏由 v1-execution-plan-and-milestones.md 串联。

6. 协同规则​

设计阶段协同必须遵循：

  1. 三份正式入口仍是战略白皮书、产品定义、MVP 产品定义；
  2. v1-prd.md 是 V1 设计阶段的产品需求入口；
  3. v1-design-kickoff-packet.md 是设计阶段启动与分工入口；
  4. 本文是团队协同与任务包入口；
  5. 下游文档不得重新定义 FinClaw 是什么、V1 做什么或不做什么；
  6. UI / UX 图稿、Figma / OpenPencil 文件、浏览器原型都不是唯一事实源，必须回链到 Markdown 设计文档；
  7. 任何涉及真实交易、账户、私钥、自动提醒、生产 channel 或执行系统调用的内容，必须回到 Pre-Execution Checkpoint 或升级为 escalation；
  8. 分歧先进入任务包或 design review，不直接写成并列事实源。

7. 何时使用 packets / sync / escalation​

情况使用方式
单 lane 设计任务使用任务包或工程 / 协作系统，不必写入 packets/
跨 lane 的设计依赖或交接在本计划或对应设计文档中记录，必要时创建 task packet
发现会影响 Data Horizon -> FinClaw 或 FinClaw -> AI Trading Matrix 协同边界创建 packets/sync/
发现会改变产品边界、责任边界、执行边界或生态基线创建 packets/escalation/
只是 UI 细节、文案、局部组件或内部排期不进入治理仓库，留在设计 / 工程执行域

8. 输出验收​

一个设计 lane 的输出只有同时满足以下条件，才可被 Controller 接收：

  • 明确引用上游文档；
  • 没有重新定义产品边界；
  • 能映射到 V1 PRD 中的对象、路径或验收项；
  • 说明了非目标和风险；
  • 给出可被下一 lane 消费的结构；
  • 标明是否需要 schema、evaluation、sync 或 escalation 承接；
  • 如果涉及 UI / UX，说明源文件位置、导出策略和 Markdown 回链；
  • 如果涉及 Agent 或模型，说明证据边界、用户授权和执行边界。
  • 明确说明该输出服务 Design-start、Engineering-start、Trial-start 还是 Acceptance gate；
  • 若依赖尚未完成，必须标注 blocked / draft，不得被误读为工程可落地版本。

9. 当前下一步​

V1 Design Packet 已全部 accepted。当前 Controller 推进重点：

  1. 推进 V1 Engineering Implementation Alignment 任务包（active），按 v1-execution-plan-and-milestones.md M-B 阶段 闭环 11 个 Action Items；
  2. 启动 V1 Skills Domain Knowledge Review，确定 ≥ 2 位独立评审人并签 NDA；
  3. Engineering 完成 AL-1 ProfileConsent 与 AL-7 Feedback / Review queue 后，启动 V1 Commercial Signal Instrumentation；
  4. Engineering / Skills 评审 / Trial Ops 控件全部就绪后，启动 V1 Human Experience Trial Execution 进入 P-C 阶段；
  5. 每完成一个 Engineering milestone 立即刷新 v1-governance-engineering-alignment.md；
  6. 将任何跨项目边界问题转入 packets/sync/ 或 packets/escalation/，不在 PRD 中隐性扩大承诺。