Initial commit: KingClawArmy AI Agent Team spec v4

Pure OpenClaw architecture for 15-17 agent team covering quant research,
marketing, content, and engineering. Includes org structure, role definitions,
collaboration patterns, scheduling, memory architecture, Discord integration,
rollout plan, and JSON schemas.

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

docs/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 |