mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-10-09 03:17:54 +00:00
a80eec2267
Round-2 sweep after re-auditing all 15 reported issues against the merged dev: - #885 generalized: the original fix only renamed self-improving-agent's status/review, but three more plugins shipped skills whose bare names shadow Claude Code built-ins. Renamed with the same convention: playwright-pro init/review -> pw-init/pw-review, agenthub init/status -> hub-init/hub-status, autoresearch-agent status/resume -> ar-status/ ar-resume. All command references (/pw: /hub: /ar:), docs, audit records, harness manifests, and mirror trees/indexes updated; the flat mirror namespace no longer collides on 'status'. New scripts/check_skill_names.py gate (wired into ci-quality-gate.yml as blocking) fails CI on any future bare reserved name; rule added to SKILL-AUTHORING-STANDARD.md. - #969 follow-through: five more scripts print box-drawing characters that cannot exist in cp1252 (api_scorecard, api_linter, breaking_change_detector, humanizer_scorer, content_scorer) — same guarded UTF-8 reconfigure applied; all smoke-tested under a forced legacy encoding. Verified: check_skill_names (incl. negative test), check_plugin_json, check_paths, derive_counters, check_dual_publish, smoke_scripts (634/634), 0 broken mirror symlinks. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
93 lines
3.9 KiB
Markdown
93 lines
3.9 KiB
Markdown
---
|
|
title: "/hub:spawn — Launch Parallel Agents — Agent Skill for Codex & OpenClaw"
|
|
description: "Launch N parallel subagents in isolated git worktrees to compete on the session task. Use when the user runs /hub:spawn or asks to start the. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
|
---
|
|
|
|
# /hub:spawn — Launch Parallel Agents
|
|
|
|
<div class="page-meta" markdown>
|
|
<span class="meta-badge">:material-rocket-launch: Engineering - POWERFUL</span>
|
|
<span class="meta-badge">:material-identifier: `spawn`</span>
|
|
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/engineering/agenthub/skills/spawn/SKILL.md">Source</a></span>
|
|
</div>
|
|
|
|
<div class="install-banner" markdown>
|
|
<span class="install-label">Install:</span> <code>claude /plugin install engineering-advanced-skills</code>
|
|
</div>
|
|
|
|
|
|
Spawn N subagents that work on the same task in parallel, each in an isolated git worktree.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/hub:spawn # Spawn agents for the latest session
|
|
/hub:spawn 20260317-143022 # Spawn agents for a specific session
|
|
/hub:spawn --template optimizer # Use optimizer template for dispatch prompts
|
|
/hub:spawn --template refactorer # Use refactorer template
|
|
```
|
|
|
|
## Templates
|
|
|
|
When `--template <name>` is provided, use the dispatch prompt from [`references/agent-templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering/agenthub/skills/agenthub/references/agent-templates.md) instead of the default prompt below. Available templates:
|
|
|
|
| Template | Pattern | Use Case |
|
|
|----------|---------|----------|
|
|
| `optimizer` | Edit → eval → keep/discard → repeat x10 | Performance, latency, size reduction |
|
|
| `refactorer` | Restructure → test → iterate until green | Code quality, tech debt |
|
|
| `test-writer` | Write tests → measure coverage → repeat | Test coverage gaps |
|
|
| `bug-fixer` | Reproduce → diagnose → fix → verify | Bug fix with competing approaches |
|
|
|
|
When using a template, replace all `{variables}` with values from the session config. Assign each agent a **different strategy** appropriate to the template and task — diverse strategies maximize the value of parallel exploration.
|
|
|
|
## What It Does
|
|
|
|
1. Load session config from `.agenthub/sessions/{session-id}/config.yaml`
|
|
2. For each agent 1..N:
|
|
- Write task assignment to `.agenthub/board/dispatch/`
|
|
- Build agent prompt with task, constraints, and board write instructions
|
|
3. Launch ALL agents in a **single message** with multiple Agent tool calls:
|
|
|
|
```
|
|
Agent(
|
|
prompt: "You are agent-{i} in hub session {session-id}.
|
|
|
|
Your task: {task}
|
|
|
|
Read your full assignment at .agenthub/board/dispatch/{seq}-agent-{i}.md
|
|
|
|
Instructions:
|
|
1. Work in your worktree — make changes, run tests, iterate
|
|
2. Commit all changes with descriptive messages
|
|
3. Write your result summary to .agenthub/board/results/agent-{i}-result.md
|
|
Include: approach taken, files changed, metric if available, confidence level
|
|
4. Exit when done
|
|
|
|
Constraints:
|
|
- Do NOT read or modify other agents' work
|
|
- Do NOT access .agenthub/board/results/ for other agents
|
|
- Commit early and often with descriptive messages
|
|
- If you hit a dead end, commit what you have and explain in your result",
|
|
isolation: "worktree"
|
|
)
|
|
```
|
|
|
|
4. Update session state to `running` via:
|
|
```bash
|
|
python {skill_path}/scripts/session_manager.py --update {session-id} --state running
|
|
```
|
|
|
|
## Critical Rules
|
|
|
|
- **All agents in ONE message** — spawn all Agent tool calls simultaneously for true parallelism
|
|
- **isolation: "worktree"** is mandatory — each agent needs its own filesystem
|
|
- **Never modify session config** after spawn — agents rely on stable configuration
|
|
- **Each agent gets a unique board post** — dispatch posts are numbered sequentially
|
|
|
|
## After Spawn
|
|
|
|
Tell the user:
|
|
- {N} agents launched in parallel
|
|
- Each working in an isolated worktree
|
|
- Monitor with `/hub:hub-status`
|
|
- Evaluate when done with `/hub:eval`
|