phase2_implementation_plan.md

Phase 2: OpenClaw v4 差異驅動重構實施計劃

概述

基於 gap_matrix.md 分析，Phase 1 已完成 7 項 (#1, #2, #4, #6, #7, #10, #11)。
Phase 2 需實作剩餘 22 項，其中 17 項為高風險。

目標：嚴格遵循「強制執行指令：OpenClaw v4 差異驅動重構」，分批次、可驗證、可回滾完成所有 v4 條目。

---

📊 項目統計

風險分佈

• 高風險：17 項 (#3, #12-23, #26-29)
• 中風險：10 項
• 低風險：2 項 (#4, #24)

Phase 1 已實作

v4_id	項目	風險	狀態
#1	Sentinel 即時阻斷	中	✅ PR #6 已合併
#2	token 消耗模擬	中	✅ PR #7 已合併
#4	LLM 可觀測性層	低	✅ PR #7 已合併
#6	重啟恢復協議	中	✅ PR #6 已合併
#7	SQLite 初始化	中	✅ PR #7 已合併
#10	Prompt injection 防護	中	✅ PR #7 已合併
#11	累計回撤閾值	中	✅ PR #6 已合併

---

🎯 Phase 2 批次規劃

批次 A：基礎設施與安全（高優先級）

依賴鏈：基礎 → 安全 → 風控 → 功能

v4_id	項目	風險	依賴	預計工時	關鍵檔案
#3	Shadow Mode 熱部署	高	-	8h	src/openclaw/shadow_mode.py
#12	API 金鑰安全儲存	高	-	6h	src/openclaw/secrets.py, network_allowlist.py
#13	模型版本鎖定 + 冒煙測試	高	#4	4h	src/openclaw/model_registry.py, tests/test_smoke_llm.py
小計	3項	全高	基礎層	18h

批次 B：風控核心增強

v4_id	項目	風險	依賴	預計工時	關鍵檔案
#5	倉位規模計算模型	中	#1	6h	src/openclaw/position_sizing.py
#8	新聞驗證升級	中	-	5h	src/openclaw/news_guard.py
#9	Devil's Advocate 多空辯論	中	#4	4h	src/openclaw/pm_debate.py
小計	3項	全中	風控層	15h

批次 C：記憶與反思系統

v4_id	項目	風險	依賴	預計工時	關鍵檔案
#24	分層記憶系統	低	#7	8h	src/openclaw/memory_store.py
#25	三段式反思機制	中	#24	6h	src/openclaw/reflection_loop.py, reflection_job.py
小計	2項	中+低	記憶層	14h

批次 D：交易功能擴展

v4_id	項目	風險	依賴	預計工時	關鍵檔案
#17	台股盤中時段差異化	高	#5	6h	src/openclaw/tw_session_rules.py
#19	分批建倉 + 盤口厚度檢查	高	#5	7h	src/openclaw/order_slicing.py
#21	三位一體止盈策略	高	#19	5h	src/openclaw/take_profit.py
小計	3項	全高	交易層	18h

批次 E：數據與分析

v4_id	項目	風險	依賴	預計工時	關鍵檔案
#14	市場環境分類器	高	#24	10h	src/openclaw/market_regime.py
#18	三大法人籌碼整合	高	#7	8h	src/openclaw/institution_ingest.py
#23	季節性效應日曆	高	-	4h	src/openclaw/trading_calendar.py
小計	3項	全高	數據層	22h

批次 F：自主優化系統

v4_id	項目	風險	依賴	預計工時	關鍵檔案
#26	結構化策略提案系統	高	#25, #29	12h	src/openclaw/proposal_engine.py
#27	LLM + RL 混合架構	高	#26	16h	src/openclaw/rl/ (子模組)
#28	策略版本控制	高	#26	8h	src/openclaw/strategy_registry.py
#29	自主授權邊界	高	#26	6h	src/openclaw/proposal_engine.py (擴充)
小計	4項	全高	自主層	42h

批次 G：其他項目

v4_id	項目	風險	依賴	預計工時	關鍵檔案
#15	法規合規事項確認	高	-	4h	docs/compliance_checklist.md
#16	Edge Definition	高	#28	6h	docs/edge_definition.md, src/openclaw/edge_metrics.py
#20	主動空手機制	高	#14	5h	src/openclaw/cash_mode.py
#22	持倉相關性管理	高	#5	6h	src/openclaw/correlation_guard.py
小計	4項	全高	雜項	21h

---

🗓️ 時間規劃（24/7 極限開發）

第一週：基礎建設

• Days 1-2：批次 A（基礎設施與安全）
• Days 3-4：批次 B（風控核心增強）
• Days 5-7：批次 C（記憶與反思系統）

第二週：功能擴展

• Days 8-10：批次 D（交易功能）
• Days 11-13：批次 E（數據與分析）

第三週：自主系統

• Days 14-18：批次 F（自主優化系統）
• Days 19-21：批次 G（其他項目）

第四週：整合測試

• Days 22-28：端到端測試、文件整理、性能優化

總預計工時：150小時（≈ 22個開發日 @ 7小時/日）

---

🧪 測試策略

每批次必備

1. 單元測試：對應 test_v4_XX.py
2. 整合測試：決策流程端到端
3. 數據庫驗證：表結構、索引、遷移腳本
4. 可觀測性驗證：llm_traces 記錄完整

驗收標準

• ✅ 所有測試通過（0失敗）
• ✅ 可執行 dry-run（決策 → 訂單 → 成交 → 事件 → 追蹤）
• ✅ 數據庫摘要可查（所有 v4 表有資料）
• ✅ 可回滾性（每個 migration 可重複執行）

---

🔄 開發流程

每項目流程

1. Issue：GitHub Issue 為唯一任務來源
2. 分支：feat/issue-X-description
3. 開發：代碼 + 測試
4. PR：引用 Issue（Closes #X）
5. 審查：Architect + Critic 雙重審查
6. 合併：自動觸發 TaskHub done
7. 驗證：執行端到端測試

品質控制

• Architect：架構審查、設計模式
• Critic：邏輯漏洞、邊界案例
• PM：流程完整性、風險評估
• 自動化：CI/CD 測試套件

---

⚠️ 風險與緩解

技術風險

1. 高風險項目集中：17/22 項為高風險
   • 緩解：分批實施，每批次先完成基礎依賴
2. 依賴關係複雜：批次間有先後順序要求
   • 緩解：嚴格遵循依賴鏈，使用模擬接口
3. 測試覆蓋不足：新增功能可能缺乏完整測試
   • 緩解：測試驅動開發，每項必備測試案例

流程風險

1. 開發速度 vs 品質：24/7 模式可能犧牲品質
   • 緩解：PM 嚴格監督，無測試 = 不提交
2. 文檔滯後：代碼先於文檔
   • 緩解：設計文件先行，代碼註解即文檔

人員風險

1. 單點故障：主要開發者負擔過重
   • 緩解：團隊接力，coder/architect/critic 協作

---

📁 文件輸出

設計階段（Step 2）

• architecture_diff_report.md（舊 vs 新架構）
• refactor_plan.md（Phase 1/2/3 順序與風險）
• migration_plan.md（資料庫升級與回滾）

實施階段（每批次）

• 變更檔案清單
• 變更原因（對應 v4_id）
• 測試結果（命令 + 結果摘要）
• 尚存風險與下一步

結案文件

• v4_completion_report.md（所有條目完成證據）
• db_summary_report.md（數據庫驗證結果）
• test_coverage_report.md（測試覆蓋率分析）

---

🚀 立即行動

當前（00:30-02:00）

1. coder 完成 Step 2 設計文件
2. architect + critic 審查設計
3. 準備批次 A 開發環境

今日（02:00-08:00）

1. 開始批次 A：Shadow Mode (#3) 實作
2. 創建測試框架
3. 提交第一批 PR

里程碑

• D1：基礎設施批次完成
• D7：記憶系統上線
• D14：交易功能完整
• D21：自主系統核心
• D28：v4 全功能交付

---

版本：v1.0
更新時間：2026-02-28 00:35
負責人：main (PM) 🦞