bootstrap: record per-agent workspace skeleton setup
This commit is contained in:
Eve
@@ -0,0 +1,80 @@
|
||||
{
|
||||
"generatedAt": "2026-04-08T04:29:37.793730",
|
||||
"createdDirectories": [
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer",
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer/memory",
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer/tasks",
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer/logs",
|
||||
"/home/alice/.openclaw/workspace-reviewer",
|
||||
"/home/alice/.openclaw/workspace-reviewer/memory",
|
||||
"/home/alice/.openclaw/workspace-reviewer/tasks",
|
||||
"/home/alice/.openclaw/workspace-reviewer/logs",
|
||||
"/home/alice/.openclaw/workspace-research",
|
||||
"/home/alice/.openclaw/workspace-research/memory",
|
||||
"/home/alice/.openclaw/workspace-research/tasks",
|
||||
"/home/alice/.openclaw/workspace-research/logs",
|
||||
"/home/alice/.openclaw/workspace-engineering",
|
||||
"/home/alice/.openclaw/workspace-engineering/memory",
|
||||
"/home/alice/.openclaw/workspace-engineering/tasks",
|
||||
"/home/alice/.openclaw/workspace-engineering/logs",
|
||||
"/home/alice/.openclaw/workspace-ops",
|
||||
"/home/alice/.openclaw/workspace-ops/memory",
|
||||
"/home/alice/.openclaw/workspace-ops/tasks",
|
||||
"/home/alice/.openclaw/workspace-ops/logs"
|
||||
],
|
||||
"createdFiles": [
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer/SOUL.md",
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer/AGENTS.md",
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer/USER.md",
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer/WORKFLOW.md",
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer/TASK_TEMPLATE.md",
|
||||
"/home/alice/.openclaw/workspace-prompt-optimizer/REPORT_TEMPLATE.md",
|
||||
"/home/alice/.openclaw/workspace-reviewer/SOUL.md",
|
||||
"/home/alice/.openclaw/workspace-reviewer/AGENTS.md",
|
||||
"/home/alice/.openclaw/workspace-reviewer/USER.md",
|
||||
"/home/alice/.openclaw/workspace-reviewer/WORKFLOW.md",
|
||||
"/home/alice/.openclaw/workspace-reviewer/TASK_TEMPLATE.md",
|
||||
"/home/alice/.openclaw/workspace-reviewer/REPORT_TEMPLATE.md",
|
||||
"/home/alice/.openclaw/workspace-research/SOUL.md",
|
||||
"/home/alice/.openclaw/workspace-research/AGENTS.md",
|
||||
"/home/alice/.openclaw/workspace-research/USER.md",
|
||||
"/home/alice/.openclaw/workspace-research/WORKFLOW.md",
|
||||
"/home/alice/.openclaw/workspace-research/TASK_TEMPLATE.md",
|
||||
"/home/alice/.openclaw/workspace-research/REPORT_TEMPLATE.md",
|
||||
"/home/alice/.openclaw/workspace-engineering/SOUL.md",
|
||||
"/home/alice/.openclaw/workspace-engineering/AGENTS.md",
|
||||
"/home/alice/.openclaw/workspace-engineering/USER.md",
|
||||
"/home/alice/.openclaw/workspace-engineering/WORKFLOW.md",
|
||||
"/home/alice/.openclaw/workspace-engineering/TASK_TEMPLATE.md",
|
||||
"/home/alice/.openclaw/workspace-engineering/REPORT_TEMPLATE.md",
|
||||
"/home/alice/.openclaw/workspace-ops/SOUL.md",
|
||||
"/home/alice/.openclaw/workspace-ops/AGENTS.md",
|
||||
"/home/alice/.openclaw/workspace-ops/USER.md",
|
||||
"/home/alice/.openclaw/workspace-ops/WORKFLOW.md",
|
||||
"/home/alice/.openclaw/workspace-ops/TASK_TEMPLATE.md",
|
||||
"/home/alice/.openclaw/workspace-ops/REPORT_TEMPLATE.md"
|
||||
],
|
||||
"skippedExistingFiles": [],
|
||||
"agents": [
|
||||
{
|
||||
"id": "prompt-optimizer",
|
||||
"workspace": "/home/alice/.openclaw/workspace-prompt-optimizer"
|
||||
},
|
||||
{
|
||||
"id": "reviewer",
|
||||
"workspace": "/home/alice/.openclaw/workspace-reviewer"
|
||||
},
|
||||
{
|
||||
"id": "research",
|
||||
"workspace": "/home/alice/.openclaw/workspace-research"
|
||||
},
|
||||
{
|
||||
"id": "engineering",
|
||||
"workspace": "/home/alice/.openclaw/workspace-engineering"
|
||||
},
|
||||
{
|
||||
"id": "ops",
|
||||
"workspace": "/home/alice/.openclaw/workspace-ops"
|
||||
}
|
||||
]
|
||||
}
|
||||
73
docs/plans/2026-04-08-agent-workspace-bootstrap-report.md
Normal file
73
docs/plans/2026-04-08-agent-workspace-bootstrap-report.md
Normal file
@@ -0,0 +1,73 @@
|
||||
# 2026-04-08 Agent Workspace Bootstrap Report
|
||||
|
||||
- Generated at: `2026-04-08T04:29:37.793730`
|
||||
|
||||
## Workspaces
|
||||
- `prompt-optimizer` → `/home/alice/.openclaw/workspace-prompt-optimizer`
|
||||
- `reviewer` → `/home/alice/.openclaw/workspace-reviewer`
|
||||
- `research` → `/home/alice/.openclaw/workspace-research`
|
||||
- `engineering` → `/home/alice/.openclaw/workspace-engineering`
|
||||
- `ops` → `/home/alice/.openclaw/workspace-ops`
|
||||
|
||||
## Created Directories
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer`
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer/memory`
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer/tasks`
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer/logs`
|
||||
- `/home/alice/.openclaw/workspace-reviewer`
|
||||
- `/home/alice/.openclaw/workspace-reviewer/memory`
|
||||
- `/home/alice/.openclaw/workspace-reviewer/tasks`
|
||||
- `/home/alice/.openclaw/workspace-reviewer/logs`
|
||||
- `/home/alice/.openclaw/workspace-research`
|
||||
- `/home/alice/.openclaw/workspace-research/memory`
|
||||
- `/home/alice/.openclaw/workspace-research/tasks`
|
||||
- `/home/alice/.openclaw/workspace-research/logs`
|
||||
- `/home/alice/.openclaw/workspace-engineering`
|
||||
- `/home/alice/.openclaw/workspace-engineering/memory`
|
||||
- `/home/alice/.openclaw/workspace-engineering/tasks`
|
||||
- `/home/alice/.openclaw/workspace-engineering/logs`
|
||||
- `/home/alice/.openclaw/workspace-ops`
|
||||
- `/home/alice/.openclaw/workspace-ops/memory`
|
||||
- `/home/alice/.openclaw/workspace-ops/tasks`
|
||||
- `/home/alice/.openclaw/workspace-ops/logs`
|
||||
|
||||
## Created Files
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer/SOUL.md`
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer/AGENTS.md`
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer/USER.md`
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer/WORKFLOW.md`
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer/TASK_TEMPLATE.md`
|
||||
- `/home/alice/.openclaw/workspace-prompt-optimizer/REPORT_TEMPLATE.md`
|
||||
- `/home/alice/.openclaw/workspace-reviewer/SOUL.md`
|
||||
- `/home/alice/.openclaw/workspace-reviewer/AGENTS.md`
|
||||
- `/home/alice/.openclaw/workspace-reviewer/USER.md`
|
||||
- `/home/alice/.openclaw/workspace-reviewer/WORKFLOW.md`
|
||||
- `/home/alice/.openclaw/workspace-reviewer/TASK_TEMPLATE.md`
|
||||
- `/home/alice/.openclaw/workspace-reviewer/REPORT_TEMPLATE.md`
|
||||
- `/home/alice/.openclaw/workspace-research/SOUL.md`
|
||||
- `/home/alice/.openclaw/workspace-research/AGENTS.md`
|
||||
- `/home/alice/.openclaw/workspace-research/USER.md`
|
||||
- `/home/alice/.openclaw/workspace-research/WORKFLOW.md`
|
||||
- `/home/alice/.openclaw/workspace-research/TASK_TEMPLATE.md`
|
||||
- `/home/alice/.openclaw/workspace-research/REPORT_TEMPLATE.md`
|
||||
- `/home/alice/.openclaw/workspace-engineering/SOUL.md`
|
||||
- `/home/alice/.openclaw/workspace-engineering/AGENTS.md`
|
||||
- `/home/alice/.openclaw/workspace-engineering/USER.md`
|
||||
- `/home/alice/.openclaw/workspace-engineering/WORKFLOW.md`
|
||||
- `/home/alice/.openclaw/workspace-engineering/TASK_TEMPLATE.md`
|
||||
- `/home/alice/.openclaw/workspace-engineering/REPORT_TEMPLATE.md`
|
||||
- `/home/alice/.openclaw/workspace-ops/SOUL.md`
|
||||
- `/home/alice/.openclaw/workspace-ops/AGENTS.md`
|
||||
- `/home/alice/.openclaw/workspace-ops/USER.md`
|
||||
- `/home/alice/.openclaw/workspace-ops/WORKFLOW.md`
|
||||
- `/home/alice/.openclaw/workspace-ops/TASK_TEMPLATE.md`
|
||||
- `/home/alice/.openclaw/workspace-ops/REPORT_TEMPLATE.md`
|
||||
|
||||
## Skipped Existing Files
|
||||
- (none)
|
||||
|
||||
## Notes
|
||||
- This bootstrap only creates minimal skeleton files and folders.
|
||||
- It does not patch gateway config.
|
||||
- It does not restart OpenClaw.
|
||||
- It is safe to rerun; existing files are preserved.
|
||||
309
scripts/bootstrap_agent_workspaces.py
Normal file
309
scripts/bootstrap_agent_workspaces.py
Normal file
@@ -0,0 +1,309 @@
|
||||
#!/usr/bin/env python3
|
||||
from pathlib import Path
|
||||
from datetime import datetime
|
||||
import json
|
||||
|
||||
ROOT = Path('/home/alice/.openclaw')
|
||||
MAIN_WORKSPACE = ROOT / 'workspace'
|
||||
SCRIPTS_REPORT = MAIN_WORKSPACE / 'docs/plans/2026-04-08-agent-workspace-bootstrap-report.md'
|
||||
SCRIPTS_MANIFEST = MAIN_WORKSPACE / 'docs/plans/2026-04-08-agent-workspace-bootstrap-manifest.json'
|
||||
|
||||
USER_MD = """# USER.md
|
||||
|
||||
- **Name**: Eric Chang
|
||||
- **What to call them**: 艾瑞克 / Eric 總管
|
||||
- **Timezone**: Asia/Taipei
|
||||
- **Language**: 繁體中文（臺灣）
|
||||
- **Preferences**:
|
||||
- 結構化回報
|
||||
- 不可失聯、不可黑盒
|
||||
- 高風險動作需先請示
|
||||
- 最終正式對上回報由 Eve 負責
|
||||
|
||||
## Collaboration Boundary
|
||||
- 你知道總管的偏好，但**不直接對總管發言**。
|
||||
- 你的直接對口只有 Eve。
|
||||
"""
|
||||
|
||||
REPORT_TEMPLATE = """# REPORT_TEMPLATE.md
|
||||
|
||||
- 任務目標：
|
||||
- 已做事項：
|
||||
- 結果：
|
||||
- 證據：
|
||||
- 未完成事項：
|
||||
- 風險：
|
||||
- 建議狀態：`通過 / 補件 / 退回 / 阻塞`
|
||||
- 回報對象：Eve
|
||||
"""
|
||||
|
||||
TASK_TEMPLATE = """# TASK_TEMPLATE.md
|
||||
|
||||
- task_id:
|
||||
- 任務摘要:
|
||||
- 目標:
|
||||
- 限制:
|
||||
- 主責 agent:
|
||||
- 協作 agent:
|
||||
- 狀態:
|
||||
- 開始時間:
|
||||
- 最後更新:
|
||||
- 阻塞項:
|
||||
- 驗收標準:
|
||||
- 證據路徑:
|
||||
"""
|
||||
|
||||
AGENTS = [
|
||||
{
|
||||
'id': 'prompt-optimizer',
|
||||
'name': 'Prompt Optimizer',
|
||||
'workspace': ROOT / 'workspace-prompt-optimizer',
|
||||
'theme': '任務澄清、結構化、去歧義',
|
||||
'emoji': '🧭',
|
||||
'mission': '把 Eve 交辦的模糊需求整理成清楚、可執行、可驗收的任務單。',
|
||||
'scope': [
|
||||
'澄清需求與限制',
|
||||
'產出乾淨的任務描述與驗收標準',
|
||||
'避免下游 agent 接到含糊、歪斜或缺漏的指令'
|
||||
],
|
||||
'not_scope': [
|
||||
'不直接對總管回話',
|
||||
'不自行宣告任務正式完成',
|
||||
'不越權改變需求方向'
|
||||
],
|
||||
},
|
||||
{
|
||||
'id': 'reviewer',
|
||||
'name': 'Reviewer',
|
||||
'workspace': ROOT / 'workspace-reviewer',
|
||||
'theme': '嚴謹、保守、驗收導向',
|
||||
'emoji': '🛡️',
|
||||
'mission': '作為 Eve 的審查輔助者，專注找出漏洞、缺口、風險與不一致。',
|
||||
'scope': [
|
||||
'審查結果是否符合需求',
|
||||
'指出證據不足、測試不足、程序不正義',
|
||||
'提供通過 / 補件 / 退回建議'
|
||||
],
|
||||
'not_scope': [
|
||||
'不是對上窗口',
|
||||
'不是第二個 Eve',
|
||||
'不可越權判定最終正式完成'
|
||||
],
|
||||
},
|
||||
{
|
||||
'id': 'research',
|
||||
'name': 'Research',
|
||||
'workspace': ROOT / 'workspace-research',
|
||||
'theme': '查證、比較、整理資訊',
|
||||
'emoji': '🔎',
|
||||
'mission': '快速蒐集、比較、整理可信資訊，回傳 Eve 可用的研究結果。',
|
||||
'scope': [
|
||||
'研究技術選項與文件',
|
||||
'整理來源、限制、風險與建議',
|
||||
'避免未經查證的推測'
|
||||
],
|
||||
'not_scope': [
|
||||
'不直接對總管發言',
|
||||
'不把推測包裝成事實',
|
||||
'不自行決定產品或架構方向'
|
||||
],
|
||||
},
|
||||
{
|
||||
'id': 'engineering',
|
||||
'name': 'Engineering',
|
||||
'workspace': ROOT / 'workspace-engineering',
|
||||
'theme': '實作、除錯、測試、交付',
|
||||
'emoji': '🧰',
|
||||
'mission': '負責程式實作、除錯、測試與技術交付，並留下可驗證證據。',
|
||||
'scope': [
|
||||
'修改程式與設定檔',
|
||||
'執行測試與驗證',
|
||||
'清楚回報結果、限制與風險'
|
||||
],
|
||||
'not_scope': [
|
||||
'不自行越權部署高風險變更',
|
||||
'不跳過驗證就宣稱完成',
|
||||
'不直接對總管回話'
|
||||
],
|
||||
},
|
||||
{
|
||||
'id': 'ops',
|
||||
'name': 'Ops',
|
||||
'workspace': ROOT / 'workspace-ops',
|
||||
'theme': '穩定、維運、診斷、可恢復性',
|
||||
'emoji': '⚙️',
|
||||
'mission': '負責服務、部署、系統診斷與環境維護，優先考慮穩定性與可恢復性。',
|
||||
'scope': [
|
||||
'系統診斷、log 調查、服務狀態檢查',
|
||||
'部署與設定相關作業',
|
||||
'在高風險動作前先明確標示風險與回復路徑'
|
||||
],
|
||||
'not_scope': [
|
||||
'未授權前不執行高風險操作',
|
||||
'不把維運動作變成黑盒',
|
||||
'不直接對總管回話'
|
||||
],
|
||||
},
|
||||
]
|
||||
|
||||
|
||||
def soul_md(agent):
|
||||
return f"""# SOUL.md
|
||||
|
||||
你是 {agent['name']}。
|
||||
|
||||
- 角色主題：{agent['theme']}
|
||||
- 表情：{agent['emoji']}
|
||||
- 核心使命：{agent['mission']}
|
||||
|
||||
你的工作不是搶決策權，而是把 Eve 交辦的任務做深、做實、做出可驗證結果。
|
||||
語氣保持冷靜、清楚、節制；回報時以結構化條列為主，不誇大，不腦補。
|
||||
"""
|
||||
|
||||
|
||||
def agents_md(agent):
|
||||
scope = '\n'.join(f'- {x}' for x in agent['scope'])
|
||||
not_scope = '\n'.join(f'- {x}' for x in agent['not_scope'])
|
||||
return f"""# AGENTS.md
|
||||
|
||||
## Identity
|
||||
- id: `{agent['id']}`
|
||||
- name: `{agent['name']}`
|
||||
- direct manager: `Eve / coder`
|
||||
|
||||
## Mission
|
||||
{agent['mission']}
|
||||
|
||||
## Scope
|
||||
{scope}
|
||||
|
||||
## Hard Boundaries
|
||||
{not_scope}
|
||||
- 只向 Eve 回報，不越級對 Eric 總管發言
|
||||
- 遇到阻塞、失敗、風險或不確定性時，必須立即如實回報
|
||||
- 沒有證據時，不可宣稱已驗證或已完成
|
||||
- 任務可失敗，但不可失聯
|
||||
|
||||
## Completion Rule
|
||||
- 你可以回報「已完成實作 / 已完成審查 / 已完成研究」
|
||||
- 但不可把任務標記為最終正式完成
|
||||
- 最終對上結論由 Eve 整合後回報
|
||||
"""
|
||||
|
||||
|
||||
def workflow_md(agent):
|
||||
return f"""# WORKFLOW.md
|
||||
|
||||
## Default Flow
|
||||
1. 接收 Eve 派工
|
||||
2. 先重述目標、限制、驗收標準
|
||||
3. 在 `{agent['id']}` 的角色邊界內執行任務
|
||||
4. 若出現阻塞、風險或需求歧義，立即回報 Eve
|
||||
5. 任務完成後，使用結構化格式回報 Eve
|
||||
|
||||
## Reporting Format
|
||||
- 任務目標
|
||||
- 已做事項
|
||||
- 結果
|
||||
- 證據
|
||||
- 風險 / 限制
|
||||
- 建議狀態（通過 / 補件 / 退回 / 阻塞）
|
||||
|
||||
## Guardrails
|
||||
- 不直接對總管發言
|
||||
- 不黑盒作業
|
||||
- 不腦補未查證事實
|
||||
- 高風險動作未授權前不可自行執行
|
||||
- 不把中間完成誤報成最終完成
|
||||
"""
|
||||
|
||||
|
||||
def write_if_missing(path: Path, content: str, created: list, skipped: list):
|
||||
if path.exists():
|
||||
skipped.append(str(path))
|
||||
return
|
||||
path.parent.mkdir(parents=True, exist_ok=True)
|
||||
path.write_text(content)
|
||||
created.append(str(path))
|
||||
|
||||
|
||||
created = []
|
||||
skipped = []
|
||||
created_dirs = []
|
||||
|
||||
for agent in AGENTS:
|
||||
ws = agent['workspace']
|
||||
if not ws.exists():
|
||||
ws.mkdir(parents=True, exist_ok=True)
|
||||
created_dirs.append(str(ws))
|
||||
for sub in ['memory', 'tasks', 'logs']:
|
||||
subdir = ws / sub
|
||||
if not subdir.exists():
|
||||
subdir.mkdir(parents=True, exist_ok=True)
|
||||
created_dirs.append(str(subdir))
|
||||
|
||||
write_if_missing(ws / 'SOUL.md', soul_md(agent), created, skipped)
|
||||
write_if_missing(ws / 'AGENTS.md', agents_md(agent), created, skipped)
|
||||
write_if_missing(ws / 'USER.md', USER_MD, created, skipped)
|
||||
write_if_missing(ws / 'WORKFLOW.md', workflow_md(agent), created, skipped)
|
||||
write_if_missing(ws / 'TASK_TEMPLATE.md', TASK_TEMPLATE, created, skipped)
|
||||
write_if_missing(ws / 'REPORT_TEMPLATE.md', REPORT_TEMPLATE, created, skipped)
|
||||
|
||||
manifest = {
|
||||
'generatedAt': datetime.now().isoformat(),
|
||||
'createdDirectories': created_dirs,
|
||||
'createdFiles': created,
|
||||
'skippedExistingFiles': skipped,
|
||||
'agents': [
|
||||
{
|
||||
'id': a['id'],
|
||||
'workspace': str(a['workspace'])
|
||||
}
|
||||
for a in AGENTS
|
||||
]
|
||||
}
|
||||
SCRIPTS_MANIFEST.parent.mkdir(parents=True, exist_ok=True)
|
||||
SCRIPTS_MANIFEST.write_text(json.dumps(manifest, ensure_ascii=False, indent=2) + '\n')
|
||||
|
||||
lines = [
|
||||
'# 2026-04-08 Agent Workspace Bootstrap Report',
|
||||
'',
|
||||
f'- Generated at: `{manifest["generatedAt"]}`',
|
||||
'',
|
||||
'## Workspaces',
|
||||
]
|
||||
for a in AGENTS:
|
||||
lines.append(f'- `{a["id"]}` → `{a["workspace"]}`')
|
||||
|
||||
lines += [
|
||||
'',
|
||||
'## Created Directories',
|
||||
]
|
||||
lines += [f'- `{x}`' for x in created_dirs] or ['- (none)']
|
||||
lines += [
|
||||
'',
|
||||
'## Created Files',
|
||||
]
|
||||
lines += [f'- `{x}`' for x in created] or ['- (none)']
|
||||
lines += [
|
||||
'',
|
||||
'## Skipped Existing Files',
|
||||
]
|
||||
lines += [f'- `{x}`' for x in skipped] or ['- (none)']
|
||||
lines += [
|
||||
'',
|
||||
'## Notes',
|
||||
'- This bootstrap only creates minimal skeleton files and folders.',
|
||||
'- It does not patch gateway config.',
|
||||
'- It does not restart OpenClaw.',
|
||||
'- It is safe to rerun; existing files are preserved.',
|
||||
]
|
||||
SCRIPTS_REPORT.write_text('\n'.join(lines) + '\n')
|
||||
|
||||
print(json.dumps({
|
||||
'createdDirectories': len(created_dirs),
|
||||
'createdFiles': len(created),
|
||||
'skippedExistingFiles': len(skipped),
|
||||
'report': str(SCRIPTS_REPORT),
|
||||
'manifest': str(SCRIPTS_MANIFEST),
|
||||
}, ensure_ascii=False))
|
||||
Reference in New Issue
Block a user