Files
KingClawArmy/docs/spec_v4_rollout_and_risks.md
Chris 8d97610634 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>
2026-04-09 03:39:29 +08:00

139 lines
5.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 agentSOUL.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 | 測試 HITLCEO @你 在 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. 建立 workspaceSOUL.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 分批 spawnCEO 做排隊 |
| 無視覺化管理 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 Schemav3 版沿用) |