spawn

/hub:spawn — 並列エージェントを起動する

同じタスクに並列で取り組む N 個のサブエージェントを、それぞれ独立した git ワークツリーで起動します。

使用方法

/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

テンプレート

--template <name> が指定されている場合は、以下のデフォルトのプロンプトではなく、../agenthub/references/agent-templates.md のディスパッチプロンプトを使用します。利用可能なテンプレートは次のとおりです。

テンプレート	パターン	用途
optimizer	編集 → 評価 → 採用／破棄 → 10 回繰り返す	パフォーマンス、レイテンシ、サイズの削減
refactorer	構成変更 → テスト → 成功するまで反復	コード品質、技術的負債
test-writer	テスト作成 → カバレッジ測定 → 繰り返す	テストカバレッジの不足
bug-fixer	再現 → 診断 → 修正 → 検証	アプローチを競わせるバグ修正

テンプレートを使用する場合は、すべての {variables} をセッション設定の値に置き換えてください。各エージェントには、テンプレートとタスクに適した異なる戦略を割り当ててください。多様な戦略により、並列探索の価値が最大化されます。

動作

1. .agenthub/sessions/{session-id}/config.yaml からセッション設定を読み込みます
2. 各エージェント 1..N について、次の処理を行います。
   • タスクの割り当てを .agenthub/board/dispatch/ に書き込みます
   • タスク、制約、ボードへの書き込み手順を含むエージェントプロンプトを作成します
3. 複数の Agent ツール呼び出しを使い、1 つのメッセージですべてのエージェントを起動します。

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. 次の方法でセッション状態を running に更新します。

python {skill_path}/scripts/session_manager.py --update {session-id} --state running

重要なルール

• すべてのエージェントは 1 つのメッセージで起動します — 真の並列処理を実現するため、すべての Agent ツール呼び出しを同時に行います
• isolation: "worktree" は必須です — 各エージェントには独自のファイルシステムが必要です
• 起動後にセッション設定を変更しないでください — エージェントは安定した設定を前提とします
• 各エージェントには固有のボード投稿を割り当てます — ディスパッチ投稿には連番を付けます

起動後

ユーザーに次の内容を伝えてください。

• {N} 個のエージェントを並列で起動したこと
• 各エージェントが独立したワークツリーで作業していること
• /hub:hub-status で進捗を確認できること
• 完了後は /hub:eval で評価できること