From 1b66a00d22caf76a19ba5ed995107da11d179b58 Mon Sep 17 00:00:00 2001
From: Eve <eve@local>
Date: Tue, 7 Apr 2026 22:53:56 +0800
Subject: [PATCH] docs: refine multi-agent config decision notes

---
 .../plans/2026-04-07-openclaw-config-draft.md | 59 ++++++++++++++++---
 1 file changed, 51 insertions(+), 8 deletions(-)

diff --git a/docs/plans/2026-04-07-openclaw-config-draft.md b/docs/plans/2026-04-07-openclaw-config-draft.md
index 638c42f..3d4b43b 100644
--- a/docs/plans/2026-04-07-openclaw-config-draft.md
+++ b/docs/plans/2026-04-07-openclaw-config-draft.md
@@ -198,6 +198,13 @@ Schema 核對後，每個 `agents.list[]` entry：
 - `reasoningDefault`
 - `fastModeDefault`
 
+### 已額外核對到的可用欄位細節
+- `identity`：目前可放 `name` / `theme` / `emoji` / `avatar`
+- `skills`：是字串陣列，可作 agent skill allowlist
+- `tools`：可做 per-agent 工具限制（如 `allow` / `alsoAllow` / `deny` / `profile` 等）
+- `subagents`：目前至少確認可放 `allowAgents` / `model` / `thinking`
+- `runtime`：schema 有保留，但這次 lookup 沒展開出更細子欄位，暫不建議先寫死
+
 因此，第一版 ready draft 先聚焦在：
 - 穩定 agent id
 - 明確 workspace
@@ -313,15 +320,30 @@ Schema 核對後，每個 `agents.list[]` entry：
 - `openclaw-config-ready-draft.json` 應只保留 schema-backed config 欄位
 - `meta`、`phase`、`implementationNotes` 這類設計說明，應留在 markdown，不要混進可套用 JSON
 
-### B. 第二輪再決定每個 agent 要不要加進階欄位
-優先評估：
-- `skills`
-- `identity`
-- `tools`
-- `runtime`
-- `agentDir`
+### B. 第二輪優先決定哪些進階欄位要進第一版 config
+建議優先順序：
+1. `identity`（可讀性高、風險低）
+2. `skills`（可限制每個 agent 看到的 skill 範圍）
+3. `subagents.allowAgents`（若要進一步約束誰能派誰，值得優先研究）
+4. `tools`（高價值，但需非常小心別把 agent 卡死）
+5. `runtime` / `agentDir`（先保守）
 
-### C. 再建立各 agent 工作區與 prompt 檔案布局草案
+### C. 真正的制度邊界，分清楚哪裡該放 config、哪裡該放 prompt
+適合放 config：
+- workspace
+- model
+- sessions visibility
+- agentToAgent allowlist
+- per-agent tool policy
+- skill allowlist
+
+不適合假裝只靠 config 解決：
+- 只准 Eve 對總管回話
+- 子代理只能回 Eve
+- reviewer 不可越權判定完成
+- 失聯超時後的回報責任
+
+### D. 再建立各 agent 工作區與 prompt 檔案布局草案
 例如：
 - `SOUL.md`
 - `AGENTS.md`
@@ -340,3 +362,24 @@ Schema 核對後，每個 `agents.list[]` entry：
 - Eve 驗收後才正式回報
 
 如果照這份草案走，後續實作時就不會再回到那種多層朝廷式、難控、容易失聯的狀態。
+
+
+## 12. 下一輪收斂建議（往 config.patch 靠攏）
+
+若要再往前一步，我建議下一輪直接產出兩份：
+
+### 12.1 `config.patch` 候選版本
+只包含：
+- `agents.defaults`
+- `agents.list`
+- `tools.sessions.visibility`
+- `tools.agentToAgent`
+
+### 12.2 `policy-notes.md` 或沿用本檔
+專門保存：
+- Eve 才是唯一對上窗口
+- 子代理只能回 Eve
+- reviewer 的角色界線
+- 失聯 / 超時 / 重派的程序正義
+
+這樣可避免把制度描述誤塞進 schema 不保證存在的欄位，之後真的套用 config 時也較不容易踩坑。