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

AI_ICT + TradingAgents P1 自动任务清单 v1

1. 文档目标

本清单用于驱动 Research Council P1 的自动推进。

P1 定位：

受控进入 decision_packet 与 runtime，增强 operator / workbench 的解释质量，但不替代风控和 trust。

---

2. 启动条件

只有满足以下条件，自动化流程才应切入本清单：

1. P0 晋级门已通过
2. 当前阶段已被标记为 Research Council P1
3. P0 相关回归已清零

---

3. 默认执行顺序

P1-1 runtime 任务接入

目标

把 research_council 作为受控任务接入 runtime。

主要文件

• src/services/runtime/trading_runtime_service.py
• src/services/research_council/council_orchestrator.py

完成标志

• 任务顺序固定在 watch -> research_council -> decision_packet
• 失败自动降级，不阻塞主链

默认验证

• tests/unit/test_trading_runtime_service.py
• 新增: tests/unit/test_research_council_runtime_integration.py

---

P1-2 decision packet 字段扩展

目标

把 council 解释字段正式接入 DecisionPacket。

主要文件

• src/services/decision/decision_packet_service.py

目标字段

• research_summary
• committee_confidence
• agreement_points
• disagreement_points
• follow_up_checks
• recommended_watch_items
• operator_questions

完成标志

• packet 主裁决仍由原逻辑决定
• council 只增强解释

默认验证

• tests/unit/test_decision_packet_service.py
• 新增: tests/unit/test_research_council_decision_packet_fields.py

---

P1-3 news_event_analyst

目标

增加环境解释层。

主要文件

• src/services/research_council/agents/news_event_analyst.py
• src/services/market_state/news_event_provider.py

完成标志

• 只解释 AI_ICT 已有 news/event 结果
• 不自行建立第二套事实源

默认验证

• focused unit test

---

P1-4 visual_analyst

目标

吸收 visual review 结果，增强解释与 follow-up checks。

主要文件

• src/services/research_council/agents/visual_analyst.py
• src/services/visual_watch/visual_watch_service.py

完成标志

• visual 结果只作为补充确认和风险提示
• 不单独作为执行许可来源

默认验证

• focused unit test

---

P1-5 disagreement / follow-up checks

目标

把分歧点和补充检查项结构化输出。

主要文件

• src/services/research_council/debate_service.py
• src/services/research_council/council_schema.py

完成标志

• bull / bear / manager 输出可汇总成统一分歧结构

默认验证

• orchestrator / formatter focused tests

---

P1-6 visual watch 建议联动

目标

让 council 输出建议的 watch 项，但不越过执行边界。

主要文件

• src/services/visual_watch/visual_trigger_policy_service.py
• src/services/decision/decision_packet_service.py

完成标志

• recommended_watch_items 可进入 visual watch
• 不改变 execution_allowed

默认验证

• visual watch focused tests

---

P1-7 workbench 展示增强

目标

把 council 解释层真正呈现在 operator workbench 上。

主要文件

• src/web/app.js
• src/web/index.html

展示目标

• 支持理由
• 反对理由
• 分歧点
• follow-up checks
• committee confidence

完成标志

• operator 能直接读到增强解释
• 不引入第二套页面

默认验证

• npm run lint
• npm run build
• npm run visual:snapshots
• browser smoke

---

P1-8 checkpoint / resume

目标

给 council 长链路增加恢复能力。

主要文件

• src/services/research_council/council_checkpoint_service.py
• 相关 migration / repository

完成标志

• council 运行中断后可恢复
• 不影响主链稳定性

默认验证

• focused unit test
• script smoke

---

4. P1 阶段出口判断

只有以下全部成立，才允许自动切入 P2：

1. decision_packet 已稳定吸收 council 字段
2. runtime 已受控接入 council 任务
3. workbench 已稳定展示支持 / 反对 / 分歧 / follow-up checks
4. visual watch 已能消费 council 建议
5. 未造成执行边界回归

否则状态应写为：

• P1 部分完成
• P1 待收尾
• P1 环境阻塞

---

5. P1 默认验证串

建议默认验证顺序：

1. focused unit tests
2. tests/unit
3. scripts/run_offline_checks.py
4. scripts/run_research_council.py
5. scripts/run_decision_packet.py
6. scripts/run_trading_runtime.py
7. browser smoke
8. 必要时远端 deploy + smoke