跳到主要内容

FinClaw

金融认知与研究分析中枢——把信息、上下文、方法论和模型能力转化为结构化、可复查、可继续推理的金融认知。

关键边界：FinClaw 输出策略假设、信号理解、决策支持；不直接完成真实交易执行。真实交易由 AI Trading Matrix 在授权、审计、风控边界内承接。

第一次进入？​

按你的角色选一条最短路径：

角色 / 意图先读
理解 FinClaw 是什么strategic-whitepaper.md → product-definition.md
理解 V1 阶段要做什么mvp-product-definition.md → design/v1/v1-prd.md
接入 V1 设计协作design/v1/v1-design-kickoff-packet.md → design/v1/v1-collaboration-and-task-packet-plan.md
理解 V1 执行节奏与里程碑design/v1/v1-execution-plan-and-milestones.md → design/v1/v1-governance-engineering-alignment.md
理解 V1 工程化启动决策design/v1/v1-engineering-kickoff-decisions.md → design/v1/v1-model-and-provider-policy.md
接入 V1 工程化技术蓝图（Wave 1：核心架构）design/v1/v1-tech-stack-and-architecture-design.md → design/v1/v1-data-and-persistence-design.md → design/v1/v1-api-contract-design.md
接入 V1 UI / 可观测 / 记忆 / 成本设计（Wave 2：补齐四件套）design/v1/v1-ui-prototype-and-design-system.md → design/v1/v1-observability-and-telemetry-design.md → design/v1/v1-memory-and-personalization-design.md → design/v1/v1-cost-and-token-budget-design.md
理解 V1 多 Agent 协同执行协议design/v1/v1-multi-agent-execution-protocol.md → design/v1/v1-task-packet-context-budget-schema.md → design/v1/v1-handoff-anchor-template.md → design/v1/v1-multi-agent-coordination-plan.md
理解产品对象与领域语言design/foundation/product-object-and-advisor-design.md → design/foundation/terminology-and-object-naming.md
接入 V1 用户旅程 / Schema / UI / Agent / Evaluation见下方 V1 设计包
接入 V1 试运营 / 验收 / 商业信号design/v1/v1-human-experience-trial-script.md → design/v1/v1-commercial-signal-instrumentation-design.md
接入评测与参考体验evaluation/finclaw/README.md → reference-experience/README.md

文档地图​

Canonical（正式事实源）​

文档角色
strategic-whitepaper.mdFinClaw 完整态战略、产品定位与生态位置
product-definition.md从战略下推：目标用户、核心场景、产品对象、能力结构与非目标
mvp-product-definition.md从产品定义下推：第一阶段目标用户、功能范围、系统设计与验收边界

Foundation（跨版本设计基线）​

文档角色
design/foundation/product-object-and-advisor-design.mdFinClaw 产品对象模型与 Advisor 角色设计
design/foundation/terminology-and-object-naming.md领域语言与对象命名约定

V1 设计包​

V1 阶段的所有设计产出统一在 design/v1/ 下。

文档角色
v1-design-kickoff-packet.mdV1 设计启动 packet 与任务路线
v1-prd.mdV1 PRD（草稿）
v1-collaboration-and-task-packet-plan.mdV1 协作模型与 task packet 规划
v1-user-journey-and-interaction-flow.mdV1 用户旅程与交互流程
v1-product-object-and-schema-design.mdV1 产品对象与 Schema 设计
v1-ui-ux-interaction-design.mdV1 UI / UX 交互设计
v1-agent-orchestration-design.mdV1 Agent 编排设计
v1-evaluation-initial-plan.mdV1 评测初步方案
v1-evaluation-review-and-acceptance-plan.mdV1 评测复核与验收方案
v1-trial-operations-plan.mdV1 试运营方案
v1-execution-plan-and-milestones.mdV1 执行计划与里程碑
v1-governance-engineering-alignment.mdV1 治理库 ↔ 工程仓库对齐快照
v1-human-experience-trial-script.mdV1 人工体验验收可执行脚本（§14.5）
v1-commercial-signal-instrumentation-design.mdV1 商业信号采集设计（§14.7）
v1-skills-domain-knowledge-review-packet.mdV1 Skills / Advisor 领域知识外部评审包
v1-engineering-kickoff-decisions.mdV1 工程化启动前的硬性决策固化（provider、BYOM、trial、kill criteria 等）
v1-model-and-provider-policy.mdV1 模型与 provider 策略 outline（GPT-5.5 + Kimi K2.6 + BYOM）
v1-tech-stack-and-architecture-design.mdV1 技术栈与服务架构（B-1）：Backend / Frontend / LLM Provider Layer / 仓库骨架 / 单机部署 / 旧仓库迁移
v1-data-and-persistence-design.mdV1 数据与持久化（B-2）：14 类对象、Filesystem + JSONL、ID / 版本 / refresh 语义、Retention / Privacy / RDB 迁移路径
v1-api-contract-design.mdV1 API 与 SSE 契约（B-3）：REST endpoint 全表、SSE 事件清单、鉴权 / 错误 / 限流、前端 adapter contract
v1-ui-prototype-and-design-system.mdV1 UI 原型与设计系统（B-4）：Design Tokens、组件清单（shadcn 二次封装）、关键交互原型、边界 / 拒绝 UX、Frontend lint 守门
v1-observability-and-telemetry-design.mdV1 可观测与遥测（B-5）：logs / metrics / traces 三类、Health endpoint、错误捕获 V1 Lite、Cost Telemetry Hook、Privacy 边界
v1-memory-and-personalization-design.mdV1 记忆与个性化（B-6）：UserContext / ProfileConsent / Persona Drift、记忆写入触发、按 route 选择性载入、Personalization 边界、Drift Detection、Export / Delete UX
v1-cost-and-token-budget-design.mdV1 成本与 token 预算（B-7）：Provider unit cost、路由经济学、Per-user / Per-route budget cap、Failover cost、BYOM cost-shift、Tier-1~4 降级路径、Trial alarm
v1-multi-agent-execution-protocol.mdV1 工程化期间多 Agent 并行协作的执行契约
v1-task-packet-context-budget-schema.mdTask packet / sub-packet 必须遵守的 context 预算字段标准
v1-handoff-anchor-template.mdSub-packet 闭环完成时产出的 hand-off anchor 标准模板
v1-multi-agent-coordination-plan.mdV1 工程化期间多 Agent 协同的实施计划（Agent 分配、worktree、并行图、监控）

Task Packets（V1 协作工作包）​

文档角色状态
design/task-packets/v1-user-journey-and-interaction-flow-task-packet.mdV1 用户旅程与交互流程（设计阶段产出包）completed
design/task-packets/v1-product-object-and-schema-design-task-packet.mdV1 产品对象与 Schema 设计（设计阶段产出包）completed
design/task-packets/v1-engineering-implementation-task-packet.mdV1 工程实现与对齐（Engineering 阶段总包）active
design/task-packets/v1-skills-domain-knowledge-review-task-packet.mdV1 Skills 领域知识专家评审pending
design/task-packets/v1-human-experience-trial-execution-task-packet.mdV1 人工体验试运营执行pending
design/task-packets/v1-commercial-signal-instrumentation-task-packet.mdV1 商业信号埋点工程化pending

Reference Experience​

文档角色
reference-experience/README.mdFinClaw 参考体验与对照分析入口
reference-experience/aifinlab-root-skills-taxonomy-execution-plan.mdaifinlab skills/ 982/1022 root SKILL.md 分批分类执行计划（Codex 异步）
reference-experience/sharedocs-finclaw-ui-mvp-design.md团队成员 ShareDocs UI MVP 设计的逐字导入（视觉基线 + V1 映射 + 增补项）

Hand-off Anchors​

路径角色
handoff-anchors/README.mdV1 工程化期间 sub-packet 闭环结论的归档目录 + 索引

与兄弟项目的结构差异​

FinClaw 文档结构与 Data Horizon / Trading Matrix 不同——这是因为成熟度不同：

维度FinClawData HorizonTrading Matrix
阶段已下推到 PRD 和 V1 设计reference-evaluation prealignmentreference-evaluation prealignment
入口本文（项目 README）README.mdproject-anchor.md
核心事实源strategic-whitepaper / product-definition / mvp-product-definitionproject-anchor / inherited-context / current-stateproject-anchor / inherited-context / current-state
设计层foundation/ + v1/ + task-packets/output-object-inventory（仅证据画像）current-practice-profile（仅证据画像）
评测层evaluation/finclaw/待建待建

后续若 Data Horizon 或 Trading Matrix 推进到 PRD 和设计阶段，应参考本目录结构（thin entry README + canonical + foundation + v1 + task-packets）。

Controller 恢复​

角色入口
FinClaw Controllercontrollers/finclaw/state.md

相关协同​

类型入口
跨项目同步packets/sync/
升级请求packets/escalation/
接入规则ACCESS_GUIDE.md