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_rollout_and_risks.md

@@ -0,0 +1,138 @@
+# KingClawArmy - 第八部分：JSON Schema & 第九部分：上線計畫 & 第十部分：風險與限制
+
+---
+
+## 第八部分：JSON Schema
+
+**沿用 v3 版 schema，見 `spec_v3_schemas.md`。**
+
+schema 定義與系統架構無關（純資料格式），v3 版仍然適用。
+
+---
+
+## 第九部分：上線計畫
+
+### 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` 正常 |
+| 0.2 | 設定至少一個 AI model API | OpenClaw 能回應訊息 |
+| 0.3 | 設定記憶引擎（QMD 建議） | `memory_search` 可用 |
+| 0.4 | 建立 Discord Server + 頻道 | 頻道結構完成 |
+| 0.5 | 連接 OpenClaw Discord 整合 | Bot 在 Discord 上線 |
+| 0.6 | 建立 `~/.openclaw/openclaw.json` 基本結構 | config 可載入 |
+
+### 9.3 Phase 1：管理閉環
+
+| 步驟 | 動作 | 驗收 |
+|---|---|---|
+| 1.1 | 建立 CEO agent（SOUL.md + workspace） | Agent 回應正常 |
+| 1.2 | 設定 CEO 的 Discord binding | Discord 訊息能路由到 CEO |
+| 1.3 | 手動在 Discord 下達測試任務 | CEO 能理解並回應 |
+| 1.4 | 建立秘書 agent | 秘書能用 memory_search 讀取 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 的記憶（QMD extraCollections） |
+
+**Phase 1 完成標準：**
+- [ ] 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 版沿用） |