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_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 用量 |