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

AI_ICT + TradingAgents P0 自动任务清单 v1

1. 文档目标

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

P0 定位：

影子接入，不影响现有决策，只读消费 AI_ICT 事实，结果先进入 review packet。

本清单是执行单，不是设计稿。

---

2. 启动条件

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

1. 当前 AI_ICT 主骨架无新增主链 blocker
2. 当前阶段已被标记为 Research Council P0
3. 已读取：
   • AI_ICT_TradingAgents融合实施方案_最终版.md
   • AI_ICT_全自动开发执行流程_v1.md
   • AI_ICT_research_council脚手架与数据表草案_v1.md

---

3. 默认执行顺序

P0-1 脚手架与导出入口

目标

创建 src/services/research_council/ 基础目录和统一导出入口。

主要文件

• src/services/research_council/__init__.py
• src/services/research_council/council_schema.py
• src/services/research_council/council_output_formatter.py

完成标志

• 目录结构存在
• 包可被 import
• 不影响现有主链

默认验证

• focused import smoke
• 新增 unit test: tests/unit/test_research_council_imports.py

---

P0-2 context builder

目标

完成 council_context_builder，只读拼装 AI_ICT 已有事实。

主要文件

• src/services/research_council/council_context_builder.py
• src/services/decision/decision_packet_service.py
• src/services/operator/operator_workspace_service.py

输入源要求

• market_state
• latest_trading_plan
• latest_candidate
• latest_signal
• risk_result
• trust_policy
• recent_alerts
• recent_journal_entries
• weekly_review_summary

完成标志

• builder 只消费现有服务输出
• 不创建第二套事实层

默认验证

• focused unit test: tests/unit/test_research_council_context_builder.py

---

P0-3 结构化输出契约

目标

定义 P0 可用的最小 CouncilDecision 结构与 formatter。

主要文件

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

P0 必含字段

• research_summary
• operator_summary
• bull_case
• bear_case
• net_assessment
• committee_confidence
• source_snapshot_meta

完成标志

• formatter 输出稳定
• review packet 可直接消费

默认验证

• focused unit test: tests/unit/test_research_council_schema.py

---

P0-4 structure / risk analysts

目标

先接入最必要的两个 analyst：

• structure_analyst
• risk_analyst

主要文件

• src/services/research_council/agents/structure_analyst.py
• src/services/research_council/agents/risk_analyst.py
• src/services/research_council/tradingagents_adapter.py

完成标志

• analyst 只基于 context builder 输入工作
• 不直接调用外部股票研究数据源

默认验证

• focused unit test: tests/unit/test_research_council_analysts.py

---

P0-5 bull / bear / manager

目标

接入最小对抗论证链路：

• bull_researcher
• bear_researcher
• research_manager

主要文件

• src/services/research_council/agents/bull_researcher.py
• src/services/research_council/agents/bear_researcher.py
• src/services/research_council/agents/research_manager.py
• src/services/research_council/debate_service.py
• src/services/research_council/council_orchestrator.py

完成标志

• 能生成正反论据和最终摘要
• 结论只作为解释层，不改写主裁决

默认验证

• focused unit test: tests/unit/test_research_council_orchestrator.py

---

P0-6 持久化主表与链接表

目标

落最小持久化，不一开始就把全部历史回流做满。

建议先做的表

• research_council_runs
• research_council_messages
• research_council_links

主要文件

• migrations/036_create_research_council_runs.sql
• migrations/037_create_research_council_messages.sql
• migrations/038_create_research_council_links.sql
• 对应 repository 文件

完成标志

• 一次 council run 可持久化
• 能和 decision_packet_id / candidate_id / signal_id 关联

默认验证

• migration static checks
• focused repository tests

---

P0-7 手动 API / script 入口

目标

提供手动触发入口，先不进入 runtime 自动任务。

建议新增

• scripts/run_research_council.py
• GET /trading/research-council/latest
• GET /trading/research-council/runs
• POST /trading/research-council/run

主要文件

• scripts/run_research_council.py
• src/api/server.py

完成标志

• 手动 API / script 稳定可跑
• 没有 council 时系统主行为不变

默认验证

• focused API unit test
• script smoke

---

P0-8 review packet 只读展示

目标

把 council 摘要先接入 review packet，不进 decision packet。

主要文件

• src/services/operator/operator_workspace_service.py
• scripts/run_review_packet.py
• src/web/app.js

完成标志

• review packet 能显示 council 摘要
• council 缺席时不回归

默认验证

• focused review packet unit test
• API smoke: /trading/review-packet
• browser smoke

---

4. P0 阶段出口判断

P0 做完后必须回到晋级门，不是直接进入 P1。

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

1. 手动 API / script 稳定
2. council 缺席时主系统不回归
3. council 存在时 review packet 展示正常
4. council 失败时 runtime 可自动降级
5. 连续 smoke 无新增主链 blocker

否则状态应写为：

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

---

5. P0 默认验证串

建议默认验证顺序：

1. focused unit tests
2. tests/unit
3. scripts/run_offline_checks.py
4. scripts/run_research_council.py
5. scripts/run_review_packet.py
6. API smoke
7. browser smoke

如果改动未进入 runtime 主链，可不强制远端 deploy，但必须在状态中说明。