feat: add Atomizer HQ multi-agent cluster infrastructure
- 8-agent OpenClaw cluster (Manager, Tech-Lead, Secretary, Auditor, Optimizer, Study-Builder, NX-Expert, Webster) - Orchestration engine: orchestrate.py (sync delegation + handoffs) - Workflow engine: YAML-defined multi-step pipelines - Agent workspaces: SOUL.md, AGENTS.md, MEMORY.md per agent - Shared skills: delegate, orchestrate, atomizer-protocols - Capability registry (AGENTS_REGISTRY.json) - Cluster management: cluster.sh, systemd template - All secrets replaced with env var references
This commit is contained in:
68
hq/workspaces/shared/skills/delegate/SKILL.md
Normal file
68
hq/workspaces/shared/skills/delegate/SKILL.md
Normal file
@@ -0,0 +1,68 @@
|
||||
# Delegate Task to Another Agent
|
||||
|
||||
Sends a task to another Atomizer agent via the OpenClaw Hooks API. The target agent processes the task in an isolated session and optionally delivers the response to Discord.
|
||||
|
||||
## When to Use
|
||||
|
||||
- You need another agent to perform a task (research, analysis, NX work, etc.)
|
||||
- You want to assign work and get a response in a Discord channel
|
||||
- Cross-agent orchestration
|
||||
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
bash /home/papa/atomizer/workspaces/shared/skills/delegate/delegate.sh <agent> "<instruction>" [options]
|
||||
```
|
||||
|
||||
### Agents
|
||||
|
||||
| Agent | Specialty |
|
||||
|-------|-----------|
|
||||
| `manager` | Orchestration, project oversight |
|
||||
| `tech-lead` | Technical decisions, FEA review |
|
||||
| `secretary` | Meeting notes, admin, status updates |
|
||||
| `auditor` | Quality checks, compliance review |
|
||||
| `optimizer` | Optimization setup, parameter studies |
|
||||
| `study-builder` | Study configuration, DOE |
|
||||
| `nx-expert` | NX/Simcenter operations |
|
||||
| `webster` | Web research, literature search |
|
||||
|
||||
### Options
|
||||
|
||||
- `--channel <discord-channel-id>` — Route response to a specific Discord channel
|
||||
- `--deliver` / `--no-deliver` — Whether to post response to Discord (default: deliver)
|
||||
|
||||
### Examples
|
||||
|
||||
```bash
|
||||
# Ask Webster to research something
|
||||
bash /home/papa/atomizer/workspaces/shared/skills/delegate/delegate.sh webster "Find the CTE of Zerodur Class 0 between 20-40°C"
|
||||
|
||||
# Assign NX work with channel routing
|
||||
bash /home/papa/atomizer/workspaces/shared/skills/delegate/delegate.sh nx-expert "Create mesh convergence study for M2 mirror" --channel C0AEJV13TEU
|
||||
|
||||
# Ask auditor to review without posting to Discord
|
||||
bash /home/papa/atomizer/workspaces/shared/skills/delegate/delegate.sh auditor "Review the thermal analysis assumptions" --no-deliver
|
||||
```
|
||||
|
||||
## How It Works
|
||||
|
||||
1. Looks up the target agent's port from the cluster port map
|
||||
2. Checks if the target agent is running
|
||||
3. Sends a `POST /hooks/agent` request to the target's OpenClaw instance
|
||||
4. Target agent processes the task in an isolated session
|
||||
5. Response is delivered to Discord if `--deliver` is set
|
||||
|
||||
## Response
|
||||
|
||||
The script outputs:
|
||||
- ✅ confirmation with run ID on success
|
||||
- ❌ error message with HTTP code on failure
|
||||
|
||||
The delegated task runs **asynchronously** — you won't get the result inline. The target agent will respond in Discord.
|
||||
|
||||
## Notes
|
||||
|
||||
- Tasks are fire-and-forget. Monitor the Discord channel for the response.
|
||||
- The target agent sees the message as a hook trigger, not a Discord message.
|
||||
- For complex multi-step workflows, delegate one step at a time.
|
||||
Reference in New Issue
Block a user