swarm-orchestration

Swarm オーケストレーションスキル

目的

複雑なタスクに対応するマルチエージェントのスウォーム調整です。階層型トポロジーと専門エージェントを使用して、複数のファイルやモジュールにまたがる複雑な作業を分解して実行します。

トリガーするタイミング

• 3 個以上のファイルに変更が必要な場合
• 新機能を実装する場合
• モジュールをまたいでリファクタリングする場合
• テストを伴う API の変更
• セキュリティ関連の変更
• コードベース全体にわたるパフォーマンス最適化
• データベーススキーマの変更

使用しないタイミング

• 1 つのファイルだけを編集する場合
• 簡単なバグ修正（1〜2 行）
• ドキュメントの更新
• 設定の変更
• 簡単な調査

コマンド

スウォームを初期化する

ドリフトを防ぐため、階層型トポロジーで新しいスウォームを開始します

npx @claude-flow/cli swarm init --topology hierarchical --max-agents 8 --strategy specialized

例：

npx @claude-flow/cli swarm init --topology hierarchical --max-agents 6 --strategy specialized

タスクを振り分ける

タスクの種類に基づいて、適切なエージェントにタスクを振り分けます

npx @claude-flow/cli hooks route --task "[task description]"

例：

npx @claude-flow/cli hooks route --task "implement OAuth2 authentication flow"

エージェントを起動する

特定の種類のエージェントを起動します

npx @claude-flow/cli agent spawn --type [type] --name [name]

例：

npx @claude-flow/cli agent spawn --type coder --name impl-auth

ステータスを監視する

現在のスウォームのステータスを確認します

npx @claude-flow/cli swarm status --verbose

タスクをオーケストレーションする

複数のエージェントにまたがってタスクをオーケストレーションします

npx @claude-flow/cli task orchestrate --task "[task]" --strategy adaptive

例：

npx @claude-flow/cli task orchestrate --task "refactor auth module" --strategy parallel --max-agents 4

エージェントを一覧表示する

アクティブなエージェントをすべて一覧表示します

npx @claude-flow/cli agent list --filter active

スクリプト

スクリプト	パス	説明
swarm-start	.agents/scripts/swarm-start.sh	デフォルト設定でスウォームを初期化します
swarm-monitor	.agents/scripts/swarm-monitor.sh	リアルタイムのスウォーム監視ダッシュボード

参考資料

ドキュメント	パス	説明
Agent Types	docs/agents.md	エージェントの種類と機能の完全な一覧
Topology Guide	docs/topology.md	スウォームトポロジーの設定ガイド

ベストプラクティス

1. 開始する前に、既存のパターンがないかメモリを確認します
2. 調整には階層型トポロジーを使用します
3. 完了後に、うまくいったパターンを保存します
4. 新しく得られた知見があれば記録します