# 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 版沿用） |