跳到主要内容

【历史参考】 本文保留 FinBayes 早期工程化讨论和旧实现上下文，便于追溯。当前战略、产品定义和工程化落地以 engineering/ 子目录为准。

FinBayes Goal 精简上下文包

0. 用途​

本文是后续 /goal 执行的默认必读上下文。它用于替代“每个 Goal 启动时必须读取大量文档”的做法，降低上下文消耗。

每个 Goal 默认只需要读取：

  1. 本文；
  2. 当前 Goal 对应的审计 / Contract / Closeout 文档；
  3. 目标实施仓当前的 AGENTS.md、README.md、pyproject.toml 或等价入口文件；
  4. 当前要修改的源代码文件。

完整产品定义、基线改造设计和参考项目报告是 drill-down 材料，只在本文不足以裁决时再读取。

1. 产品目标​

FinBayes 要做成一个金融信息链路「感知 - 认知 - 执行」中的认知层 AI Native 应用。

第一阶段要实现的是金融认知任务系统：

它不是单一金融 Chatbot，不是普通 TUI 工具，也不是交易执行系统。

2. 产品完成态​

第一阶段完成后，用户应该能：

  • 用自然语言或任务模板提出金融问题；
  • 得到金融角度的结构化认知结果，而不是普通聊天文本；
  • 围绕同一问题继续追问、验证和复盘；
  • 将标的、主题、事件、板块或叙事加入 Watchlist；
  • 通过 Web、TUI / CLI、MCP 或 Channel 获得同质量核心结果；
  • 在系统使用中形成动态认知画像；
  • 获得有条件行动判断，但不进入交易执行。

工程上必须形成四层对象：

  1. 金融认知任务层；
  2. 金融认知运行层；
  3. 结构化结果层；
  4. 连续认知层。

3. 两层金融任务类型​

3.1 用户意图大类​

  • 解释；
  • 分析；
  • 对比；
  • 验证 / 复盘；
  • 风险识别；
  • 行动判断。

3.2 内部任务执行类型​

  • 新闻 / 事件影响分析；
  • 单标的基本面分析；
  • 技术面状态分析；
  • 链上数据解读；
  • 宏观数据解读；
  • 财报 / 公告解读；
  • 多资产横向比较；
  • 观点反证检查；
  • 历史判断复盘；
  • 风险清单生成；
  • 条件化行动判断；
  • 结构化报告生成。

用户意图大类用于交互和产品理解；内部任务执行类型用于工程调度、测试和评估。一个用户问题可以映射为多个内部任务执行类型。

4. 验收场景的正确用法​

验收场景是覆盖性样例，不是硬编码目标。实现必须证明两层任务体系成立，而不是只支持几个字符串。

样例：

样例应证明的能力
现在还能追 SOL 吗？行动判断意图 -> 条件化行动判断 + 风险清单 + crypto market pack
NVDA 财报后现在怎么看？分析意图 -> 财报 / 公告解读 + 单标的基本面分析 + 风险清单 + us_stocks market pack
我之前看多 ETH 的理由还成立吗？验证 / 复盘意图 -> 历史判断复盘 + 观点反证检查
把这个主题加入关注，后面有变化提醒我复盘。Watchlist 对象 + 后续认知刷新候选，不触发交易执行
外部 Agent 通过 CLI/MCP 请求分析市场事件同一 FinancialCognitionTask 和 StructuredCognitionResult 契约可被外部入口复用

5. 仓库策略​

不得在 martinpmm/Finclaw 参考仓 参考仓中直接实施 FinBayes 改造。该仓只读，用于理解基线能力。

本轮工程实施目录已经确定为：

FinBayes 工程仓

该目录当前是干净空目录，尚不是 git 仓库。G0 不再负责“选择仓库”，而是负责初始化这个新基线仓、导入或引用 martinpmm/Finclaw 参考基线、建立最小工程入口，并产出基线审计。

后续执行不得回退到旧 旧 FinClaw 工程仓，也不得把 martinpmm/Finclaw 参考仓 当成可写实施仓。

5.1 /goal 三步指令​

G0：初始化并审计新基线仓​

在 FinBayes 工程仓内完成 FinBayes G0。

只读参考：
- projects/finbayes/legacy/goal-compact-context.md
- martinpmm/Finclaw 参考仓

要求：
1. 不得改写 martinpmm/Finclaw 参考仓。
2. 确认 FinBayes 工程仓 当前状态；若尚未初始化 git，则初始化为新的 FinBayes 基线仓。
3. 基于 martinpmm/Finclaw 的架构和代码形态，建立 FinBayes 后续改造的起点；采用复制、fork、worktree 或显式导入方案时必须说明理由。
4. 读取新基线仓的 AGENTS.md、README.md、pyproject.toml 或等价入口；若不存在，创建最小工程说明和后续审计文档目录。
5. 产出 FinBayes 工程仓 docs/design/finbayes-g0-baseline-audit.md，记录仓库初始化方式、参考基线来源、当前模块结构、测试入口、G1 触达边界和续接方式。

G1：实现最小完整产品闭环​

在 FinBayes 工程仓内完成 FinBayes G1。

默认只读：
- projects/finbayes/legacy/goal-compact-context.md
- FinBayes 工程仓 docs/design/finbayes-g0-baseline-audit.md

目标：
实现用户输入 -> 意图识别 -> 金融认知任务 -> Agents/Skills 调度 -> StructuredCognitionResult -> Session/Watchlist/外部入口可复用的最小闭环。

必须落地：
1. 用户意图大类：解释、分析、对比、验证/复盘、风险识别、行动判断。
2. 内部任务执行类型：新闻/事件影响分析、单标的基本面分析、技术面状态分析、链上数据解读、宏观数据解读、财报/公告解读、多资产横向比较、观点反证检查、历史判断复盘、风险清单生成、条件化行动判断、结构化报告生成。
3. crypto 与 us_stocks 至少两个 market pack。
4. Product Contract 文档：FinBayes 工程仓 docs/design/finbayes-product-contract.md。
5. 样例场景只能作为覆盖样例，不允许硬编码问题字符串。

G2：多入口一致性与最终硬化​

在 FinBayes 工程仓内完成 FinBayes G2。

默认只读：
- projects/finbayes/legacy/goal-compact-context.md
- FinBayes 工程仓 docs/design/finbayes-g0-baseline-audit.md
- FinBayes 工程仓 docs/design/finbayes-product-contract.md

目标：
在不重写 G1 Product Contract 的前提下，让 Chat / TUI / CLI / MCP / Channel 共用同一任务与结果契约；补齐 Watchlist heartbeat 候选、结构化摘要分发、回归测试和最终 closeout。

6. 非执行边界​

FinBayes 可以输出：

  • 倾向判断；
  • 条件化建议；
  • 场景分歧；
  • 观察动作；
  • 验证动作；
  • 风险和反方证据；
  • 不确定性说明。

FinBayes 不允许输出或执行：

  • 无条件买卖指令；
  • 自动下单；
  • 调仓执行；
  • 账户操作；
  • 资金划转；
  • 自动交易触发。

7. Drill-down 文档​

仅在需要更完整语境时读取：

  • projects/finbayes/legacy/product-definition.md
  • 历史基线改造材料（已由当前工程化文档承接，不作为默认读取对象）
  • projects/finbayes/legacy/goal-execution-plan.md
  • projects/finbayes/legacy/goal-recovery-handoff.md
  • commons/references/finclaw/martinpmm-finclaw-baseline-transformation-evaluation.md