FinClaw V1 Design Kickoff Packet
状态：Design Control Packet / 可启动下游设计，完整 Design Packet 未完成 日期：2026-05-13 项目：FinClaw 文档级别：项目级设计控制包 上游文档：strategic-whitepaper.md、product-definition.md、mvp-product-definition.md、product-object-and-advisor-design.md、terminology-and-object-naming.md 评测承接：evaluation/finclaw/README.md、case-schema.md、cases/README.md
本文用于启动和控制 FinClaw V1 完整设计文档工作，包括 PRD、用户路径、产品对象与 schema、UI / UX 交互设计、Agent 编排设计、评测验收设计、试运营设计和实施任务拆分。
当前状态说明：本文和 FinClaw V1 PRD 已经达到“Design Kickoff + V1 PRD Draft 可启动下游设计”的状态，但不表示完整 Design Packet 已经完成。User Journey、Product Object and Schema Design、UI / UX Interaction Design、Agent Orchestration Design、Evaluation and Trial Acceptance Plan、Trial Operations Plan 仍是待产出的下游设计材料，不能直接跳过进入工程落地或试运营验收。
本文不是新的产品定义，不替代三份正式入口文档。本文的职责是把上游产品真相转译为下游团队可执行、可评审、可验收且不会漂移的共同设计契约。任何设计结论如与上游产品定义冲突，应以上游正式文档为准，或回到 FinClaw Controller 进行边界修订。
1. 启动结论
FinClaw 当前材料已经达到启动下游设计文档的条件，但尚未达到完整 Design Packet 完成状态。
启动理由：
- 三份正式入口已经收束 FinClaw 的战略定位、产品边界和第一阶段范围；
- 设计支撑文档已经下推 Market Cognition Thread（市场认知线程）和 Financial Cognition Advisor（金融认知顾问）层的核心对象、生命周期和输出契约；
evaluation/finclaw/已经具备 case schema、第一批结构化 cases 和认知边界评测字段；- 旧的中间核对文档已经被吸收，不再作为设计输入分叉；
- 第一版目标已从内部概念验证提升为面向 C 端用户正式开放试用和试运营的产品版本。
因此，下一步不应继续扩写平行产品定义，而应按本文定义的 Design Packet DAG 进入 PRD、User Journey、Product Object and Schema、UI / UX、Agent Orchestration、Evaluation and Trial Acceptance、Trial Operations 下推。下游团队只能把本文作为设计控制契约，不能把它当作完整设计交付物。
1.1 Legacy 行动语义收束
来源材料、参考项目或早期工程中出现的 Action Suggestion、ActionSuggestion、行动建议、交易建议、反弹做空、开多 / 开空、加仓 / 减仓、提醒、watchlist、target price、rating 等行动邻近语义，在 FinClaw V1 中一律按 legacy 或外部参考语义处理。
V1 正式收束规则：
- 不作为正式产品对象；
- 不作为执行指令、订单意图、交易信号或自动提醒；
- 只能被转译为
Strategy Hypothesis、Cognition-Stage Strategy Output或Pre-Execution Checkpoint； - 任何下游 UX、schema、Agent 或 evaluation 设计都必须保留“认知输出，不是执行指令”的对象和状态表达；
- 若某 lane 认为旧行动语义需要恢复为正式对象，必须走 packets/escalation/，不能在设计文档中自行扩展。
2. V1 产品目标
FinClaw V1 不是内部 demo，也不是只验证技术可行性的 MVP。
V1 应定位为：
面向 C 端个人金融参与者的正式试用 / 试运营版本，以加密市场认知为首发切片，帮助用户把过载金融信息转化为可复查、可更新、可持续维护的市场认知快照和市场认知线程，并在行动邻近场景中稳定输出执行前认知检查点，而不是执行指令。
V1 设计必须同时满足：
- 首次使用能成立；
- 高频回访能成立；
- 输出质量能被用户信任和复查；
- 线程持续维护能被用户感知；
- 责任边界能在产品结构中表达，而不只靠免责声明；
- 评测用例能覆盖主路径、失败路径和边界路径；
- 个人域多 Agents 和团队多人多 Agents 能基于同一设计材料协同推进。
3. 设计输入
3.1 必读输入
| 输入 | 用途 |
|---|---|
| strategic-whitepaper.md | 战略定位、生态角色、长期边界 |
| product-definition.md | 产品定义、用户、场景、能力边界、非目标 |
| mvp-product-definition.md | 第一阶段产品目标、主路径、对象优先级、验收边界 |
| product-object-and-advisor-design.md | Thread 生命周期、金融认知顾问职责、输出契约 |
| evaluation/finclaw/case-schema.md | 结构化评测字段、执行边界和运行结果字段 |
| evaluation/finclaw/cases/README.md | 第一批机器可读 cases 的对象层级和场景路径 |
3.2 证据输入
4. V1 设计输出清单
4.1 完整 Design Packet 必须产出
| 文档 | 目标 | 主要责任 |
|---|---|---|
| FinClaw V1 PRD | 定义正式试用 / 试运营版本的用户、场景、功能、非目标、验收口径 | Product / Controller |
V1 User Journey and Interaction Flow | 定义 C 端用户从首次进入到持续线程维护的完整路径 | Product + UX |
V1 Product Object and Schema Design | 将 Market Cognition Snapshot、Market Cognition Thread、Pre-Execution Checkpoint、证据字段、顾问输出映射为 schema | Product + Engineering |
V1 UI / UX Interaction Design | 定义核心页面、状态、控件、空态、错误态和移动端约束 | UX + Frontend |
V1 Agent Orchestration Design | 定义 FinSkills、金融认知顾问、Claw 编排和用户请求路由 | Agent / Engineering |
V1 Evaluation and Trial Acceptance Plan | 将 case schema 和第一批 cases 转为试用验收计划 | Evaluation |
V1 Trial Operations Plan | 定义邀请码、试用路径、反馈、人工复核、商业信号和试运营边界 | Trial Ops + Product |
| V1 Collaboration and Task Packet Plan | 拆分个人域多 Agents / 团队多人多 Agents 的协作任务 | Controller |
4.2 第二批可并行产出
| 文档 | 触发条件 |
|---|---|
V1 Data and Persistence Design | 产品对象 schema 初稿稳定后 |
V1 API Contract Design | UI / Agent / persistence 边界稳定后 |
V1 Model and Provider Policy | 需要明确平台认证模型、BYOM、自有专家模型训练资产边界时 |
V1 Channel Extension Design | Web 主路径稳定后，再评估 Telegram / Discord / 微信 / 飞书等外部 channel |
4.3 Design Packet DAG
Design Packet 的产出顺序以依赖关系为准，不以文档列表顺序或 lane 偏好为准。
flowchart TD
A["Formal Entry Docs<br/>Strategic / Product / MVP"] --> B["V1 PRD"]
A --> C["Product Object and Advisor Design"]
A --> D["Terminology and Object Naming"]
B --> E["V1 User Journey and Interaction Flow"]
B --> F["V1 Product Object and Schema Design"]
C --> F
D --> E
D --> F
E --> G["V1 UI / UX Interaction Design"]
F --> G
E --> H["V1 Agent Orchestration Design"]
F --> H
F --> I0["V1 Evaluation Initial Plan"]
E --> I0
I0 --> G
I0 --> H
G --> I1["V1 Evaluation Review / Acceptance Plan"]
H --> I1
I0 --> I1
E --> J["V1 Trial Operations Plan"]
G --> J
I1 --> J
I1 --> K["Engineering-start Review"]
J --> L["Trial-start Review"]
K --> M["Engineering Implementation"]
L --> N["Trial / Acceptance"]
依赖解释：
- PRD 是产品需求入口，但不承载 schema、UI 或 Agent 细节；
- User Journey 和 Product Object and Schema 是两个 P0 前置输出，必须先于 UI / UX 和 Agent Orchestration；
- Evaluation 分为
Initial Plan和Review / Acceptance Plan两态：Initial Plan在 Journey + schema 初稿后立即启动，用于反向约束 UX、Agent 和 Trial Ops；Review / Acceptance Plan在 UX / Agent 初稿后补齐 review pass，用于 Engineering-start、Trial-start 和 Acceptance gate； - Agent Orchestration 同时依赖 schema 和 User Journey，因为澄清、降级、人工复核、敏感输入和行动邻近触发点都来自用户路径；
- Trial Operations Plan 是完整 Design Packet 的必交付物，工程启动前可只完成试运营框架，试运营启动前必须完成可执行版本。
4.4 Gate Definition
| Gate | 允许进入 | 必须满足 | 不允许误读为 |
|---|---|---|---|
| Design-start gate | 下游设计启动 | 本文、V1 PRD、对象设计、术语命名、evaluation namespace 可用 | 可进入工程落地 |
| Engineering-start gate | 工程仓库方案拆解和实现 | PRD、User Journey、Product Object and Schema、UI / UX 关键路径、Agent Orchestration 初稿、Evaluation Review / Acceptance Plan 工程前置部分通过 Controller review | 可正式试运营 |
| Trial-start gate | C 端试用 / 试运营 | Engineering 验证通过；Evaluation and Trial Acceptance Plan 可执行；Trial Operations Plan 完成邀请码、反馈、人工复核、风险响应和商业信号规则 | 已达到最终验收 |
| Acceptance gate | V1 成立判定 | 试运营数据、人工体验、评测用例、边界压力和商业信号达到 PRD 验收口径 | V1 后续无需迭代 |
4.5 Output Contract Matrix
| 输出物 | 输入 | 输出 | 禁止范围 | 验收 gate | 下游消费者 / 回写 |
|---|---|---|---|---|---|
| V1 PRD | 三份正式入口、对象设计、术语命名 | 用户、场景、非目标、主路径、验收口径 | schema 细节、UI 细节、工程实现 | Design-start | Journey、Schema、UX、Agent、Evaluation、Trial Ops |
| User Journey and Interaction Flow | PRD、对象设计、术语命名、cases | 用户路径、状态、触发点、失败 / 降级 / 人工复核路径 | 高保真 UI、数据库 schema、真实交易 | Engineering-start | UX、Agent、Evaluation、Trial Ops |
| Product Object and Schema Design | PRD、对象设计、case schema | Snapshot、Thread、Checkpoint、Evidence、Advisor Output、Profile / Consent 字段 | 订单、信号、账户、私钥、数据库实现冻结 | Engineering-start | UX、Agent、Evaluation、API / persistence |
| UI / UX Interaction Design | PRD、Journey、Schema | 页面、组件、状态、移动端 / 桌面端交互、源文件策略 | 把图稿作为唯一事实源、绕过责任边界 | Engineering-start | Engineering、Evaluation、Trial Ops |
| Agent Orchestration Design | PRD、Journey、Schema、顾问设计 | FinSkills、金融认知顾问、路由、分歧处理、写入对象规则 | 恢复行动建议、自动执行、生产 channel 调用 | Engineering-start | Engineering、Evaluation |
| Evaluation Initial Plan | PRD、Schema 初稿、Journey、cases | case 覆盖草案、评分草案、边界压力清单、UX / Agent 反向约束项 | 等 UX / Agent 完成后才启动、只做事后评分、只测标准金融问答 | Engineering-start draft input | UX、Agent、Controller |
| Evaluation Review / Acceptance Plan | Evaluation Initial Plan、UX 初稿、Agent 初稿、Trial Ops 草案 | 工程前置验收、试运营验收、人工体验脚本、回归验收、停止 / 回滚评测条件 | 推翻 Initial Plan、绕过 UX / Agent review、替代 Trial Ops | Engineering-start / Trial-start / Acceptance | Controller、Engineering、Trial Ops |
| Trial Operations Plan | PRD、Journey、UX、Evaluation | 邀请码、试用流程、反馈、人工复核、风险响应、商业信号 | 账户接入、收费承诺、生产客服和合规承诺 | Trial-start | Trial Ops、Controller、Acceptance review |
5. C 端 UI / UX 设计要求
V1 必须包含 UI / UX 交互设计。原因是本版本目标不是内部验证，而是面向 C 端正式开放试用和试运营。
UI / UX 设计不得只停留在功能说明，应至少覆盖：
- 首次进入路径；
- 自然语言提问入口；
- Market Cognition Snapshot（市场认知快照）阅读体验；
- 从快照保存为 Market Cognition Thread（市场认知线程）的交互；
- Thread 刷新、变化对比、暂停、关闭、复盘；
- 风险与反方挑战的可读呈现；
- 行动邻近语言进入 Pre-Execution Checkpoint 的边界呈现；
- 证据质量、数据延迟、不可用、冲突、低置信等状态表达；
- 模型模式、来源限制和用户授权状态表达；
- 移动端和桌面端的主要布局；
- 空态、加载态、失败态、降级态；
- 用户反馈、试运营问题收集和人工复核入口。
V1 交互形态应采用“自然语言进入 + 结构化对象沉淀”的组合，而不是纯 chat 或纯表单。
6. UI / UX Tools and Skills Discovery
V1 设计启动时应设置一个独立的 UI / UX 工具与 Skills 发现任务，但工具栈必须收敛，避免为一次 V1 设计启动引入过多平行工具。
V1 UI / UX 工具只保留最多 3 个槽位：
| 槽位 | V1 默认选择 | 备选 / 评估对象 | 适合用途 |
|---|---|---|---|
| 治理事实源 | Markdown + Mermaid | 不替代 | PRD、对象关系、流程、Agent 编排、验收关系的权威表达 |
| 正式 UI 设计源 | Figma / 类 Figma 工具 | OpenPencil 作为实验性候选 | 组件库、关键页面、高保真交互、团队协作、handoff |
| 可运行交互原型 | 浏览器可运行原型 | Open Design 作为快速探索 / 生成式原型候选 | 真实交互、响应式布局、移动端 / 桌面端截图验证 |
Pencil、Canva、临时白板和演示型工具不进入 V1 核心工具栈；如确需使用，只能作为一次性辅助材料，不得成为产品交互事实源。
UI / UX Skills 也应保持收敛，优先覆盖三类能力：
- 产品交互架构：把 V1 主路径、对象、状态和边界转译为可设计的用户流；
- C 端 UI 设计：产出移动端和桌面端关键页面、组件、空态、失败态和试运营反馈入口；
- 可运行原型验证：把关键交互落到浏览器原型，并用截图 / 走查验证可用性。
工具选择应遵循：
- 治理仓库中的权威设计事实仍以 Markdown 文档为准；
- UI / UX 工具产物必须能反向链接到 PRD、对象 schema 和验收 case；
- 三个槽位可以分工，但不得再扩展为一串平行候选工具；
- 若使用外部协作工具，必须记录源文件位置、版本、owner 和导出策略；
- 不得让不可追溯的图片或临时白板成为唯一事实源。
推荐启动任务：
围绕 Markdown + Mermaid、Figma / 类 Figma、浏览器可运行原型三个槽位完成一次轻量评估；OpenPencil 只作为正式 UI 设计源的实验性候选，Open Design 只作为可运行原型 / 生成式探索候选。输出 V1 UI / UX 工具建议、源文件管理规则和不采用工具清单。
7. 个人域多 Agents / 团队多人多 Agents 协同要求
V1 Design Packet 必须支持两类协同：
- 个人域多 Agents：一个 owner 通过多个专业 Agents 并行推进产品、UX、schema、评测、工程任务拆分；
- 团队多人多 Agents：多个人 / 多个团队域 Agents 基于同一组事实源分工推进，并能回写治理仓库。
协同原则：
- 所有 Agents 的上游事实源相同；
- 不允许每个 Agent 自己重新定义 FinClaw 产品边界；
- 所有新增设计文档必须声明上游文档、文档级别、适用范围和非目标；
- 任务拆分应围绕对象和主路径，而不是围绕个人偏好；
- 分歧进入 issue / packet / design review，不直接写成并列事实源；
- 任何涉及执行、交易、账户、私钥、真实提醒、生产 channel 的内容必须回到认知边界和执行前认知检查点表达。
8. 推荐协作分工
| Lane | 责任 | 输入 | 输出 |
|---|---|---|---|
| Product / PRD | 定义 V1 范围、用户、场景、功能和验收 | 三份正式入口 + 本 Packet | V1 PRD |
| UX / Interaction | 定义 C 端主路径、页面、状态、移动端和试运营体验 | V1 PRD + Journey + schema | User Journey + UI / UX 交互设计 |
| Object / Schema | 定义快照、线程、checkpoint、证据、顾问输出字段 | 对象设计 + case schema | Product Object and Schema Design |
| Agent Orchestration | 定义 FinSkills、顾问层、Claw 编排、分歧处理 | PRD + Journey + schema | Agent 编排设计 |
| Evaluation | 设计用例、评分、试运营验收和回归测试 | case-schema + cases + PRD + schema 初稿 | V1 验收计划 |
| Trial Ops | 设计邀请码、试用路径、反馈收集、指标和商业信号 | PRD + Journey + UX + Evaluation | 试运营计划 |
| Controller | 维护事实源、合并分歧、发起 packet、控制文档层级 | 全部材料 | 协作任务包和回写规则 |
9. 第一批 PRD 范围
V1 PRD 应覆盖以下内容：
- 目标用户和首发市场；
- 用户问题和 Jobs-to-be-Done；
- 第一阶段主路径；
- 核心对象：Market Cognition Snapshot（市场认知快照）、Market Cognition Thread（市场认知线程）、Pre-Execution Checkpoint（执行前认知检查点）；
- 金融认知顾问层如何对用户可见或不可见；
- 证据质量和数据限制如何表达；
- 自然语言入口与结构化对象沉淀的关系；
- C 端试用和试运营的最小可用体验；
- 模型策略、用户自带模型和平台认证模型的第一版边界；
- 外部 channel 是否进入 V1，若进入，必须限定为输出 / 入口扩展而不是权威事实源；
- 风险与责任边界；
- 不做项；
- 验收指标和失败条件；
- 下游 schema、UI、Agent、评测任务列表。
10. V1 非目标
V1 不做：
- 自动下单；
- 投资收益承诺；
- 真实资金账户接入；
- 私钥管理；
- 无授权调仓；
- 全市场扫描器；
- 机构级投研平台；
- 完整组合管理；
- 自动交易信号服务；
- 大规模技能市场；
- 多人协作审计系统；
- 未经验证的全渠道运营系统。
V1 可以讨论策略、风险、观察信号、提醒需求、组合暴露、机会候选和行动前检查，但必须落在认知输出、条件化假设或执行前认知检查点。
11. 验收启动标准
Design phase 可以启动，当且仅当以下条件成立：
| 条件 | 当前状态 |
|---|---|
| 三份正式入口清晰 | 已成立 |
| 设计支撑入口存在 | 已成立 |
| 旧中间文档已吸收 | 已成立 |
| case schema 和第一批 cases 可用 | 已成立 |
| V1 目标从内部 MVP 调整为 C 端试用 / 试运营 | 本 Packet 确认 |
| UI / UX 设计进入第一批输出 | 本 Packet 确认 |
| 多 Agents 协作要求进入设计启动范围 | 本 Packet 确认 |
| User Journey 设计文档 | 未完成，需先执行 P0 task packet |
| Product Object and Schema Design | 未完成，需先执行 P0 task packet |
| UI / UX Interaction Design | 未完成，依赖 User Journey 和 schema |
| Agent Orchestration Design | 未完成，依赖 User Journey 和 schema |
| Evaluation and Trial Acceptance Plan | 未完成；Initial Plan 在 Journey + schema 初稿后立即启动，Review / Acceptance Plan 在 UX / Agent 初稿后补齐 |
| Trial Operations Plan | 未完成，是完整 Design Packet 必交付物，试运营启动前必须完成 |
11.1 完整 Design Packet 完成标准
完整 Design Packet 只有同时满足以下条件，才可被 Controller 提交给工程和试运营审计：
- 本文列出的所有必交付输出物都已存在，并通过各自验收 gate；
- PRD、Journey、Schema、Evaluation Initial Plan、UX、Agent、Evaluation Review / Acceptance Plan、Trial Ops 的依赖关系与本文 DAG 一致；
- 每份输出物都声明输入、输出、禁止范围、验收标准、回写位置和下游消费者；
Action Suggestion、行动建议、反弹做空、开多 / 开空等 legacy 语义没有被恢复为正式对象；- 敏感信息、画像确认、凭证拒收、用户授权、训练资产隔离均标注为待实现能力和验收项，而不是已实现事实；
- Evaluation Initial Plan 已在 Journey + schema 初稿后反向约束 UX / Agent，Evaluation Review / Acceptance Plan 已覆盖主路径、失败路径、边界路径、真实用户模糊输入和行动邻近压力；
- Trial Ops 已定义试用资格、反馈、人工复核、风险响应、商业信号和停止 / 回滚条件；
- 工程实现范围、试运营范围和后续优化范围被明确区分。
12. 下一步执行顺序
推荐顺序：
- 写 FinClaw V1 PRD；
- 执行 P0 User Journey task packet，产出
V1 User Journey and Interaction Flow； - 执行 P0 Product Object and Schema task packet，产出
V1 Product Object and Schema Design； - 在 Journey + schema 初稿出现后立即启动
V1 Evaluation Initial Plan，用它反向校验 UX 和 Agent； - 在 User Journey 和 schema 初稿稳定后，并行启动
V1 UI / UX Interaction Design与V1 Agent Orchestration Design； - 在 PRD、Journey、UX、Agent 和 Evaluation Review 初稿稳定后，产出
V1 Trial Operations Plan； - 由 Controller 汇总分歧，形成后续工程 / 设计任务 packets，并按 Gate Definition 决定是否进入工程落地或试运营验收。
13. Controller 指令
FinClaw Controller 后续应保持：
- 不新增平行产品定义文档；
- 不把 UI / UX 图稿作为唯一事实源；
- 不让参考项目评测规则反向扩大 FinClaw V1 产品承诺；
- 不让个人域 Agents 或团队 Agents 各自形成未对齐的产品边界；
- 所有 PRD、UX、schema、Agent、评测文档都必须引用本 Packet 和上游正式入口。
需要 Labs-FinTecAI Controller 协助的公共层动作另行发出，不在本 Packet 中直接修改公共索引。