# KingClawArmy 文件索引

> 版本：v4.1 | 更新日期：2026-04-10

---

## spec/ — 系統規格

系統設計的完整規格，定義整個 KingClawArmy 的架構、組織、角色與上線計畫。

| 文件 | 內容 |
|---|---|
| [spec_v4_system_overview.md](spec/spec_v4_system_overview.md) | 系統目標、設計原則、整體架構、為什麼只用 OpenClaw |
| [spec_v4_org_and_roles.md](spec/spec_v4_org_and_roles.md) | 組織架構、Agent 清單（15~17 agents）、各角色定義 |
| [spec_v4_collaboration_protocol.md](spec/spec_v4_collaboration_protocol.md) | **協作協定**：Message Envelope、Intent 類型、Pipeline 架構（策略師主導）、spawn/send 規則、輸出 Schema、Review Gate、HITL、錯誤處理 |
| [spec_v4_collaboration_scheduling_memory.md](spec/spec_v4_collaboration_scheduling_memory.md) | 排程觸發、記憶架構、Discord Server 結構 |
| [spec_v4_rollout_and_risks.md](spec/spec_v4_rollout_and_risks.md) | 上線計畫（Phase 0~5）、風險限制、成本控制、停損信號 |

---

## guides/ — 實作指南

實際操作時的參考手冊，涵蓋 OpenClaw 設定方式與工具使用。

| 文件 | 內容 |
|---|---|
| [guide_openclaw_config.md](guides/guide_openclaw_config.md) | openclaw.json 結構、Discord 接入、Gateway 管理、常用指令 |
| [guide_workspace_files.md](guides/guide_workspace_files.md) | 8 個 Workspace 設定檔的正確用途與應放內容 |
| [guide_sessions_tools.md](guides/guide_sessions_tools.md) | **sessions_spawn / sessions_send 行為**：maxSpawnDepth 工具權限、判斷規則、常見錯誤 |
| [guide_tools_skills.md](guides/guide_tools_skills.md) | **MCP Tools & Skills 配置**：每個角色的外部工具/技能、安裝方式、安全注意事項 |
| [agent_roster.md](agent_roster.md) | 全體 Agent 花名冊：職稱、代號、模型、狀態、輸出格式、工具/技能配置 |

---

## 進度追蹤

| Phase | 說明 | 狀態 |
|---|---|---|
| Phase 0 | 基礎設施（OpenClaw + Discord） | ✅ 完成 |
| Phase 1 | 管理閉環（執行長 + 秘書 + 審查員） | ✅ 完成 |
| Phase 2 | 量化閉環（7 agents） | ✅ 完成 |
| Phase 3 | 行銷閉環（3 agents） | 待開始 |
| Phase 4 | 內容閉環（2 agents） | 待開始 |
| Phase 5 | 工程團隊（依需求） | 待開始 |

---

## v4.0 → v4.1 主要變更

| 變更 | 說明 |
|---|---|
| 新增協作協定 | Message Envelope + Intent 取代自由文字溝通 |
| Pipeline 改由策略師主導 | CEO 只管啟動和例外，策略師 own 量化 pipeline |
| 修正 spawn/send 行為 | 釐清 maxSpawnDepth、sessions_send 不授權給子 agent |
| 新增輸出 Schema | 每個 agent 的 JSON 輸出格式定義 |
| 新增工具/技能配置 | 每個角色的 MCP Tools + Skills 對照表 |
| Standing Orders → Lobster DSL | Pipeline 流程改用結構化定義 |