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

AI_ICT + TradingAgents P4 自动任务清单 v1

1. 文档目标

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

P4 定位：

把 P3 的 optimization cycle 结果转成 operator 可读的治理判断：是否 stale、是否需要更多样本、是否出现退化、是否可以开启 bounded optimization slice。

P4 不负责自动修改模型、信任分层、执行权限或真实交易边界。

---

2. 启动条件

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

1. Research Council P3 已完成 optimization-loop 闭环
2. research_council_optimization_cycles 已有可查询记录
3. P3 latest / recent API 可用
4. 远端 deploy / smoke 路径可用，或已明确环境阻塞

---

3. 默认执行顺序

P4-1 optimization review service

目标：

读取最近若干轮 optimization cycle，生成治理判断。

主要文件：

• src/services/research_council/council_optimization_review_service.py

完成标志：

• 可判断 missing / stale / needs_more_samples / needs_attention / healthy
• 可计算 latest metrics 与相邻 cycle delta
• 可输出 operator summary 与 bounded recommended actions

---

P4-2 CLI 入口

目标：

提供自动化可运行的 review smoke 入口。

主要文件：

• scripts/run_research_council_optimization_review.py

完成标志：

• 支持 JSON 输出
• 无 cycle 时返回明确 missing
• 有 cycle 时返回 review payload

---

P4-3 API 与 review packet 可见性

目标：

让 operator/workbench 可以看到 P4 治理结果。

主要文件：

• src/api/research_council.py
• src/api/server.py
• src/services/operator/operator_workspace_service.py
• src/web/app.js

建议接口：

• GET /trading/research-council/optimization-review

完成标志：

• API 能返回 optimization review
• review packet 包含 research_council_optimization_review
• workbench operator console 显示 optimization health / summary / next actions

---

P4-4 状态锚点与远端验证

目标：

完成本地与远端闭环。

主要文件：

• SESSION.md
• TASKS.md

完成标志：

• focused tests 通过
• npm run lint / build / visual:snapshots 通过
• 数据库注入脚本 smoke 通过
• 本地 API smoke 通过
• 远端 deploy / smoke 通过
• 状态写为 research_council_p4_optimization_review_closed

---

4. 阶段出口

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

1. optimization review service 已落地
2. CLI / API / review packet / workbench 均可消费 review
3. review 能明确区分 stale、样本不足、需要关注、健康
4. review 只输出 operator follow-up，不自动改变模型或执行权限
5. 本地和远端验证完成，或外部环境阻塞被明确记录

完成后状态应写为：

state: research_council_p4_optimization_review_closed
current_phase: Research Council P4 Optimization Review Governance

---

5. 边界守卫

P4 不允许做以下事情：

1. 不允许自动切换默认模型
2. 不允许自动升级或降级 trust bucket
3. 不允许改变 execution_allowed
4. 不允许改变 real_live_ready
5. 不允许把 needs_attention 直接解释成可交易信号

P4 的输出只允许进入：

• operator summary
• review packet
• workbench optimization health
• 下一轮 bounded optimization slice 建议