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

148
docs/agent_roster.md
View File

@@ -1,28 +1,44 @@
# KingClawArmy Agent 花名冊
> 更新日期：2026-04-09
> 更新日期：2026-04-10
> 版本：v4.1（新增工具/技能配置、修正 pipeline 流程）
---
## 管理團隊（Phase 1）
| 職稱 | Emoji | Agent ID | 模型 | 狀態 | 輸出格式 |
|---|---|---|---|---|---|
| 執行長 | 🎯 | `ceo_coo` | gpt-5.4 | 常駐 | `Task_Spec.json`, `Final_Decision_Packet.json` |
| 秘書 | 📋 | `secretary` | gpt-5.4-mini | 常駐 | `Meeting_Summary.json`, `State_Diff.json`, `Todo_List.json` |
| 審查員 | 🔍 | `reviewer` | gpt-5.4 | Warm | `Review_Report.json` |
| 職稱 | Emoji | Agent ID | 模型 | 狀態 | 輸出格式 | MCP Tools | Skills |
|---|---|---|---|---|---|---|---|
| 執行長 | 🎯 | `ceo_coo` | gpt-5.4 | 常駐 | `Task_Spec.json`, `Final_Decision_Packet.json` | — | — |
| 秘書 | 📋 | `secretary` | gpt-5.4-mini | 常駐 | `Meeting_Summary.json`, `State_Diff.json`, `Todo_List.json` | — | GOG（選配） |
| 審查員 | 🔍 | `reviewer` | gpt-5.4 | Warm | `Review_Report.json` | — | — |
## 量化研究團隊（Phase 2）
| 職稱 | Emoji | Agent ID | 模型 | 狀態 | 輸出格式 |
|---|---|---|---|---|---|
| 財經情報研究員 | 💹 | `finance_researcher` | gpt-5.4-mini | 喚醒 | `Finance_Research_Brief.json` |
| 市場結構研究員 | 📈 | `market_structure_researcher` | gpt-5.4-mini | 喚醒 | `Market_Structure_Report.json` |
| 多方研究員 | 🚀 | `bullish_researcher` | gpt-5.4-mini | 喚醒 | `Bullish_Brief.json` |
| 空方研究員 | 🛡️ | `bearish_researcher` | gpt-5.4-mini | 喚醒 | `Bearish_Brief.json` |
| 量化策略師 | 🧭 | `quant_strategist` | gpt-5.4 | 喚醒 | `Strategy_Thesis.json` |
| 量化工程師 | ⚙️ | `quant_engineer` | gpt-5.4 | 喚醒 | `Backtest_Report.json` |
| 資料分析師 | 🧪 | `data_analyst` | gpt-5.4-mini | 喚醒 | `Data_Analysis_Report.json` |
| 職稱 | Emoji | Agent ID | 模型 | 狀態 | 輸出格式 | MCP Tools | Skills |
|---|---|---|---|---|---|---|---|
| 財經情報研究員 | 💹 | `finance_researcher` | gpt-5.4-mini | 喚醒 | `Finance_Research_Brief.json` | Tavily, Firecrawl, Financial Datasets | Deep Research |
| 市場結構研究員 | 📈 | `market_structure_researcher` | gpt-5.4-mini | 喚醒 | `Market_Structure_Report.json` | TradingView, Alpha Vantage | Deep Research |
| 多方研究員 | 🚀 | `bullish_researcher` | gpt-5.4-mini | 喚醒 | `Bullish_Brief.json` | — | — |
| 空方研究員 | 🛡️ | `bearish_researcher` | gpt-5.4-mini | 喚醒 | `Bearish_Brief.json` | — | — |
| 量化策略師 | 🧭 | `quant_strategist` | gpt-5.4 | 喚醒 | `Strategy_Thesis.json` | — | — |
| 回測工程師 | ⚙️ | `quant_engineer` | gpt-5.4 | 喚醒 | `Backtest_Report.json` | E2B / FinClaw | Code Reviewer |
| 資料分析師 | 🧪 | `data_analyst` | gpt-5.4-mini | 喚醒 | `Data_Analysis_Report.json` | E2B, Plotly | Deep Research |
## 行銷策略團隊（Phase 3 — 預規劃）
| 職稱 | Emoji | Agent ID | 模型 | 狀態 | 輸出格式 | MCP Tools | Skills |
|---|---|---|---|---|---|---|---|
| 市場研究員 | 🔎 | `market_researcher` | gpt-5.4-mini | 喚醒 | `Market_Research_Brief.json` | Tavily, Exa, Firecrawl | Deep Research |
| 策略總監 | 🎯 | `strategy_director` | gpt-5.4 | 喚醒 | `Brand_Strategy_Plan.json` | — | — |
| 投放分析師 | 📊 | `ads_analyst` | gpt-5.4-mini | 喚醒 | `Ads_Performance_Report.json` | 廣告平台 API, Plotly | — |
## 內容創意團隊（Phase 4 — 預規劃）
| 職稱 | Emoji | Agent ID | 模型 | 狀態 | 輸出格式 | MCP Tools | Skills |
|---|---|---|---|---|---|---|---|
| 文案撰寫員 | ✏️ | `copywriter` | gpt-5.4 | 喚醒 | `Copywriting_Pack.json` | — | SEO Blog Writer |
| 創意總監 | 🎨 | `creative_director` | gpt-5.4 | 喚醒 | `Creative_Brief.json` | DALL-E / Flux, Firecrawl | — |
## 閒聊
@@ -32,60 +48,98 @@
---
## 內建工具分配
每個 agent 除了外部 MCP/Skills 外，還有 OpenClaw 內建工具：
| Agent | 內建工具 |
|---|---|
| 🎯 CEO | `sessions_spawn`, `sessions_send`, `cron`, `memory_search`, Discord 工具 |
| 📋 秘書 | `memory_search`, `memory_write`, Discord 工具 |
| 🔍 審查員 | `memory_search` |
| 💹 情報員 | `memory_write`, `memory_search` |
| 📈 市場結構 | `memory_search` |
| 🚀 多方 | `memory_search` |
| 🛡️ 空方 | `memory_search` |
| 🧭 策略師 | `memory_search`, `sessions_spawn`, `subagents`, `sessions_list`, `sessions_history` |
| ⚙️ 回測 | `exec`, `code_execution`, `file_ops`, `memory_write` |
| 🧪 資料分析 | `code_execution`, `memory_search`, `memory_write` |
> **注意：** 策略師的 session 工具需要 `maxSpawnDepth ≥ 2` 才會生效（他是 depth-1 編排者）。
---
## Pipeline 流程
```
總司令 → 🎯執行長 sessions_send → 🧭策略師（pipeline 主人）
│
sessions_send ┌───┬───┼───┐
↓ ↓ ↓ ↓
💹 📈 🚀 🛡️
情報 結構 多方 空方
↓ ↓ ↓ ↓
└───┴───┴───┘
↓ 回覆策略師
🧭策略師收斂
↓
sessions_send → 🔍審查員
↕ revise 直接來回（退回原研究員修改）
pass ↓
🧭策略師發 #策略結果
↓
sessions_send → 🎯執行長「完成了」
↓
🎯執行長回報總司令
董事長 → 🎯執行長 spawn → 🧭策略師（pipeline owner, depth 1）
│
sessions_spawn ┌─┴──────────┐
↓ ↓
💹情報員 （等待）
(depth 2)
↓ announce
📈市場結構
(depth 2)
↓ announce
sessions_spawn ┌─┴─┐
↓ ↓
🚀 🛡️ ← 並行
多方 空方
(depth 2, depth 2)
↓ ↓
announce
↓
🧭策略師收斂
Strategy_Thesis.json
↓
sessions_spawn → 🔍審查員 (depth 2)
↕ revise → 重新 spawn 被退回角色（最多 3 輪）
pass ↓
sessions_spawn → 🧪資料分析 (depth 2)
↓ announce
🧭策略師 announce 給 🎯執行長
↓
🎯執行長 → Discord #審批 @董事長
例外：block → 策略師通知執行長 → 執行長發 #異常
例外：HITL → 策略師通知執行長 → 執行長發 #審批 @總司令
例外：每日情報 → 執行長直接 send 財經情報研究員 → 研究員自己發 #每日情報
例外：block → 策略師 escalate 執行長 → 執行長發 #異常
例外：revise > 3 輪 → 策略師 escalate 執行長 → 執行長發 #審批 @董事長
例外：每日情報 → 執行長 spawn 情報員 → 情報員 announce → 執行長發 #每日情報
例外：每日摘要 → 秘書自己發 #每日摘要 / #決策紀錄
```
---
## 通訊方式
| 方式 | 用途 | 誰用 |
|---|---|---|
| `sessions_send` | Agent 之間直接對話（最多 5 輪） | 所有 agent |
| `sessions_spawn` | 背景獨立任務（非阻塞） | 需要並行處理時 |
| `message` 工具 | 發到 Discord 頻道 | 只有通過審查的內容 |
| 方式 | 用途 | 誰能用 | 限制 |
|---|---|---|---|
| `sessions_spawn` | 非阻塞派工 | CEO（depth 0）、策略師（depth 1, 需 maxSpawnDepth ≥ 2） | 最多 5 並行 |
| `sessions_send` | 同步即時對話 | **僅 depth-0 agent**（CEO、秘書） | Sender 阻塞等回覆 |
| `announce` | 子 agent 回傳結果 | 所有被 spawn 的 agent | 單向往上 |
| `message` 工具 | 發到 Discord 頻道 | 通過審查的內容 | — |
---
## Discord 頻道
| 頻道 | 誰發 | 內容 |
|---|---|---|
| #執行長 | 🎯 執行長 | 回覆總司令、進度回報 |
| #執行長 | 🎯 執行長 | 回覆董事長、進度回報 |
| #審批 | 🎯 執行長 | HITL 審批請求 |
| #異常 | 🎯 執行長 | block、錯誤、異常 |
| #每日情報 | 💹 財經情報研究員 | 每日情報摘要 |
| #研究討論 | 🧭 策略師 | 研究過程摘要（pass 後） |
| #策略結果 | 🧭 策略師 | 最終策略定稿（pass 後） |
| #每日情報 | 🎯 執行長（轉發） | 情報員的每日情報摘要 |
| #研究討論 | 🎯 執行長（轉發） | 研究過程摘要（pass 後） |
| #策略結果 | 🎯 執行長（轉發） | 最終策略定稿（pass 後） |
| #每日摘要 | 📋 秘書 | 每日工作摘要 |
| #決策紀錄 | 📋 秘書 | 重大決策存檔 |
| #閒聊 | 🌿 小安 | 閒聊放鬆 |
---
## 模型分級
| 等級 | 模型 | 適用角色 |
|---|---|---|
| reasoning-heavy | gpt-5.4 | 執行長、審查員、量化策略師、量化工程師 |
| reasoning-heavy | gpt-5.4 | 執行長、審查員、量化策略師、回測工程師 |
| general / research | gpt-5.4-mini | 秘書、財經情報、市場結構、多空研究、資料分析、小安 |