docs: refine multi-agent config decision notes

This commit is contained in:
Eve
2026-04-07 22:53:56 +08:00
parent da3eb34054
commit 1b66a00d22

View File

@@ -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 時也較不容易踩坑。