FinClaw Engineering Seeds

状态：Active / Admin-provided 工程种子 最后更新：2026-05-15 用途：把 V1 Design Packet 中以散文形式描述的产品对象转译为可机器读取的工程种子（TypeScript interface / JSON sample / prompt template / eval YAML），作为 Controller / Engineering owner 实施的起点参考

1. 触发根因

2026-05-15 三方独立 audit 共识（evidence/reader-tests/2026-05-15-tri-perspective/）揭示：

• OOSO 工程师视角总评："No, can NOT start coding tomorrow" — 总实施可行性 2.1/5.0
• 核心阻塞 (FR-013 / FR-017)：
  • "Zero JSON samples for MarketCognitionSnapshot" (v1-product-object-and-schema-design.md:55-78)
  • "Skills are 'capability labels, not implementation commitments'" (v1-agent-orchestration-design.md:67-80)
  • "10 user states with no state machine diagram" (v1-user-journey-and-interaction-flow.md:39-50)
  • "Forbidden execution fields listed in prose but no validation logic" (v1-product-object-and-schema-design.md:169-186)

本目录的 seeds 是 Admin 在 FR-010（Controller-owned rewrite plan）边界下提供的"种子产物"：

• Admin 提供 1 个核心对象的完整工程化范例
• FinClaw Controller / Engineering owner 接手后按本范例为模板，扩展到其他对象 / cases / prompts / eval

2. 当前 seeds

Seed	适用 V1 对象	完整度	文件
market-cognition-snapshot	MarketCognitionSnapshot (V1 P0 主对象)	✅ 完整：types.ts + example-btc.json + prompt-template.md + eval-case.yaml	./market-cognition-snapshot/

3. 种子的边界承诺

• 不替代 V1 Design Packet：种子是 schema design 的可执行投影，不是新的产品定义
• 不锁定技术栈：types.ts 用通用 TypeScript（不含 React/Next.js/Node.js 框架特定语法）；JSON Schema 可移植；prompt template 模型无关
• 不固化业务决策：example-btc.json 是 schema 演示，不是 BTC 真实分析结论
• 不替代 evaluation/finclaw/cases/：种子的 eval-case.yaml 是 case schema 演示，FinClaw Controller 应在 cases/ 下扩展真实 cases

4. 使用流程

角色	动作
FinClaw Controller	复制 seed 到 projects/finclaw/v1-implementation/ 或 工程仓库 fin-claw/，按真实业务字段调整
FinClaw Engineering owner	把 types.ts 升级为 Zod schema 或 JSON Schema 强校验
FinClaw Evaluation owner	把 eval-case.yaml 复制到 evaluation/finclaw/cases/ 并扩展为真实 case 集
FinClaw Agent owner	把 prompt-template.md 升级为 LangGraph node prompt / OpenAI function calling spec

5. 与三方 audit 的对应

OOSO 提出的 P0 阻塞	本目录解决
Zero JSON samples for MarketCognitionSnapshot	✅ example-btc.json 是完整 sample
Skills are capability labels, not implementation commitments	🟡 prompt-template.md 是 1 个 skill 的 prompt 范例；其他 7 个 skill 由 FinClaw Agent owner 按此模板补
10 user states with no state machine diagram	🟡 types.ts 用 union type 表达 state；FinClaw Controller 可由此推导 mermaid 图
Forbidden execution fields listed in prose but no validation logic	✅ types.ts 用 type-level constraint 排除；可进一步 Zod .refine() 强校验
6 evaluation case names but no concrete prompts or expected outputs	✅ eval-case.yaml 是完整 case 范例

6. Self-discipline 声明

按 controllers/labs-fintecai-admin/state.md §7.A：

• 本 lane 新建文件 5 个（README + 1 seed 的 4 个文件）
• 本 lane 直接修改 governance/、controllers/labs-fintecai-admin/state.md、packets/sync/README.md 共 3 处
• 当前 R3 周期总产出（lane L1-L9）的 packet 比 Self-Discipline 上限：详见 controllers/labs-fintecai-admin/checkpoints/2026-05-15-r3-tri-perspective-followup.md（pending）