chris/KingClawArmy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: v4.1 協作協定重構、新增工具配置指南

Browse Source 
- 新增 spec_v4_collaboration_protocol.md：Message Envelope、Intent 類型、
  Pipeline 改由策略師主導、Lobster DSL 取代 Standing Orders、輸出 Schema 定義
- 新增 guide_tools_skills.md：每個角色的 MCP Tools + Skills 配置對照表
- 改寫 guide_sessions_tools.md：修正 maxSpawnDepth 行為，sessions_send 不授權給子 agent
- 更新 agent_roster.md：新增 MCP Tools / Skills 欄位
- 更新排程記憶文件：移除舊協作章節，指向新協作協定
- 更新 INDEX.md：v4.1 索引與變更紀錄

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Chris
2026-04-10 02:30:39 +08:00
parent 513875c623
commit e44b959c85
6 changed files with 913 additions and 215 deletions
Download Patch File Download Diff File Expand all files Collapse all files

185
docs/spec/spec_v4_collaboration_scheduling_memory.md
View File

@@ -1,91 +1,14 @@
# KingClawArmy - 第四部分：協作模式 & 第五部分：排程與觸發 & 第六部分：記憶 & 第七部分：Discord
# KingClawArmy - 第五部分：排程與觸發 & 第六部分：記憶 & 第七部分：Discord
> 版本：v4.1
> 日期：2026-04-10
> 狀態：協作模式已獨立至 [spec_v4_collaboration_protocol.md](spec_v4_collaboration_protocol.md)
---
## 第四部分：協作模式
### 4.1 三種模式（全部在 OpenClaw 內完成）
| 模式 | OpenClaw 實現 | 場景 |
|---|---|---|
| **Orchestrator** | CEO 用 `sessions_spawn` 派工給 sub-agent | 日常任務分派 |
| **Peer-to-Peer** | Agent 之間用 `sessions_send` 來回溝通（最多 5 輪） | 追問、澄清、交叉驗證 |
| **Coordinator 討論** | CEO 用 `sessions_send` 逐一收集觀點再收斂 | 多方意見整合、辯論替代 |
### 4.2 協作模式詳細流程
#### Orchestrator（派工）
```
CEO 收到任務
↓
sessions_spawn("finance_researcher", task="蒐集今日盤前資訊")
↓
財經情報研究員在獨立 session 中執行
↓
完成後 push 結果回 CEO
↓
CEO 收到結果，spawn 下一個 agent
```
#### Peer-to-Peer（直接溝通）
```
量化策略研究員讀完多方報告後有疑問
↓
sessions_send("bullish_researcher", "你提到 OB 支撐，具體是哪個價位？")
↓
多方研究員回覆（ping-pong 最多 5 輪）
↓
量化策略研究員獲得澄清，繼續工作
```
#### Coordinator 討論（辯論替代方案）
```
CEO 需要整合多空觀點
↓
step 1: sessions_send("bullish_researcher", "總結你的核心做多論點")
step 2: sessions_send("bearish_researcher", "總結你的核心做空論點")
step 3: sessions_send("bearish_researcher", "針對多方的論點 [X]，你的反駁是？")
step 4: sessions_send("bullish_researcher", "針對空方的反駁 [Y]，你的回應是？")
step 5: sessions_send("quant_strategist", "以下是雙方觀點 [全文]，請收斂成策略")
↓
CEO 收到策略規格
```
### 4.3 什麼場景用什麼模式
| 場景 | 模式 | 理由 |
|---|---|---|
| 蒐集資料 | Orchestrator spawn | 獨立任務，不需互動 |
| 寫回測程式 | Orchestrator spawn | 獨立任務 |
| 多空辯論 | Coordinator 討論 | 需要多方觀點交叉 |
| 追問細節 | Peer-to-Peer send | 兩個 agent 直接對話 |
| 審查來回 | Peer-to-Peer send | 審查員與被審者 ping-pong |
| 跨團隊對齊 | Coordinator 討論 | CEO 逐一收集再收斂 |
| 你下達指令 | Discord → CEO | 你對 CEO 說話 |
| 需要你批准 | CEO → Discord @你 | HITL |
### 4.4 Review Gate
| 必審節點 | 觸發方式 |
|---|---|
| 量化策略提交 | CEO spawn 審查員 review |
| 回測結果提交 | CEO spawn 審查員 review |
| 工程交付 | CEO spawn 審查員 review |
| 文案對外 | CEO spawn 審查員 review |
### 4.5 HITL 節點
| 需要你批准的事 | 通知方式 |
|---|---|
| 正式部署 | Discord #approvals @你 |
| DB schema 變更 | Discord #approvals @你 |
| 廣告正式發布 | Discord #approvals @你 |
| 對外訊息發送 | Discord #approvals @你 |
| 金流操作 | Discord #approvals @你 |
| 量化策略正式執行 | Discord #approvals @你 |
> **注意：** 原第四部分「協作模式」已重寫並移至獨立文件：
> **[spec_v4_collaboration_protocol.md](spec_v4_collaboration_protocol.md)**
> 包含：Message Envelope、Intent 類型、Pipeline 架構、spawn/send 規則、輸出 Schema、Review Gate、HITL 節點
---
@@ -94,9 +17,12 @@ CEO 收到策略規格
### 5.1 Cron 排程
```bash
# 財經情報 — 每日盤前盤後
openclaw cron add --agent finance_researcher --cron "30 7 * * 1-5" --task "盤前資訊蒐集"
openclaw cron add --agent finance_researcher --cron "30 18 * * 1-5" --task "盤後資訊整理"
# 量化 pipeline — 每日盤前自動啟動
# 由 CEO spawn 策略師，策略師接管後續流程
openclaw cron add --agent ceo_coo --cron "30 7 * * 1-5" --task "啟動每日量化 pipeline"
# 財經情報（獨立）— 盤後整理
openclaw cron add --agent ceo_coo --cron "30 18 * * 1-5" --task "spawn 財經情報研究員做盤後整理"
# 市場研究 — 每日 + 每週
openclaw cron add --agent market_researcher --cron "0 10 * * *" --task "每日市場情報"
@@ -113,42 +39,11 @@ openclaw cron add --agent data_analyst --cron "0 10 * * 1" --task "每週數據
openclaw cron add --agent secretary --cron "0 23 * * *" --task "每日記憶壓縮與 State Diff"
```
### 5.2 事件觸發鏈（量化 pipeline）
### 5.2 事件觸發鏈
透過 CEO 的 Standing Orders 定義：
Pipeline 流程改由 **Lobster DSL** 定義（見 [spec_v4_collaboration_protocol.md](spec_v4_collaboration_protocol.md) 4.4 節），不再使用 Standing Orders。
```
CEO Standing Order: 量化研究流程
當收到財經情報完成通知：
→ spawn market_structure_researcher
當收到市場結構報告完成通知：
→ spawn bullish_researcher（平行）
→ spawn bearish_researcher（平行）
當收到多方 + 空方報告都完成：
→ 執行 coordinator 討論（收集雙方觀點）
→ spawn quant_strategist（帶入討論結果）
當收到量化策略完成通知：
→ spawn quant_engineer
當收到回測完成通知：
→ spawn data_analyst
當收到資料分析完成通知：
→ send secretary（做摘要）
→ spawn reviewer（審查整條 pipeline）
當收到審查 pass：
→ 組裝 Final_Decision_Packet
→ Discord @董事長 請求批准
當收到審查 revise：
→ 退回被點名角色
→ 如超過 3 輪 → Discord @董事長 介入
```
Cron 觸發 CEO → CEO spawn 策略師 → 策略師按 Lobster DSL 自動執行。
---
@@ -183,6 +78,10 @@ CEO Standing Order: 量化研究流程
| 每日筆記 | 自動載入今天+昨天；更舊的靠 memory_search |
| 秘書壓縮 | 每日 23:00 將當日重點寫入 MEMORY.md，清理冗餘 |
### 6.4 未來考量
當 Phase 3 行銷團隊加入後，跨團隊記憶需求增大時，可考慮導入 **MemOS**（100% 本地、SQLite 後端、混合搜尋、支援多 agent 協作），作為 QMD 的補強或替代。目前 OpenClaw 內建記憶系統足夠 Phase 1-2 使用。
---
## 第七部分：Discord Server 結構
@@ -193,14 +92,14 @@ CEO Standing Order: 量化研究流程
KingClawArmy Discord Server
│
├── 📋 管理
│ ├── #dashboard — 每日摘要、系統狀態
│ ├── #approvals — HITL 審批（你在這裡批准）
│ └── #errors — 錯誤與異常
│ ├── #執行長 — 執行長回覆董事長、進度回報
│ ├── #審批 — HITL 審批（董事長在這裡批准）
│ └── #異常 — 錯誤與異常
│
├── 📊 量化
│ ├── #quant-briefing — 盤前盤後情報
│ ├── #quant-discussion — 討論區（coordinator 討論結果貼這）
│ └── #quant-results — 策略定稿、回測結果
│ ├── #每日情報 — 盤前盤後情報
│ ├── #研究討論 — 研究過程摘要（pass 後）
│ └── #策略結果 — 策略定稿、回測結果
│
├── 📈 行銷
│ ├── #marketing-intel — 市場情報
@@ -209,20 +108,23 @@ KingClawArmy Discord Server
├── ✏️ 內容
│ └── #content-briefs — 文案 / 創意 brief
│
└── 📝 記錄
├── #meeting-logs — 所有 coordinator 討論記錄
└── #decision-log — 重大決策
├── 📝 記錄
│ ├── #每日摘要 — 秘書每日工作摘要
│ └── #決策紀錄 — 重大決策存檔
│
└── 💬 閒聊
└── #閒聊 — 小安陪聊
```
### 7.2 Discord 互動方式
| 你想做的事 | 怎麼做 |
|---|---|
| 下達新指令 | 在 #dashboard 或 DM 跟 CEO agent 說 |
| 下達新指令 | 在 #執行長 跟 CEO agent 說 |
| 查看進度 | 問 CEO 或秘書 |
| 批准高風險動作 | 在 #approvals 回覆 approve / reject |
| 看今日摘要 | #dashboard 自動推送（秘書每日產出） |
| 看回測結果 | #quant-results |
| 批准高風險動作 | 在 #審批 回覆 approve / reject |
| 看今日摘要 | #每日摘要 自動推送（秘書每日產出） |
| 看回測結果 | #策略結果 |
| 手動發起討論 | @CEO 說「召集量化團隊討論 [主題]」 |
| 緊急停止 | `openclaw tasks flow cancel <id>` 或 Discord @CEO「停止 [任務]」 |
@@ -230,9 +132,10 @@ KingClawArmy Discord Server
| 事件 | 推送到 | 由誰推送 |
|---|---|---|
| 任務完成 | 對應區域頻道 | CEO |
| 審查 pass（HITL） | #approvals | CEO |
| 審查 block | #errors + #approvals | CEO |
| 每日摘要 | #dashboard | 秘書 |
| 討論結論 | #meeting-logs | 秘書 |
| 錯誤/異常 | #errors | 相關 agent |
| Pipeline 完成 | #策略結果 + #審批 | CEO |
| 審查 pass（需 HITL） | #審批 | CEO |
| 審查 block | #異常 + #審批 | CEO |
| 每日情報 | #每日情報 | CEO（轉發情報員結果） |
| 每日摘要 | #每日摘要 | 秘書 |
| 決策紀錄 | #決策紀錄 | 秘書 |
| 錯誤/異常 | #異常 | CEO |