菜单
Zellij の pane 管理を使って複数の Claude Code エージェントを並列起動し、タスクを分散実行するオーケストレータースキル。「swarm で」「並列エージェントで」「zellij swarm」「エージェントを N 個起動」「複数エージェントに分けて」などのリクエストがあった場合に使用します。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | zellij-swarm |
| description | Zellij の pane 管理を使って複数の Claude Code エージェントを並列起動し、タスクを分散実行するオーケストレータースキル。「swarm で」「並列エージェントで」「zellij swarm」「エージェントを N 個起動」「複数エージェントに分けて」などのリクエストがあった場合に使用します。 |
Zellij の pane 管理と git worktree を組み合わせ、複数の Claude Code エージェントが 独立したタスクを並列実行するワークフローです。
$ZELLIJ 環境変数が存在)zellij コマンドが PATH に存在すること.claude/skills/zellij-swarm/
├── SKILL.md # このファイル
├── templates/
│ ├── CLAUDE.md.template # エージェント用 CLAUDE.md テンプレート
│ └── claude-task.md.template # タスク定義テンプレート
└── scripts/
├── setup-worktrees.sh # Step 2: worktree 作成
├── launch-panes.sh # Step 4: Zellij ペイン起動
├── monitor.sh # Step 5: ステータス監視
├── merge.sh # Step 6: ブランチマージ
├── cleanup.sh # Step 7 + 緊急クリーンアップ
└── run-phase.sh # フェーズ制御: monitor + merge + cleanup の一括実行
ユーザーのタスクを独立したサブタスクに分割する:
タスク間に依存関係がある場合は フェーズ に分割する:
[a, b] → [c] → Phase 1 で a,b を並列、Phase 2 で c を実行分割できない場合 (同一ファイルへの書き込みが必要など) は swarm を使わず通常実行する。
scripts/setup-worktrees.sh を実行して worktree を作成する:
.claude/skills/zellij-swarm/scripts/setup-worktrees.sh agent-1 agent-2 agent-3
スクリプトは以下を行う:
REPO_ROOT を自動取得.gitworktree/<agent> に作成swarm/<agent> ブランチを作成各 worktree に Write tool で以下の 3 ファイル を作成する。
.gitworktree/<agent>/CLAUDE.md:
templates/CLAUDE.md.template の内容を Read tool で読み取り、Write tool で書き込む。
.gitworktree/<agent>/.claude-task.md:
templates/claude-task.md.template を参考に、具体的なタスク内容を記述して Write tool で書き込む。
.gitworktree/<agent>/.swarm-start.sh:
#!/bin/bash
TASK=$(cat .claude-task.md)
claude --dangerously-skip-permissions "$TASK"
作成後、Bash で chmod +x .gitworktree/<agent>/.swarm-start.sh を実行。
scripts/launch-panes.sh を実行してペインを起動する:
.claude/skills/zellij-swarm/scripts/launch-panes.sh agent-1 agent-2 agent-3
各ペインは .swarm-start.sh を経由して .claude-task.md の内容を初期プロンプトとして Claude に渡す。
scripts/monitor.sh を実行して全エージェントのステータスを監視する:
.claude/skills/zellij-swarm/scripts/monitor.sh agent-1 agent-2 agent-3
30 秒ごとにポーリングし、全エージェント完了時に自動終了する。
全エージェント完了後、scripts/merge.sh を実行してベースブランチにマージする:
.claude/skills/zellij-swarm/scripts/merge.sh agent-1 agent-2 agent-3
競合が発生した場合はエラーで停止するので、手動で解決してから再実行する。
scripts/cleanup.sh を実行して worktree とブランチを削除する:
.claude/skills/zellij-swarm/scripts/cleanup.sh agent-1 agent-2 agent-3
途中で中断した場合や worktree が壊れた場合は --force オプションを使用:
.claude/skills/zellij-swarm/scripts/cleanup.sh --force agent-1 agent-2 agent-3
.swarm-status の内容:
done|<ISO 8601 timestamp>|<1行サマリー>
例:
done|2026-02-21T10:30:00Z|add user authentication module
swarm/agent-1
swarm/agent-2
swarm/agent-N
タスクに依存関係がある場合、run-phase.sh を使ってフェーズを直列に繋ぐ。
setup-worktrees.sh + (Write task files) + launch-panes.sh
└─ run-phase.sh ← monitor.sh → merge.sh → cleanup.sh をまとめて実行
run-phase.sh はフェーズ内の全エージェント完了まで ブロック し、
完了後に merge → cleanup を自動実行する。
Phase 1: agent-a, agent-b を並列実行
# 1. Phase 1 の worktree セットアップ
.claude/skills/zellij-swarm/scripts/setup-worktrees.sh agent-a agent-b
# 2. タスクファイルを Write tool で書き込む (agent-a, agent-b それぞれ)
# 3. Phase 1 のペイン起動
.claude/skills/zellij-swarm/scripts/launch-panes.sh agent-a agent-b
# 4. Phase 1 完了まで待機 → 自動で merge + cleanup
.claude/skills/zellij-swarm/scripts/run-phase.sh agent-a agent-b
Phase 2: agent-c を実行 (agent-a, agent-b のマージ済み状態をベースに)
# 5. Phase 2 の worktree セットアップ (現在の HEAD = Phase 1 マージ済みが起点)
.claude/skills/zellij-swarm/scripts/setup-worktrees.sh agent-c
# 6. タスクファイルを Write tool で書き込む (agent-c)
# 7. Phase 2 のペイン起動
.claude/skills/zellij-swarm/scripts/launch-panes.sh agent-c
# 8. Phase 2 完了まで待機 → 自動で merge + cleanup
.claude/skills/zellij-swarm/scripts/run-phase.sh agent-c
main ──┬── swarm/agent-a ──┐
└── swarm/agent-b ──┴─ merge → main' ──── swarm/agent-c ─── merge → main''
setup-worktrees.sh は実行時の HEAD をベースに worktree を作成するため、
Phase 1 のマージ後に Phase 2 をセットアップすれば自動的に Phase 1 の結果が引き継がれる。
フェーズが複数ある場合はエージェント名にフェーズを含めると管理しやすい:
phase1-frontend, phase1-backend → phase2-integration
$ZELLIJ 環境変数が存在しない場合は動作しない--dangerously-skip-permissions 使用: 子エージェントは確認なしで操作を実行するrun-phase.sh が cleanup まで行うため、次フェーズ開始前に worktree が残らないReproduce and debug failures through an evidence-first root-cause workflow. Use when tests fail, a bug is reported, behavior is flaky, an error message needs investigation, or the user asks to debug, diagnose, investigate, or fix a failure.
Apply a focused red-green-refactor workflow for behavior changes and bug fixes. Use when the user asks for TDD, regression tests, test-first implementation, bug fixes with tests, or when a change has clear observable behavior that should be protected by tests.
Verify completed work before reporting it as done. Use after making code, config, documentation, workflow, or UI changes; when the user asks whether something is fixed; when a dev server is started; or before claiming implementation, debugging, migration, or setup work is complete.
Research current or uncertain information on the web using source-aware evidence. Use when the user asks to research, look up, browse, verify latest information, compare public options, find recommendations, cite sources, or when facts may have changed recently.
GitHub へローカル変更を公開する workflow。ユーザーが commit、branch push、PR 作成、publish を依頼した場合に、通常の git と gh pr create で安全に実行します。
株価・為替・暗号資産・財務データを MCP サーバ (alphavantage / twelvedata / edinetdb) 経由で取得・分析します。「株価を調べて」「銘柄の推移を」「為替レート」「企業の財務を」「決算」「ASCII グラフにして」「米国株 / 日本株を調査」などのリクエストがあった場合に使用します。