docs: 重整文件結構，移除 v2/v3 舊文檔，新增實作指南

- 刪除 v2/v3 所有舊規格文件
- 將 v4 規格文件移至 spec/ 目錄
- 新增 guides/ 目錄，包含：
  - guide_openclaw_config.md：openclaw.json 設定、Discord 接入、Gateway 管理
  - guide_workspace_files.md：8 個 Workspace 設定檔正確用途
  - guide_sessions_tools.md：sessions_spawn/send 參數與 Agents vs Sub-agent run 說明
- 更新 spec_v4_rollout_and_risks.md：加入 Phase 0/1 實際進度
- 新增 INDEX.md 文件索引

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

docs/spec/spec_v4_collaboration_scheduling_memory.md

@@ -0,0 +1,238 @@
+# KingClawArmy - 第四部分：協作模式 & 第五部分：排程與觸發 & 第六部分：記憶 & 第七部分：Discord
+
+---
+
+## 第四部分：協作模式
+
+### 4.1 三種模式（全部在 OpenClaw 內完成）
+
+| 模式 | OpenClaw 實現 | 場景 |
+|---|---|---|
+| **Orchestrator** | CEO 用 `sessions_spawn` 派工給 sub-agent | 日常任務分派 |
+| **Peer-to-Peer** | Agent 之間用 `sessions_send` 來回溝通（最多 5 輪） | 追問、澄清、交叉驗證 |
+| **Coordinator 討論** | CEO 用 `sessions_send` 逐一收集觀點再收斂 | 多方意見整合、辯論替代 |
+
+### 4.2 協作模式詳細流程
+
+#### Orchestrator（派工）
+
+```
+CEO 收到任務
+  ↓
+sessions_spawn("finance_researcher", task="蒐集今日盤前資訊")
+  ↓
+財經情報研究員在獨立 session 中執行
+  ↓
+完成後 push 結果回 CEO
+  ↓
+CEO 收到結果，spawn 下一個 agent
+```
+
+#### Peer-to-Peer（直接溝通）
+
+```
+量化策略研究員讀完多方報告後有疑問
+  ↓
+sessions_send("bullish_researcher", "你提到 OB 支撐，具體是哪個價位？")
+  ↓
+多方研究員回覆（ping-pong 最多 5 輪）
+  ↓
+量化策略研究員獲得澄清，繼續工作
+```
+
+#### Coordinator 討論（辯論替代方案）
+
+```
+CEO 需要整合多空觀點
+  ↓
+step 1: sessions_send("bullish_researcher", "總結你的核心做多論點")
+step 2: sessions_send("bearish_researcher", "總結你的核心做空論點")
+step 3: sessions_send("bearish_researcher", "針對多方的論點 [X]，你的反駁是？")
+step 4: sessions_send("bullish_researcher", "針對空方的反駁 [Y]，你的回應是？")
+step 5: sessions_send("quant_strategist", "以下是雙方觀點 [全文]，請收斂成策略")
+  ↓
+CEO 收到策略規格
+```
+
+### 4.3 什麼場景用什麼模式
+
+| 場景 | 模式 | 理由 |
+|---|---|---|
+| 蒐集資料 | Orchestrator spawn | 獨立任務，不需互動 |
+| 寫回測程式 | Orchestrator spawn | 獨立任務 |
+| 多空辯論 | Coordinator 討論 | 需要多方觀點交叉 |
+| 追問細節 | Peer-to-Peer send | 兩個 agent 直接對話 |
+| 審查來回 | Peer-to-Peer send | 審查員與被審者 ping-pong |
+| 跨團隊對齊 | Coordinator 討論 | CEO 逐一收集再收斂 |
+| 你下達指令 | Discord → CEO | 你對 CEO 說話 |
+| 需要你批准 | CEO → Discord @你 | HITL |
+
+### 4.4 Review Gate
+
+| 必審節點 | 觸發方式 |
+|---|---|
+| 量化策略提交 | CEO spawn 審查員 review |
+| 回測結果提交 | CEO spawn 審查員 review |
+| 工程交付 | CEO spawn 審查員 review |
+| 文案對外 | CEO spawn 審查員 review |
+
+### 4.5 HITL 節點
+
+| 需要你批准的事 | 通知方式 |
+|---|---|
+| 正式部署 | Discord #approvals @你 |
+| DB schema 變更 | Discord #approvals @你 |
+| 廣告正式發布 | Discord #approvals @你 |
+| 對外訊息發送 | Discord #approvals @你 |
+| 金流操作 | Discord #approvals @你 |
+| 量化策略正式執行 | Discord #approvals @你 |
+
+---
+
+## 第五部分：排程與觸發
+
+### 5.1 Cron 排程
+
+```bash
+# 財經情報 — 每日盤前盤後
+openclaw cron add --agent finance_researcher --cron "30 7 * * 1-5" --task "盤前資訊蒐集"
+openclaw cron add --agent finance_researcher --cron "30 18 * * 1-5" --task "盤後資訊整理"
+
+# 市場研究 — 每日 + 每週
+openclaw cron add --agent market_researcher --cron "0 10 * * *" --task "每日市場情報"
+openclaw cron add --agent market_researcher --cron "0 9 * * 1" --task "每週市場分析報告"
+
+# 投放分析 — 每日
+openclaw cron add --agent ads_analyst --cron "30 9 * * *" --task "每日投放 KPI 檢查"
+
+# 資料分析 — 每日 + 每週
+openclaw cron add --agent data_analyst --cron "0 20 * * *" --task "每日資料摘要"
+openclaw cron add --agent data_analyst --cron "0 10 * * 1" --task "每週數據報告"
+
+# 秘書 — 每日記憶壓縮
+openclaw cron add --agent secretary --cron "0 23 * * *" --task "每日記憶壓縮與 State Diff"
+```
+
+### 5.2 事件觸發鏈（量化 pipeline）
+
+透過 CEO 的 Standing Orders 定義：
+
+```
+CEO Standing Order: 量化研究流程
+
+當收到財經情報完成通知：
+  → spawn market_structure_researcher
+
+當收到市場結構報告完成通知：
+  → spawn bullish_researcher（平行）
+  → spawn bearish_researcher（平行）
+
+當收到多方 + 空方報告都完成：
+  → 執行 coordinator 討論（收集雙方觀點）
+  → spawn quant_strategist（帶入討論結果）
+
+當收到量化策略完成通知：
+  → spawn quant_engineer
+
+當收到回測完成通知：
+  → spawn data_analyst
+
+當收到資料分析完成通知：
+  → send secretary（做摘要）
+  → spawn reviewer（審查整條 pipeline）
+
+當收到審查 pass：
+  → 組裝 Final_Decision_Packet
+  → Discord @董事長 請求批准
+
+當收到審查 revise：
+  → 退回被點名角色
+  → 如超過 3 輪 → Discord @董事長 介入
+```
+
+---
+
+## 第六部分：記憶架構
+
+### 6.1 OpenClaw 記憶系統
+
+| 層級 | 檔案/機制 | 用途 |
+|---|---|---|
+| **長期記憶** | `MEMORY.md` | 每個 agent 的永久知識，session 啟動時自動載入 |
+| **每日筆記** | `memory/YYYY-MM-DD.md` | 今日工作記錄，自動載入今天+昨天 |
+| **夢境整合** | `DREAMS.md` | 可選，定期整合零散記憶 |
+| **語意搜尋** | `memory_search` | 混合向量+關鍵字搜尋歷史記憶 |
+| **跨 agent** | QMD `extraCollections` | Agent A 搜尋 Agent B 的記憶 |
+
+### 6.2 記憶分類與負責人
+
+| 記憶類型 | 存放位置 | 寫入者 | 讀取者 |
+|---|---|---|---|
+| 董事長決策 | CEO 的 MEMORY.md | 秘書 | 所有 agent（via QMD） |
+| 量化策略規則 | quant_strategist 的 MEMORY.md | 量化策略研究員 | 回測工程師、資料分析員 |
+| 回測結果摘要 | data_analyst 的 MEMORY.md | 資料分析員 | 量化策略、CEO |
+| 品牌知識庫 | strategy_director 的 MEMORY.md | 策略總監 | 文案、創意 |
+| 會議結論 | secretary 的 memory/ 每日筆記 | 秘書 | 所有 agent（via QMD） |
+| 個別工作脈絡 | 各 agent 的 memory/ 每日筆記 | 各 agent | 該 agent + 秘書 |
+
+### 6.3 記憶生命週期
+
+| 類型 | 保留方式 |
+|---|---|
+| MEMORY.md | 永久，除非手動更新 |
+| 每日筆記 | 自動載入今天+昨天；更舊的靠 memory_search |
+| 秘書壓縮 | 每日 23:00 將當日重點寫入 MEMORY.md，清理冗餘 |
+
+---
+
+## 第七部分：Discord Server 結構
+
+### 7.1 頻道規劃
+
+```
+KingClawArmy Discord Server
+│
+├── 📋 管理
+│   ├── #dashboard        — 每日摘要、系統狀態
+│   ├── #approvals        — HITL 審批（你在這裡批准）
+│   └── #errors           — 錯誤與異常
+│
+├── 📊 量化
+│   ├── #quant-briefing   — 盤前盤後情報
+│   ├── #quant-discussion — 討論區（coordinator 討論結果貼這）
+│   └── #quant-results    — 策略定稿、回測結果
+│
+├── 📈 行銷
+│   ├── #marketing-intel  — 市場情報
+│   └── #ads-performance  — 投放 KPI
+│
+├── ✏️ 內容
+│   └── #content-briefs   — 文案 / 創意 brief
+│
+└── 📝 記錄
+    ├── #meeting-logs     — 所有 coordinator 討論記錄
+    └── #decision-log     — 重大決策
+```
+
+### 7.2 Discord 互動方式
+
+| 你想做的事 | 怎麼做 |
+|---|---|
+| 下達新指令 | 在 #dashboard 或 DM 跟 CEO agent 說 |
+| 查看進度 | 問 CEO 或秘書 |
+| 批准高風險動作 | 在 #approvals 回覆 approve / reject |
+| 看今日摘要 | #dashboard 自動推送（秘書每日產出） |
+| 看回測結果 | #quant-results |
+| 手動發起討論 | @CEO 說「召集量化團隊討論 [主題]」 |
+| 緊急停止 | `openclaw tasks flow cancel <id>` 或 Discord @CEO「停止 [任務]」 |
+
+### 7.3 通知規則
+
+| 事件 | 推送到 | 由誰推送 |
+|---|---|---|
+| 任務完成 | 對應區域頻道 | CEO |
+| 審查 pass（HITL） | #approvals | CEO |
+| 審查 block | #errors + #approvals | CEO |
+| 每日摘要 | #dashboard | 秘書 |
+| 討論結論 | #meeting-logs | 秘書 |
+| 錯誤/異常 | #errors | 相關 agent |

docs/spec/spec_v4_org_and_roles.md

@@ -0,0 +1,317 @@
+# KingClawArmy - 第二部分：組織架構 & 第三部分：角色定義
+
+---
+
+## 第二部分：組織架構
+
+### 2.1 團隊結構
+
+```
+董事長（你，人類，透過 Discord 操作）
+│
+├── 管理團隊 (3 agents)
+│   ├── CEO/COO          ← coordinator，管理所有 sub-agent
+│   ├── 秘書             ← 記憶管理、摘要、狀態追蹤
+│   └── 審查員           ← 品質把關 pass/revise/block
+│
+├── 量化研究團隊 (7 agents)
+│   ├── 財經情報研究員
+│   ├── 市場結構研究員
+│   ├── 多方研究員
+│   ├── 空方研究員
+│   ├── 量化策略研究員（含風控）
+│   ├── 回測工程師
+│   └── 資料分析員
+│
+├── 行銷策略團隊 (3 agents)
+│   ├── 市場研究員
+│   ├── 策略總監
+│   └── 投放成效分析師
+│
+├── 內容創意團隊 (2 agents)
+│   ├── 文案撰寫員
+│   └── 創意總監
+│
+└── 工程團隊 (0~2 agents)
+    ├── 前端工程師
+    └── 後端工程師
+```
+
+**總計：15 ~ 17 agents**
+
+### 2.2 OpenClaw Agent 配置結構
+
+每個 agent 在 `~/.openclaw/openclaw.json` 中定義：
+
+```jsonc
+{
+  "agents": [
+    {
+      "name": "ceo_coo",
+      "model": "claude-sonnet-4-6",  // 或任何模型
+      "workspace": "~/.openclaw/workspaces/ceo_coo",
+      "bindings": [
+        { "channel": "discord:#commands", "guild": "<guild_id>" }
+      ],
+      "system_prompt_file": "SOUL.md",
+      "memory_engine": "qmd",
+      "tools": ["sessions_spawn", "sessions_send", "cron", "memory_search"]
+    }
+    // ... 其他 agents
+  ]
+}
+```
+
+### 2.3 Agent 間的關係（routing）
+
+```
+CEO/COO (coordinator)
+├── sessions_spawn → 財經情報研究員（派工，異步）
+├── sessions_spawn → 市場結構研究員
+├── sessions_spawn → 多方研究員 / 空方研究員（平行派工）
+├── sessions_spawn → 量化策略研究員
+├── sessions_send  → 審查員（同步來回審查）
+├── sessions_send  → 秘書（同步請求摘要）
+└── Discord @mention → 你（HITL 審批）
+```
+
+### 2.4 狀態分類
+
+| 狀態 | 說明 | 角色 | OpenClaw 實現 |
+|---|---|---|---|
+| **常駐** | 持續運行 | CEO/COO、秘書 | Standing Orders + 高頻 cron |
+| **Warm** | 高頻喚醒 | 審查員 | 事件觸發（hooks） |
+| **喚醒** | 排程或事件觸發 | 其餘所有 agent | cron + hooks |
+
+---
+
+## 第三部分：角色定義
+
+> 所有 agent 運行於 OpenClaw  
+> 每個 agent 有獨立的 workspace（SOUL.md + MEMORY.md + AGENTS.md）
+
+### 3.0 模型等級分類
+
+| 等級 | 說明 | 適用模型舉例 |
+|---|---|---|
+| **reasoning-heavy** | 深度推理、策略收斂、審查 | Claude Opus, GPT-4o, DeepSeek-V3 |
+| **general** | 通用管理、摘要、整理 | Claude Sonnet, GPT-4o-mini |
+| **coder** | 寫程式、回測 | Claude Sonnet, Codex, DeepSeek-Coder |
+| **creative** | 文案、創意發想 | Claude Sonnet, GPT-4o |
+| **research** | 資料蒐集、整理 | Claude Haiku, GPT-4o-mini |
+
+---
+
+### 3.1 管理團隊
+
+#### CEO/COO
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `ceo_coo` |
+| **模型等級** | general |
+| **狀態** | 常駐 |
+| **Mission** | 接收董事長指令，拆解任務，用 `sessions_spawn` 分派給 sub-agent，追蹤進度，收斂結果 |
+| **Scope** | 派工（spawn）、溝通（send）、讀取所有 agent 產出、發起 Discord 討論、組裝決策包 |
+| **Forbidden** | 不直接寫文案 / 程式 / 部署 / 做研究 |
+| **輸出** | Task_Spec.json, Final_Decision_Packet.json |
+| **OpenClaw 工具** | `sessions_spawn`, `sessions_send`, `cron`, `memory_search`, Discord 工具 |
+| **Escalation** | 高風險 → Discord @你 |
+
+#### 秘書
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `secretary` |
+| **模型等級** | general |
+| **狀態** | 常駐 |
+| **Mission** | 記錄摘要、維護 MEMORY.md、產出 State Diff、維護 Todo |
+| **Scope** | 讀寫所有 agent 的 memory（via QMD extraCollections）、產出摘要 |
+| **Forbidden** | 不做策略決策、不分派任務 |
+| **輸出** | Meeting_Summary.json, State_Diff.json, Todo_List.json |
+| **OpenClaw 工具** | `memory_search`, `memory_write`, Discord 工具 |
+| **Escalation** | 記憶衝突 → 上報 CEO |
+
+#### 審查員
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `reviewer` |
+| **模型等級** | reasoning-heavy |
+| **狀態** | warm（事件觸發） |
+| **Mission** | 審查產出品質，判定 pass / revise / block |
+| **Scope** | 唯讀所有 agent 輸出、提出修改建議、風險攔截 |
+| **Forbidden** | 不重寫內容、不拍板決策 |
+| **輸出** | Review_Report.json |
+| **OpenClaw 工具** | `memory_search`, `sessions_send`（回覆審查結果給 CEO） |
+| **Escalation** | block → CEO → 可能 Discord @你 |
+
+---
+
+### 3.2 量化研究團隊
+
+#### 財經情報研究員
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `finance_researcher` |
+| **模型等級** | research |
+| **Mission** | 蒐集財經、總經、盤前盤後資訊 |
+| **Forbidden** | 不下交易結論 |
+| **輸出** | Finance_Research_Brief.json |
+| **OpenClaw 工具** | web_search, browser, memory_write |
+
+#### 市場結構研究員
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `market_structure_researcher` |
+| **模型等級** | reasoning-heavy |
+| **Mission** | 解析流動性、MSS、OB、FVG、POI |
+| **Forbidden** | 不下最終交易結論 |
+| **輸出** | Market_Structure_Report.json |
+| **OpenClaw 工具** | 行情資料 MCP, memory_search |
+
+#### 多方研究員
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `bullish_researcher` |
+| **模型等級** | reasoning-heavy |
+| **Mission** | 整理支持做多的論點 |
+| **Forbidden** | 不直接拍板、不做空方論述 |
+| **輸出** | Bullish_Research_Report.json |
+| **OpenClaw 工具** | memory_search（讀取研究報告） |
+
+#### 空方研究員
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `bearish_researcher` |
+| **模型等級** | reasoning-heavy |
+| **Mission** | 整理反對交易的論點 |
+| **Forbidden** | 不直接拍板、不做多方論述 |
+| **輸出** | Bearish_Research_Report.json |
+| **OpenClaw 工具** | memory_search（讀取研究報告） |
+
+#### 量化策略研究員（含風控）
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `quant_strategist` |
+| **模型等級** | reasoning-heavy |
+| **Mission** | 收斂多空觀點成策略規則 + 風控框架 + bias check |
+| **Forbidden** | 不寫正式程式碼 |
+| **輸出** | Quant_Strategy_Spec.json |
+| **OpenClaw 工具** | memory_search, sessions_send（向多方/空方追問） |
+
+#### 回測工程師
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `quant_engineer` |
+| **模型等級** | coder |
+| **Mission** | 將策略規則轉成 Pine Script / Python 回測 |
+| **Forbidden** | 不自行更改策略方向 |
+| **輸出** | Backtest_Delivery.json |
+| **OpenClaw 工具** | exec, code_execution, file_ops, memory_write |
+
+#### 資料分析員
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `data_analyst` |
+| **模型等級** | reasoning-heavy / general |
+| **Mission** | 分析回測結果，計算 KPI，提供洞察 |
+| **Forbidden** | 不自行定策略方向 |
+| **輸出** | Data_Analysis_Report.json |
+| **OpenClaw 工具** | code_execution, memory_search, memory_write |
+
+---
+
+### 3.3 行銷策略團隊
+
+#### 市場研究員
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `market_researcher` |
+| **模型等級** | research |
+| **Mission** | 蒐集競品、消費者痛點、平台趨勢並分析 |
+| **輸出** | Market_Research_Brief.json, Market_Analysis_Report.json |
+| **OpenClaw 工具** | web_search, browser, memory_write |
+
+#### 策略總監
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `strategy_director` |
+| **模型等級** | reasoning-heavy |
+| **Mission** | 定義 USP、品牌敘事、campaign、漏斗策略 |
+| **Forbidden** | 不直接寫最終文案 |
+| **輸出** | Brand_Strategy_Plan.json, Growth_Strategy_Plan.json |
+| **OpenClaw 工具** | memory_search |
+
+#### 投放成效分析師
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `ads_analyst` |
+| **模型等級** | general |
+| **Mission** | 分析 CTR / CVR / CPL / ROAS，提出優化建議 |
+| **輸出** | Ads_Performance_Report.json |
+| **OpenClaw 工具** | 廣告平台 MCP, memory_write |
+
+---
+
+### 3.4 內容創意團隊
+
+#### 文案撰寫員
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `copywriter` |
+| **模型等級** | creative |
+| **Mission** | 廣告文案 + 影片腳本 |
+| **輸出** | Copywriting_Pack.json, Video_Script_Pack.json |
+| **OpenClaw 工具** | memory_search（品牌語氣庫） |
+
+#### 創意總監
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `creative_director` |
+| **模型等級** | creative |
+| **Mission** | 平面素材 brief + 影片分鏡 brief |
+| **輸出** | Static_Creative_Brief.json, Storyboard_Brief.json |
+| **OpenClaw 工具** | memory_search（品牌規範）, image tools（如有） |
+
+---
+
+### 3.5 工程團隊（依需求啟用）
+
+#### 前端工程師 / 後端工程師
+
+| 項目 | 內容 |
+|---|---|
+| **Agent ID** | `frontend_engineer` / `backend_engineer` |
+| **模型等級** | coder |
+| **Mission** | 前端開發 / API + DB 開發 |
+| **OpenClaw 工具** | exec, file_ops, code_execution, browser |
+
+---
+
+### 3.6 SOUL.md 共用結尾
+
+每個 agent 的 `SOUL.md` 結尾附加：
+
+```text
+## 行為規範
+
+- 只在你的職權範圍內行動
+- 缺少必要資訊時，回傳 missing_fields 清單
+- 遇到衝突、不確定、高風險時，上報而非猜測
+- 輸出必須遵循指定的 JSON schema
+- 不在 JSON 之外添加額外說明
+- 在 Discord 討論時，保持你的角色立場發言
+```

docs/spec/spec_v4_rollout_and_risks.md

@@ -0,0 +1,142 @@
+# KingClawArmy - 第八部分：JSON Schema & 第九部分：上線計畫 & 第十部分：風險與限制
+
+---
+
+## 第八部分：JSON Schema
+
+JSON Schema 定義各 agent 產出格式，與系統架構無關（純資料格式）。
+詳細 schema 定義請參考各 agent 的 AGENTS.md 或實際輸出範例。
+
+---
+
+## 第九部分：上線計畫
+
+### 9.1 總覽
+
+| Phase | 目標 | 上線角色 | 驗收標準 | 狀態 |
+|---|---|---|---|---|
+| 0 | 基礎設施 | — | OpenClaw + Discord 可用 | ✅ 完成 |
+| 1 | 管理閉環 | 3 agents | CEO 派工→秘書記錄→審查審核 | 🔄 進行中 |
+| 2 | 量化閉環 | +7 agents | 情報到回測完整 pipeline | 待開始 |
+| 3 | 行銷閉環 | +3 agents | 研究→策略→KPI 追蹤 | 待開始 |
+| 4 | 內容閉環 | +2 agents | 文案+創意 brief | 待開始 |
+| 5 | 工程（依需求） | +0~2 agents | 前後端任務可執行 | 待開始 |
+
+### 9.2 Phase 0：基礎設施 ✅
+
+| 步驟 | 動作 | 驗收 | 狀態 |
+|---|---|---|---|
+| 0.1 | 安裝 OpenClaw | `openclaw --version` 正常 | ✅ v2026.4.10 |
+| 0.2 | 設定 AI model API | OpenClaw 能回應訊息 | ✅ openai-codex |
+| 0.3 | 設定記憶引擎 | `memory_search` 可用 | 待確認 |
+| 0.4 | 建立 Discord Server + 頻道 | 頻道結構完成 | ✅ King Claw Server |
+| 0.5 | 連接 OpenClaw Discord 整合 | Bot 在 Discord 上線 | ✅ #總機 頻道已連接 |
+| 0.6 | 建立 `~/.openclaw/openclaw.json` | config 可載入 | ✅ |
+
+**實際設定筆記：**
+- Discord Bot 需在 Developer Portal 開啟 Message Content Intent、Server Members Intent
+- 群組頻道路由須在 `channels.discord.guilds.<guildId>.channels` 設定，binding 用 `peer.kind: channel + peer.id: <channelId>`
+- Gateway 以 systemd user service 方式常駐執行
+
+### 9.3 Phase 1：管理閉環 🔄
+
+| 步驟 | 動作 | 驗收 | 狀態 |
+|---|---|---|---|
+| 1.1 | 建立 CEO agent（workspace 完整設定） | Agent 回應正常 | ✅ `ceo_coo` 已建立 |
+| 1.2 | 設定 CEO 的 Discord binding | Discord 訊息能路由到 CEO | ✅ #總機 已路由 |
+| 1.3 | 手動在 Discord 下達測試任務 | CEO 能理解並回應 | 🔄 測試中 |
+| 1.4 | 建立秘書 agent | 秘書能讀取 CEO 產出 | 待開始 |
+| 1.5 | 建立審查員 agent | 審查員能回覆 pass/revise | 待開始 |
+| 1.6 | 測試 CEO spawn 秘書 | sessions_spawn 正常 | 待開始 |
+| 1.7 | 測試 CEO send 審查員 | sessions_send 來回正常 | 待開始 |
+| 1.8 | 測試 HITL：CEO @總司令 在 Discord | 收到通知，回覆後 CEO 繼續 | 待開始 |
+| 1.9 | 測試跨 agent 記憶 | 秘書能搜尋 CEO 的記憶 | 待開始 |
+
+**Phase 1 完成標準：**
+- [x] CEO 能接收 Discord 指令
+- [ ] CEO 能 spawn/send 其他 agent
+- [ ] 秘書能產出摘要
+- [ ] 審查員能 pass/revise
+- [ ] Discord HITL 正常
+- [ ] 跨 agent 記憶搜尋正常
+
+### 9.4 Phase 2：量化閉環
+
+| 步驟 | 動作 | 驗收 |
+|---|---|---|
+| 2.1 | 建立財經情報研究員 + cron | 每日自動產出報告 |
+| 2.2 | 建立市場結構研究員 | 情報完成後自動觸發 |
+| 2.3 | 建立多方 + 空方研究員 | 平行產出報告 |
+| 2.4 | 建立量化策略研究員 | 能收斂成策略 |
+| 2.5 | 測試 coordinator 討論 | CEO 串行收集多空觀點並交給策略研究員 |
+| 2.6 | 建立回測工程師 | 產出回測結果 |
+| 2.7 | 建立資料分析員 | 分析回測結果 |
+| 2.8 | 完整 pipeline 端對端測試 | 從盤前情報到最終分析一次跑通 |
+| 2.9 | 審查員 review pipeline | 通過 gate |
+| 2.10 | HITL 測試：董事長批准 | Discord 審批正常 |
+
+### 9.5 Phase 3-5
+
+同 v3 版邏輯，依序加入行銷、內容、工程團隊。每加一個 agent：
+
+1. 建立 workspace（SOUL.md + AGENTS.md + MEMORY.md）
+2. 設定 model + tools
+3. 加入 openclaw.json
+4. 測試 CEO 能 spawn/send
+5. 測試記憶讀寫
+6. 跑一次真實任務驗證
+
+---
+
+## 第十部分：風險與限制
+
+### 10.1 已知限制
+
+| 限制 | 影響 | 緩解 |
+|---|---|---|
+| 無原生群組辯論（#18869） | 3+ agent 無法即時辯論 | coordinator 模式替代 |
+| sessions_send 最多 5 輪 | peer-to-peer 對話受限 | 大部分場景 5 輪夠用；超過走 coordinator |
+| sub-agent 最多 5 層深、5 個並行 | 不能一次 spawn 太多 | 15 agent 分批 spawn，CEO 做排隊 |
+| 無視覺化管理 UI | 看不到 org chart | Discord + CLI 管理 |
+| OpenClaw 曾有安全漏洞 | RCE 風險 | 保持更新、啟用認證 |
+
+### 10.2 成本控制
+
+| 策略 | 做法 |
+|---|---|
+| 模型分級 | 日常用便宜的 research/general，策略收斂才用 reasoning-heavy |
+| 限制 send 輪數 | peer-to-peer 預設 3 輪，最多 5 輪 |
+| coordinator 討論控制 | 每次最多收集 5 個 agent 觀點 |
+| cron 頻率合理 | 不需要的 agent 不要排太密 |
+| 記憶壓縮 | 秘書每日壓縮，避免 context 膨脹 |
+
+### 10.3 安全
+
+| 項目 | 措施 |
+|---|---|
+| API Key | 環境變數，不進版本控制 |
+| Agent 權限 | SOUL.md 嚴格定義 Forbidden + 工具白名單 |
+| 交易執行 | 必須 HITL 批准 |
+| Discord | Server 設為私人 |
+| OpenClaw 更新 | 追蹤安全公告，及時更新 |
+
+### 10.4 停損信號
+
+| 信號 | 動作 |
+|---|---|
+| 月費用超預期 2 倍 | 暫停非必要 agent |
+| 反覆 revise 超過 5 輪 | 人工介入調整 prompt |
+| 回測 winrate > 90% | 停下檢查 overfitting |
+| Agent 產出品質下降 | 檢查記憶 + prompt |
+
+---
+
+## 附錄：文件索引
+
+| 文件 | 內容 |
+|---|---|
+| `spec_v4_system_overview.md` | 第一部分：系統總覽 |
+| `spec_v4_org_and_roles.md` | 第二、三部分：組織架構 + 角色定義 |
+| `spec_v4_collaboration_scheduling_memory.md` | 第四~七部分：協作 + 排程 + 記憶 + Discord |
+| `spec_v4_rollout_and_risks.md` | 第八~十部分：Schema + 上線 + 風險 |
+| `spec_v3_schemas.md` | JSON Schema（v3 版沿用） |

docs/spec/spec_v4_system_overview.md

@@ -0,0 +1,96 @@
+# KingClawArmy AI Agent Team - 系統規格書 v4
+
+> 版本：v4.0  
+> 日期：2026-04-09  
+> 狀態：初版定稿  
+> 前版差異：v3 為 Paperclip + Discord + Mem0 多系統架構，v4 簡化為純 OpenClaw 架構
+
+---
+
+## 第一部分：系統總覽
+
+### 1.1 系統目標
+
+建立一個 AI Agent 團隊（代號 KingClawArmy），能夠：
+
+1. **量化研究**：情報蒐集 → 市場結構分析 → 多空辯論 → 策略形成 → 回測 → 分析
+2. **行銷策略**：市場研究 → 品牌/成長策略 → 投放分析
+3. **內容創作**：策略 → 文案撰寫 → 視覺方向
+4. **工程開發**：前端/後端（依需求啟用）
+5. **自主協作**：Agent 之間能交換資訊、討論、產出 1+1 > 2 的效果
+
+### 1.2 設計原則
+
+| 原則 | 說明 |
+|---|---|
+| **一套系統** | 全部用 OpenClaw，不疊加外部系統 |
+| **Model-Agnostic** | 不綁定任何 AI 模型，雲端或本地皆可 |
+| **漸進式上線** | 一隻一隻加入，觀察調整再擴編 |
+| **人類保留最終決策權** | 高風險動作必須經過董事長批准 |
+| **討論產生價值** | 關鍵決策點安排多 Agent 協作 |
+
+### 1.3 整體架構
+
+```
+┌────────────────────────────────────┐
+│            你（董事長）              │
+│      Discord 管理 + HITL 審批       │
+└─────────────────┬──────────────────┘
+                  │
+┌─────────────────▼──────────────────┐
+│           OpenClaw Gateway          │
+│                                     │
+│  ┌─ Agent 管理 ──────────────────┐ │
+│  │  agent routing + bindings     │ │
+│  │  sub-agent 派工               │ │
+│  │  sessions_send 溝通           │ │
+│  └───────────────────────────────┘ │
+│                                     │
+│  ┌─ 任務與排程 ──────────────────┐ │
+│  │  Task Flow 任務管理           │ │
+│  │  Cron 排程（5/6 欄位 + 時區） │ │
+│  │  Hooks 事件觸發（13+ 類型）   │ │
+│  │  Standing Orders 常駐指令     │ │
+│  └───────────────────────────────┘ │
+│                                     │
+│  ┌─ 記憶 ────────────────────────┐ │
+│  │  MEMORY.md 長期記憶           │ │
+│  │  daily notes 每日筆記         │ │
+│  │  memory_search 語意搜尋       │ │
+│  │  QMD/Honcho 跨 agent 記憶     │ │
+│  └───────────────────────────────┘ │
+│                                     │
+│  ┌─ 工作流 ──────────────────────┐ │
+│  │  Lobster DSL 多步驟流程       │ │
+│  │  審批 gate + timeout          │ │
+│  └───────────────────────────────┘ │
+│                                     │
+│  ┌─ 整合 ────────────────────────┐ │
+│  │  Discord 完整整合             │ │
+│  │  MCP 3,200+ skills            │ │
+│  │  30+ 通訊平台                 │ │
+│  └───────────────────────────────┘ │
+│                                     │
+│  ┌─ 模型（隨你接）──────────────┐ │
+│  │  Claude / GPT / DeepSeek      │ │
+│  │  Gemini / 本地 Ollama / vLLM  │ │
+│  └───────────────────────────────┘ │
+└─────────────────────────────────────┘
+```
+
+### 1.4 為什麼只用 OpenClaw
+
+| 之前考慮的工具 | 為什麼不需要 |
+|---|---|
+| Paperclip | OpenClaw 的 agent routing + Task Flow + cron 已涵蓋調度；Discord 已涵蓋管理介面 |
+| Mem0 | OpenClaw 內建記憶 + QMD/Honcho 跨 agent 記憶已足夠 |
+| AutoGen | 群組辯論用 coordinator 模式替代；等 OpenClaw #18869 實裝後原生支援 |
+| n8n | OpenClaw cron + hooks 已涵蓋排程與事件觸發 |
+
+### 1.5 已知限制
+
+| 限制 | 影響 | 緩解方式 |
+|---|---|---|
+| 無原生群組辯論（#18869） | 3+ agent 即時辯論不支援 | coordinator 模式串行替代，或等原生支援 |
+| 無視覺化管理 UI | 沒有漂亮 dashboard | Discord slash commands + CLI 管理 |
+| 無 per-agent 預算 dashboard | 成本追蹤不方便 | 自訂 skill 追蹤 token 用量 |