Skip to content

Latest commit

 

History

History
131 lines (113 loc) · 7.94 KB

task_plan.md

File metadata and controls

131 lines (113 loc) · 7.94 KB

Task Plan: Quant Agent Plan-Only Real Integration

Goal

完成 P0 最小交易闭环的可运行实现与文档收口,并为 P1 盘中轻监控增强准备清晰入口任务。

Current Phase

Phase 11

Phases

Phase 1: Requirements & Discovery

  • 读取 SPEC.md 并确认下一步只做 plan_only 真实集成
  • 检查当前 orchestrator、adapter、repository 的真实缺口
  • 收敛实现范围,不把 xtquant 实盘执行混入本轮
  • Status: complete

Phase 2: Planning & Structure

  • 定义 plan_only 真实链路的模块边界
  • 写出 focused implementation plan
  • 更新 findings 和 progress
  • Status: complete

Phase 3: Implementation

  • 通过 feat/quant-agent-plan-only 分支完成实现并合并回源仓库 main
  • 实现 adata -> generate_plan -> SQLite -> orchestrator 真实链路
  • 同步 README / SKILL 文档,并补上 adata 缺失时的保护
  • Status: complete

Phase 4: Progress Sync & Next Handoff

  • 从源目录 /Users/yanggenxing/.openclaw/workspace-techAlpha/projects/quant-agent 回收历史进度
  • 核对当前仓库与源目录源码状态基本一致
  • 基于真实历史规划下一阶段(run_log / execution / monitoring / memory)
  • Status: complete

Phase 5: Data Layer Extension (Run Logs & Execution Persistence)

  • 扩展 SQLite schema:run_log、orders、fills、account_snapshot
  • 新增 repository 并注入 runtime(为 execution 主链打基础)
  • 补齐数据层测试并通过全量回归
  • Status: complete

Phase 6: Execution Wiring Next

  • 在 orchestrator 中接入审批 -> 下单 -> 对账的最小 execution 主链
  • 将 run_log 状态流转接入 orchestrator 生命周期
  • 先使用 fake broker 跑通端到端测试,再决定 xtquant 接入时机
  • Status: complete

Phase 7: Monitoring & Memory Minimal Slice

  • 增加 monitoring 最小可运行模块(计划失效/强化检查占位)
  • 增加 memory 最小可运行模块(结构化写入占位)
  • 在 orchestrator 中打通 review -> memory 的最小落库链路
  • Status: complete

Phase 8: Real Broker Integration Planning

  • 评估 xtquant 接入 orchestrator 的最小安全路径(保持人工审批)
  • 设计 fake broker 与 real broker 的统一接口和切换策略
  • 增加 execution/memory 的失败重试与告警策略
  • Status: complete

Phase 9: Real Broker Safe Landing

  • 在本地可用环境验证 xtquant 真实初始化与连接流程(阻塞:需 Windows + MiniQMT 可用环境)
  • 增加 real broker 下的 dry-run / shadow 模式
  • 在 orchestrator 中接入 shadow_auto_fill 模拟成交开关并写入 fills 落库链路
  • 将 run_log_stage_event 阶段耗时透出到 execution 结果与 review 摘要
  • 补充 real broker 异常场景集成测试策略(含重试失败、配置缺失、shadow 分支)
  • 将 run_log 阶段状态细化为 planning/execution/monitoring/memory/completed|failed
  • Status: blocked_on_env

Phase 10: Documentation Closeout & P1 Handoff

  • 完成 task_plan.md / progress.md / findings.md 的阶段收口同步
  • 标注 Phase 9 的唯一外部阻塞项(xtquant 实机环境)
  • 明确 P1 入口任务(盘中轻监控增强 + 执行观测联动)
  • P1-1:将 monitoring 节点按时段拆分(盘前/盘中/尾盘)并约定输入输出 schema
  • P1-2:增加 auction_watch / sector_watch 到 orchestrator 的可配置接线(默认关闭)
  • P1-3:在 review 输出中增加“监控触发 -> 执行结果”关联摘要
  • Status: complete

Phase 11: Minimum Go-Live Hardening

  • 增加执行门禁:kill_switch、max_orders_per_run、max_order_notional
  • 增加严格对账模式:strict_reconcile 下 broker 快照不一致直接判定失败并告警
  • 将关键上线缺口整理为可执行 TODO 清单(docs/go_live_todo.md)
  • 接入可持续运行入口(CLI/cron/daemon)与任务编排
  • 增加生产告警通道与值守策略(连接失败/对账失败/重试耗尽)
  • 完成上线运行手册(启动、回滚、故障处理、手工接管)
  • 周末后完成 xtquant 实机验证并解除 Phase 9 阻塞
  • Status: in_progress

Key Questions

  1. xtquant 真实连接验证是否单独开 feature 分支进行?(建议:是)
  2. 最小上线阶段中,调度入口优先采用 cron + CLI 还是长驻 daemon?
  3. 盘中轻监控接线默认是否继续保持只读(不触发自动下单)?

Decisions Made

Decision Rationale
本轮只做 plan_only 真实集成 降低范围,优先把研究模式跑通
研究模式使用 adata 作为唯一真实数据源 当前最容易本地验证,且不需要 Windows / MiniQMT
orchestrator / runtime 采用 provider injection 便于 fake provider 测试和后续切换 xtdata
本轮 SQLite 只持久化 candidate_plan 先打通最短真实价值闭环,run_log 延后到下一阶段
orchestrator 返回结构化 planning / execution / review 三段结果 便于 skill 编排和测试断言
xtquant 保持 mockable,不进入本轮 orchestrator 避免把研究链路和实盘执行耦合在一起
当前独立仓库视为源目录项目的剥离快照 源目录 git 历史可作为真实进度依据
下一阶段优先补数据层持久化基础(run_log + execution 相关表) 能先把执行链数据闭环打底,再接 orchestration
execution 主链先以 fake broker 跑通并固化测试 在不依赖 xtquant 的前提下先验证编排正确性
monitoring/memory 先以最小切片落地 先形成 review -> memory 可运行链路,再迭代策略细节
real broker 接入先走 broker factory + 显式 broker_mode 保持执行路径可控且可测试
execution 默认加入重试与结构化告警 提升稳定性并为复盘/记忆提供可追踪证据
在 xtquant 不可用时优先推进 shadow 模式和异常策略 保持开发连续性,不阻塞 execution 主链演进
shadow 模式增加可选 auto_fill 并由 orchestrator 透传 支持 dry-run 下的成交模拟与回测联调,不改变默认行为
run_log 记录阶段状态并在 orchestrator 中实时推进 提升执行可观测性,方便问题定位和运营审计
将 run_log_stage_event 输出到 execution/review 结果 让阶段耗时可直接用于复盘摘要与外部观测
在最小上线阶段先补执行门禁与严格对账,再做调度和运维能力 保证在无实盘环境时仍能先提升上线安全性

Errors Encountered

Error Attempt Resolution
python 命令不存在 1 改用 python3
主仓库并行 git 命令导致 index.lock 1 后续 git 操作改为串行
当前独立仓库缺少历史上下文 1 回查源目录与提交历史恢复进度

Notes

  • plan_only focused plan 位于 docs/superpowers/plans/2026-03-27-p0-plan-only-real-integration.md
  • 源目录中的关键提交:ee1f02db、bf6cc981、15c6faed、8d2734ba、168b0a2e
  • 源目录中的 feat/quant-agent-plan-only 已合并到 main
  • 本轮新增持久化表和 repository 后,下一步进入 execution wiring
  • execution wiring 已完成,下一步进入 monitoring/memory 最小切片
  • monitoring/memory 最小切片已完成,下一步评估 real broker 接入
  • broker factory 与 execution 重试告警已完成,下一步是 real broker 实机验证
  • shadow broker 模式已完成,可在无 xtquant 环境下继续 execution 开发
  • shadow auto_fill 开关已接入 orchestrator,支持模拟成交落库与监控强化联动
  • stage duration 已透出到 execution/review,当前剩余阻塞仅为 xtquant 环境可用性验证
  • 已进入 Phase 11 最小上线硬化:优先执行门禁、严格对账、运行编排和运维告警