docs: 重整文件結構，移除 v2/v3 舊文檔，新增實作指南
- 刪除 v2/v3 所有舊規格文件 - 將 v4 規格文件移至 spec/ 目錄 - 新增 guides/ 目錄，包含： - guide_openclaw_config.md：openclaw.json 設定、Discord 接入、Gateway 管理 - guide_workspace_files.md：8 個 Workspace 設定檔正確用途 - guide_sessions_tools.md：sessions_spawn/send 參數與 Agents vs Sub-agent run 說明 - 更新 spec_v4_rollout_and_risks.md：加入 Phase 0/1 實際進度 - 新增 INDEX.md 文件索引 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Chris
142
docs/spec/spec_v4_rollout_and_risks.md
Normal file
142
docs/spec/spec_v4_rollout_and_risks.md
Normal file
@@ -0,0 +1,142 @@
|
||||
# KingClawArmy - 第八部分：JSON Schema & 第九部分：上線計畫 & 第十部分：風險與限制
|
||||
|
||||
---
|
||||
|
||||
## 第八部分：JSON Schema
|
||||
|
||||
JSON Schema 定義各 agent 產出格式，與系統架構無關（純資料格式）。
|
||||
詳細 schema 定義請參考各 agent 的 AGENTS.md 或實際輸出範例。
|
||||
|
||||
---
|
||||
|
||||
## 第九部分：上線計畫
|
||||
|
||||
### 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` 正常 | ✅ v2026.4.10 |
|
||||
| 0.2 | 設定 AI model API | OpenClaw 能回應訊息 | ✅ openai-codex |
|
||||
| 0.3 | 設定記憶引擎 | `memory_search` 可用 | 待確認 |
|
||||
| 0.4 | 建立 Discord Server + 頻道 | 頻道結構完成 | ✅ King Claw Server |
|
||||
| 0.5 | 連接 OpenClaw Discord 整合 | Bot 在 Discord 上線 | ✅ #總機 頻道已連接 |
|
||||
| 0.6 | 建立 `~/.openclaw/openclaw.json` | config 可載入 | ✅ |
|
||||
|
||||
**實際設定筆記：**
|
||||
- Discord Bot 需在 Developer Portal 開啟 Message Content Intent、Server Members Intent
|
||||
- 群組頻道路由須在 `channels.discord.guilds.<guildId>.channels` 設定，binding 用 `peer.kind: channel + peer.id: <channelId>`
|
||||
- Gateway 以 systemd user service 方式常駐執行
|
||||
|
||||
### 9.3 Phase 1：管理閉環 🔄
|
||||
|
||||
| 步驟 | 動作 | 驗收 | 狀態 |
|
||||
|---|---|---|---|
|
||||
| 1.1 | 建立 CEO agent（workspace 完整設定） | Agent 回應正常 | ✅ `ceo_coo` 已建立 |
|
||||
| 1.2 | 設定 CEO 的 Discord binding | Discord 訊息能路由到 CEO | ✅ #總機 已路由 |
|
||||
| 1.3 | 手動在 Discord 下達測試任務 | CEO 能理解並回應 | 🔄 測試中 |
|
||||
| 1.4 | 建立秘書 agent | 秘書能讀取 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 的記憶 | 待開始 |
|
||||
|
||||
**Phase 1 完成標準：**
|
||||
- [x] 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 版沿用） |
|
||||
Reference in New Issue
Block a user