ai-exchange/docs/archive/AI_ICT_TradingAgents_P5自动任务清单_v1.md

AI_ICT + TradingAgents P5 自动任务清单 v1

1. 文档目标

本清单用于驱动 Research Council P5 的自动化闭环。

P5 定位：

把 P4 review 输出的 add_replay_fixture_with_confirmed_swings 从 operator 建议变成可重复执行、可部署、可审计的 replay 证据链。

P5 不负责改变交易执行权限、模型信任分层、真实交易就绪状态或 operator confirmation protocol。

---

2. 启动条件

只有满足以下条件，自动化流程才应进入 P5：

1. Research Council P4 已完成 optimization review governance 闭环
2. P4 review 返回 health_state=needs_attention
3. P4 review 的 recommended_actions 包含 add_replay_fixture_with_confirmed_swings
4. optimization loop / review CLI 与 API 路径可运行

---

3. 默认执行顺序

P5-1 confirmed swing replay fixture

目标： 提供一份可部署的 replay 数据，默认 left_bars=2/right_bars=2 下能确认 swing high 与 swing low。

主要文件：

• data/replay/research_council_confirmed_swings_v1.jsonl

完成标志：

• replay 文件通过 candle integrity gate
• run_replay_file.py 在 REPLAY_MIN_CANDLES=9、REPLAY_MIN_SWINGS=2、REPLAY_MAX_GAP_MINUTES=1 下通过
• 默认窗口可检测到 2 个 confirmed swings

---

P5-2 optimization replay summary evidence

目标： 让 optimization cycle 的 replay_summary 不只输出计数，还能输出可审计的 swing 细节。

主要文件：

• src/services/research_council/council_optimization_service.py

完成标志：

• replay_summary.confirmed_swing_count >= 2
• replay_summary.swing_counts 包含 swing_high 与 swing_low
• replay_summary.confirmed_swings 包含 source_index、confirmed_at_index、left_bars、right_bars
• choose_next_actions 不再输出 add_replay_fixture_with_confirmed_swings

---

P5-3 optimization loop and review rerun

目标： 用 P5 replay fixture 跑出新一轮 optimization cycle，并让 P4 review 看到缺口已关闭。

默认命令：

DATABASE_URL='<configured database url>' \
RESEARCH_COUNCIL_OUTPUT_JSON=1 \
RESEARCH_COUNCIL_OPTIMIZATION_CYCLE_KEY='research_council_opt:p5_confirmed_swings_20260511' \
RESEARCH_COUNCIL_REPLAY_FILE='D:/ai-exchange/data/replay/research_council_confirmed_swings_v1.jsonl' \
D:/ai-exchange/.venv/Scripts/python.exe D:/ai-exchange/scripts/run_research_council_optimization_loop.py

完成标志：

• latest cycle 的 replay_summary.confirmed_swing_gate_passed=true
• latest cycle 的 next_actions 不包含 add_replay_fixture_with_confirmed_swings
• run_research_council_optimization_review.py 返回 health_state=healthy 或只剩样本量相关状态

---

P5-4 deploy and remote smoke

目标： 确保远端系统也拥有同一份 replay 证据，并且远端 API 能跑出/读取 P5 cycle。

主要文件：

• Dockerfile
• scripts/deploy_with_password.py

完成标志：

• Docker 镜像包含 /app/data/replay/research_council_confirmed_swings_v1.jsonl
• 远端 deploy / smoke 通过
• 远端 POST /trading/research-council/optimization-cycle 可使用 P5 replay 文件
• 远端 GET /trading/research-council/optimization-review 返回不再包含 add_replay_fixture_with_confirmed_swings

---

4. 阶段出口

只有同时满足以下条件，P5 才可视为完成闭环：

1. confirmed swing replay fixture 已落地并通过质量门
2. optimization replay summary 已包含 swing evidence
3. 新 cycle 已消除 add_replay_fixture_with_confirmed_swings
4. review / review packet / workbench 可读取 P5 后的状态
5. 本地与远端验证完成，或外部环境阻塞被明确记录

完成后状态应写为：

state: research_council_p5_confirmed_swing_replay_closed
current_phase: Research Council P5 Confirmed Swing Replay Evidence

---

5. 边界守卫

P5 不允许做以下事情：

1. 不允许把 replay fixture 结果解释为真实可交易信号
2. 不允许修改 execution_allowed
3. 不允许修改 real_live_ready
4. 不允许自动升级或降级 trust bucket
5. 不允许绕过 operator confirmation protocol

P5 的输出只允许进入：

• replay evidence
• optimization cycle payload
• optimization review
• review packet / workbench
• 下一轮 bounded optimization 建议