docs: prepare apply-ready multi-agent config patch
This commit is contained in:
Eve
@@ -442,3 +442,18 @@ Schema 核對後，每個 `agents.list[]` entry：
|
||||
- `coder` 與下游 agent 的 delegation 邊界是否符合預期
|
||||
- 套用後需要用哪些驗證動作確認 policy 真的生效
|
||||
|
||||
## 16. Apply-Ready Patch（2026-04-08）
|
||||
|
||||
本輪已再產出：
|
||||
|
||||
1. `docs/plans/2026-04-08-openclaw-config-apply-ready-patch.json`
|
||||
2. `docs/plans/2026-04-08-openclaw-config-apply-ready-runbook.md`
|
||||
|
||||
### 16.1 用途
|
||||
- `apply-ready-patch.json`：純 `gateway config.patch` payload 候選版
|
||||
- `apply-ready-runbook.md`：套用前後的操作順序與驗證清單
|
||||
|
||||
### 16.2 邊界
|
||||
這份 apply-ready patch 仍然**沒有被套用**。
|
||||
它的意義是：設計與文件已收斂到可以進入「等待總管批准後再 patch」的階段。
|
||||
|
||||
|
||||
236
docs/plans/2026-04-08-openclaw-config-apply-ready-patch.json
Normal file
236
docs/plans/2026-04-08-openclaw-config-apply-ready-patch.json
Normal file
@@ -0,0 +1,236 @@
|
||||
{
|
||||
"agents": {
|
||||
"defaults": {
|
||||
"workspace": null
|
||||
},
|
||||
"list": [
|
||||
{
|
||||
"id": "coder",
|
||||
"name": "Eve",
|
||||
"workspace": "/home/alice/.openclaw/workspace",
|
||||
"model": {
|
||||
"primary": "cowbay/gpt-5.4",
|
||||
"fallbacks": [
|
||||
"ollama/minimax-m2.5:cloud",
|
||||
"cowbay/minimax/minimax-m2.5:free",
|
||||
"cowbay/kilo-auto/free"
|
||||
]
|
||||
},
|
||||
"identity": {
|
||||
"name": "Eve",
|
||||
"theme": "gentle coordinator and overseer",
|
||||
"emoji": "🤖"
|
||||
},
|
||||
"skills": [
|
||||
"using-superpowers",
|
||||
"executing-plans",
|
||||
"requesting-code-review",
|
||||
"verification-before-completion",
|
||||
"writing-plans",
|
||||
"using-git-worktrees",
|
||||
"subagent-driven-development"
|
||||
],
|
||||
"subagents": {
|
||||
"allowAgents": [
|
||||
"prompt-optimizer",
|
||||
"reviewer",
|
||||
"research",
|
||||
"engineering",
|
||||
"ops"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "prompt-optimizer",
|
||||
"name": "Prompt Optimizer",
|
||||
"workspace": "/home/alice/.openclaw/workspace-prompt-optimizer",
|
||||
"model": {
|
||||
"primary": "cowbay/gpt-5.4",
|
||||
"fallbacks": [
|
||||
"ollama/minimax-m2.5:cloud",
|
||||
"cowbay/minimax/minimax-m2.5:free",
|
||||
"cowbay/kilo-auto/free"
|
||||
]
|
||||
},
|
||||
"identity": {
|
||||
"name": "Prompt Optimizer",
|
||||
"theme": "task clarification and execution drafting",
|
||||
"emoji": "🧭"
|
||||
},
|
||||
"skills": [
|
||||
"using-superpowers"
|
||||
],
|
||||
"tools": {
|
||||
"deny": [
|
||||
"message",
|
||||
"gateway",
|
||||
"cron",
|
||||
"nodes",
|
||||
"sessions_spawn"
|
||||
]
|
||||
},
|
||||
"subagents": {
|
||||
"allowAgents": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "reviewer",
|
||||
"name": "Reviewer",
|
||||
"workspace": "/home/alice/.openclaw/workspace-reviewer",
|
||||
"model": {
|
||||
"primary": "cowbay/gpt-5.4",
|
||||
"fallbacks": [
|
||||
"ollama/minimax-m2.5:cloud",
|
||||
"cowbay/minimax/minimax-m2.5:free",
|
||||
"cowbay/kilo-auto/free"
|
||||
]
|
||||
},
|
||||
"identity": {
|
||||
"name": "Reviewer",
|
||||
"theme": "strict verification and evidence review",
|
||||
"emoji": "🛡️"
|
||||
},
|
||||
"skills": [
|
||||
"using-superpowers",
|
||||
"verification-before-completion",
|
||||
"requesting-code-review"
|
||||
],
|
||||
"tools": {
|
||||
"deny": [
|
||||
"message",
|
||||
"gateway",
|
||||
"cron",
|
||||
"nodes",
|
||||
"sessions_spawn"
|
||||
]
|
||||
},
|
||||
"subagents": {
|
||||
"allowAgents": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "research",
|
||||
"name": "Research",
|
||||
"workspace": "/home/alice/.openclaw/workspace-research",
|
||||
"model": {
|
||||
"primary": "cowbay/gpt-5.4",
|
||||
"fallbacks": [
|
||||
"ollama/minimax-m2.5:cloud",
|
||||
"cowbay/minimax/minimax-m2.5:free",
|
||||
"cowbay/kilo-auto/free"
|
||||
]
|
||||
},
|
||||
"identity": {
|
||||
"name": "Research",
|
||||
"theme": "source-based investigation and comparison",
|
||||
"emoji": "🔎"
|
||||
},
|
||||
"skills": [
|
||||
"using-superpowers",
|
||||
"tavily-search",
|
||||
"serpapi",
|
||||
"github"
|
||||
],
|
||||
"tools": {
|
||||
"deny": [
|
||||
"message",
|
||||
"gateway",
|
||||
"cron",
|
||||
"nodes",
|
||||
"sessions_spawn"
|
||||
]
|
||||
},
|
||||
"subagents": {
|
||||
"allowAgents": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "engineering",
|
||||
"name": "Engineering",
|
||||
"workspace": "/home/alice/.openclaw/workspace-engineering",
|
||||
"model": {
|
||||
"primary": "cowbay/gpt-5.4",
|
||||
"fallbacks": [
|
||||
"ollama/minimax-m2.5:cloud",
|
||||
"cowbay/minimax/minimax-m2.5:free",
|
||||
"cowbay/kilo-auto/free"
|
||||
]
|
||||
},
|
||||
"identity": {
|
||||
"name": "Engineering",
|
||||
"theme": "implementation debugging and validation",
|
||||
"emoji": "🧰"
|
||||
},
|
||||
"skills": [
|
||||
"using-superpowers",
|
||||
"test-patterns",
|
||||
"requesting-code-review",
|
||||
"verification-before-completion"
|
||||
],
|
||||
"tools": {
|
||||
"deny": [
|
||||
"message",
|
||||
"gateway",
|
||||
"cron",
|
||||
"nodes",
|
||||
"sessions_spawn"
|
||||
]
|
||||
},
|
||||
"subagents": {
|
||||
"allowAgents": []
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "ops",
|
||||
"name": "Ops",
|
||||
"workspace": "/home/alice/.openclaw/workspace-ops",
|
||||
"model": {
|
||||
"primary": "cowbay/gpt-5.4",
|
||||
"fallbacks": [
|
||||
"ollama/minimax-m2.5:cloud",
|
||||
"cowbay/minimax/minimax-m2.5:free",
|
||||
"cowbay/kilo-auto/free"
|
||||
]
|
||||
},
|
||||
"identity": {
|
||||
"name": "Ops",
|
||||
"theme": "operations diagnostics and safe change planning",
|
||||
"emoji": "⚙️"
|
||||
},
|
||||
"skills": [
|
||||
"using-superpowers",
|
||||
"healthcheck",
|
||||
"github"
|
||||
],
|
||||
"tools": {
|
||||
"deny": [
|
||||
"message",
|
||||
"gateway",
|
||||
"cron",
|
||||
"nodes",
|
||||
"sessions_spawn"
|
||||
]
|
||||
},
|
||||
"subagents": {
|
||||
"allowAgents": []
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
"tools": {
|
||||
"sessions": {
|
||||
"visibility": "all"
|
||||
},
|
||||
"agentToAgent": {
|
||||
"enabled": true,
|
||||
"allow": [
|
||||
"coder",
|
||||
"prompt-optimizer",
|
||||
"reviewer",
|
||||
"research",
|
||||
"engineering",
|
||||
"ops"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
52
docs/plans/2026-04-08-openclaw-config-apply-ready-runbook.md
Normal file
52
docs/plans/2026-04-08-openclaw-config-apply-ready-runbook.md
Normal file
@@ -0,0 +1,52 @@
|
||||
# 2026-04-08 OpenClaw Apply-Ready Patch Runbook
|
||||
|
||||
這份文件的用途，是把 `2026-04-08-openclaw-config-apply-ready-patch.json` 的使用方式講清楚。
|
||||
|
||||
## 1. 定位
|
||||
- 這份 `apply-ready patch` 是**純 payload**
|
||||
- 不包含設計說明、備忘、註解或非 schema 欄位
|
||||
- 目標：在總管明確批准後，可直接作為 `gateway config.patch` 的候選輸入
|
||||
|
||||
## 2. 套用前條件
|
||||
套用前應先確認：
|
||||
- 各 agent workspace 已存在
|
||||
- prompt / workflow 檔案已建立
|
||||
- 總管已明確批准進行 config 變更
|
||||
- 已準備好套用後驗證步驟
|
||||
|
||||
## 3. 套用前建議順序
|
||||
1. 重新讀取目前 live config 的 `agents` / `tools.sessions` / `tools.agentToAgent`
|
||||
2. 再次確認這份 patch 仍符合最新設計
|
||||
3. 取得總管明確批准
|
||||
4. 執行 `gateway config.patch`
|
||||
5. 套用後立刻做驗證
|
||||
|
||||
## 4. 套用後必驗項
|
||||
### 4.1 結構驗證
|
||||
- `agents.list` 應為 6 個 agent
|
||||
- `agents.defaults.workspace` 應被刪除
|
||||
- 每個 agent 應有自己的 `workspace`
|
||||
- `tools.sessions.visibility` 應為 `all`
|
||||
- `tools.agentToAgent.enabled` 應為 `true`
|
||||
|
||||
### 4.2 行為驗證
|
||||
- `coder` → `reviewer` 的 `sessions_spawn` 應成功
|
||||
- `reviewer` → `engineering` 的 `sessions_spawn` 應失敗
|
||||
- 下游 agent 呼叫 `message` / `gateway` / `cron` / `nodes` 應被拒絕
|
||||
- 下游 agent 呼叫 `sessions_spawn` 應被拒絕
|
||||
|
||||
### 4.3 邊界驗證
|
||||
- `skills` allowlist 應如預期生效
|
||||
- `tools.deny` 應如預期生效
|
||||
- 子代理不應直接越過 Eve 對上回話
|
||||
|
||||
## 5. 失敗時回退策略
|
||||
如果套用後驗證失敗：
|
||||
1. 先停止繼續擴大測試
|
||||
2. 立即回報總管與 Eve 的驗證結果
|
||||
3. 重新讀取 live config 差異
|
||||
4. 視情況用新的 `config.patch` 修正，或回退到先前配置
|
||||
|
||||
## 6. 注意
|
||||
- 這份檔案雖然叫 apply-ready，但**仍不等於已批准套用**
|
||||
- 真正執行 `gateway config.patch` 前，仍需總管明確同意
|
||||
Reference in New Issue
Block a user