跳到主要内容

FinClaw V1 Task Packet: Engineering Implementation Alignment（INDEX）

状态：Active as Index / 已切片为 8 个 sub-packet 日期：2026-05-16 Lane：Engineering Owner：FinClaw Controller 分发，Engineering 团队 / AI Coding Agent 承接

本 packet 已迁移为 index packet：原细节已下推到 8 个 sub-packet。本文件不再承载具体实现指令，仅作 sub-packet 列表 + 顺序 + 当前状态汇总。

1. 总目标​

把 V1 完整 Design Packet 在新工程仓库 /Users/mlabs/Programs/CurvatureLabs/finclaw/（D-10）中落地为可运行的 V1 系统，闭环 v1-governance-engineering-alignment.md §9 全部 11 项 Action Items（AL-1 ~ AL-11），通过 v1-execution-plan-and-milestones.md M-B10 Trial-start review。

2. Sub-Packet 列表​

#Sub-Packet覆盖 AL依赖Budget Zone状态
1v1-eng-impl-sub-1-profile-consentAL-1—green (45K)pending
2v1-eng-impl-sub-2-sensitive-input-handlingAL-2sub-1green (53K)pending
3v1-eng-impl-sub-3-training-asset-candidateAL-3sub-1, sub-2green (42K)pending
4v1-eng-impl-sub-4-refresh-diff-viewAL-5—green (48K)pending
5v1-eng-impl-sub-5-save-thread-sheetAL-6sub-1green (45K)pending
6v1-eng-impl-sub-6-feedback-review-queueAL-7sub-1, sub-2 (弱依赖)green (49K)pending
7v1-eng-impl-sub-7-skill-naming-and-testsAL-4 + AL-8 + AL-9 + AL-11—green (60K)pending
8v1-eng-impl-sub-8-deprecate-old-docsAL-10—green (26K)pending

3. 推荐执行顺序​

flowchart TD
  S1[sub-1 ProfileConsent] --> S2[sub-2 Sensitive Input]
  S2 --> S3[sub-3 Training Asset Candidate]
  S1 --> S5[sub-5 Save Thread Sheet]
  S1 --> S6[sub-6 Feedback / Review Queue]
  S2 --> S6
  S4[sub-4 Refresh Diff View]
  S7[sub-7 Skill Naming + 3 项 alignment 测试]
  S8[sub-8 Deprecate Old Docs]
  S4 --> TS[Trial-start gate]
  S5 --> TS
  S6 --> TS
  S3 --> TS
  S7 --> TS
  S8 --> TS

并行机会（按 v1-multi-agent-execution-protocol.md §5.1 文件所有权矩阵）：

  • sub-4 / sub-5 / sub-6 可与 sub-1 / sub-2 / sub-3 部分并行（前者偏 frontend / api routes，后者偏 agent / models.py）；
  • sub-7 可在 sub-1 ~ sub-3 完成后并行启动；
  • sub-8 在旧仓库执行，与所有新仓库 sub-packet 完全独立。

4. 整体验收标准​

进入 v1-execution-plan-and-milestones.md M-B10 Trial-start review 必须同时满足：

  1. 8 个 sub-packet 全部 status: done；
  2. v1-evaluation-review-and-acceptance-plan.md §2 Engineering-Start Review 8 项最低通过条件全部满足；
  3. v1-governance-engineering-alignment.md 中所有 object / layer / route / UI / API 状态 ≥ aligned-initial，无 forbidden-found；
  4. 6 个 V1 case 全部 grade ≥ B（PreExecutionCheckpoint case 必须 ≥ A 等价、零 forbidden 字段）；
  5. 工程仓库旧 docs/design/01..09 已 deprecated（sub-8 完成）；
  6. 本 index packet 状态由 active-as-index 转为 completed 必须由 Controller 在 8 个 sub-packet 全部 done 后审核。

5. 全局禁止范围（适用所有 sub-packet）​

  • 不新建 V1 范围外的对象 / 字段；
  • 不恢复 Action Suggestion / 行动建议 / 反弹做空 / 开多 / 开空 / 提醒 / watchlist / target price / rating 为正式对象；
  • 不在 Snapshot / Thread / Checkpoint 任何 schema 中增加 forbidden execution 字段（v1-product-object-and-schema-design.md §5.2）；
  • 不接入真实交易所 / 钱包 / 私钥 / 资金；
  • 不在工程仓库 docs/design/01..09 写新内容（这些已被 sub-8 标 deprecated）；
  • 不允许 AI Coding Agent 自行 merge 涉及 sensitive input 的 PR（必须由人类 Controller 复核）。

6. 全局风险登记​

Risk备注
R-1 实现层为「demo 效果」加快捷买入按钮立即拒绝并触发 Kill criteria
R-2 PreExecutionCheckpoint 字段被前端误用为执行 triggerAPI contract 显式 read-only by trading systems
R-3 Sensitive Input Handler 4 类输入边缘判断不一致由 sub-2 evaluation case 单独覆盖
R-4 把 V1 后续阶段（Data Horizon / Training Loop / Trading Matrix）字段提前引入 schema必须等 V1 acceptance 决议后讨论

7. Coding Agent 使用提示​

  • 任何字段变化必须先在 v1-product-object-and-schema-design.md 中提出 Open Item；
  • 提交 PR 时必须勾选「未恢复 legacy Action Suggestion / 未引入 forbidden execution fields / 未绕过 boundary guard」三项；
  • 每个 PR 描述必须列出影响的 sub-packet ID + AL ID；
  • 涉及 sensitive input 的 PR 必须由人类 Controller 复核，不允许 Agent 自行 merge；
  • 每个 sub-packet 完成时必须按 v1-handoff-anchor-template.md 产出 hand-off anchor。

8. 与其他 Task Packet 的关系​