swarm について
swarmは、複数のワーカーにタスクを並行して割り当て、結果を集約して一つのレポートにまとめるエージェントスキルです。計画から結果の検証まで、段階的な進め方を定めています。
主な機能
- 01目標、成果物、分担の計画
- 02複数ワーカーの並行起動
- 03結果の集約と検証
- 04問題と未対応範囲の報告
活用シーン
- 01大きなタスクの独立した分割
- 02探索やレビューの並行実施
- 03並行作業の調査結果の集約
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/swarmを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlCREDITS.md
詳細
Swarm
N 人の並列ワーカーに作業を振り分けます。ワーカーは別々の範囲を担当したり、同じブリーフで競ったり、両方を組み合わせたりできます。完了を待ち、結果を集約して、1 つのレポートを返します。
開始
何かを開始する前に、タスクリスト（ハーネスのタスクツール、またはタスクリストがない場合は ~/.local/state/ox/checklists/<repo>-<branch>.md のチェックリストファイル）を開き、各フェーズにつき 1 項目を記載します。
- 方針を定める
- 作業を振り分ける
- 集約する
- 報告する
フェーズ A：方針を定める
- 完了の判定条件と、Swarm が返す成果物またはレポートを明確にします。
- 作業の形を選びます。範囲ごとに分割する、N 人のワーカーに同一のブリーフを与えて競わせる、または両方を組み合わせます。競争形式または混合形式の場合は、開始前に
first pass、rank all、best-ofのいずれかを宣言します。 - N はユーザーの指定に従うか、作業の形に応じて決定します。N はワーカーの総数であり、並列実行数の上限ではありません。
- ワーカーの役割は担当作業に基づいて選びます。コードを書くワーカーには
implement、読み取り専用で検索や網羅性の確認を行うワーカーにはexplore、検証やレビューを行うワーカーにはreviewを指定します。~/.config/ox/models.mdの該当する役割の行からモデルと effort を取得し、サブエージェントツールに渡します。その行がinheritの場合、存在しない場合、またはファイルの# harness行に別のハーネスが記載されている場合は、どちらも省略して、ワーカーに自分のモデルを使わせます。ファイルが存在しない場合は、ユーザーに/setup-ox modelsの実行も提案します。ツールが指定項目を受け付けない場合は、一覧にある最も近いモデルを使い、その旨を伝えます。モデル競争では、各陣営のモデルをpanel行から取得し、開始前に明示します。 - 書き込みを行うワーカーには、それぞれ専用の書き込み可能な出力先を用意します。ワーカーがコミットを検証する場合、各ブリーフに正確な SHA と検証方法を記載し、ワーカーはその両方を結果に記録します。
フェーズ B：作業を振り分ける
N 人のワーカーを、各自の範囲または競争陣営の名前を付けて、すべて同時に開始します。ワーカーは同じチェックアウトを共有するため、そこで並列に書き込む場合は互いに異なるファイルを担当させ、git コマンドは実行させません。専用のツリーまたはブランチが必要なワーカーには、git worktree を用意します。未コミットの変更は新しい worktree に引き継がれないため、まずコミットし、その後 git worktree add <path> -b <new branch> <commit or branch> を実行します。ワーカーには、その絶対パスだけを唯一の書き込み可能な場所として指定します。各 worktree またはブランチで書き込みを行うのは 1 人だけです。T3 Code では、worktree の workspaceStrategy を指定した t3_thread_launch スレッドも同様に動作し、そのスレッドをその worktree に割り当てます。
各ブリーフは単独で理解できる内容にします。目標、範囲、正確な担当範囲または競争陣営、検証方法、報告内容を含めます。結果は、根拠を添えて PASS、ISSUES、BLOCKED のいずれかで報告します。欠陥を立証できるワーカーは ISSUES と報告し、立証できた問題を最初の 1 件だけでなく、すべて列挙します。
すべてのワーカーが完了するまで待ちます。ワーカーが離脱した場合は N-1 人で続行し、その旨を記録します。
フェーズ C：集約する
最終結果を読みます。ブリーフに指定した SHA と検証方法が記録されていない結果は除外し、そのワーカーを 1 回だけ再起動します。2 回目も不足する場合は、未解決事項として記録します。未解決事項は合格として扱いません。網羅性を確認するには、必須の各範囲について結果が必要です。競争形式の場合は、事前に宣言した選定ルールを適用します。ワーカーの出力をそのまま貼り付けないでください。
簡潔な結果表、根拠を示した 1 行の問題報告、未解決事項または離脱を記録します。結果を統合または破棄した後、各ワーカーの worktree を git worktree remove <path> で削除します。
フェーズ D：報告する
結果表、問題の簡潔な報告、未解決事項または離脱、そして競争形式を使用した場合はその選定ルールを含む、統合レポートを 1 つ返します。