swarm-expert

Swarm Expert

マルチエージェントの連携に使用する agent-swarm MCP サーバーのエキスパートです。エージェントのスウォームの管理、タスクの委任、エージェント間の通信、作業の調整をユーザーに案内します。

Note: このスキルには、agent-swarm MCP サーバーの設定が必要です。MCP はスウォームの調整に使用するツールを提供します。

クイックリファレンス

目的	MCP ツール	例
スウォームに参加する	join-swarm	リーダーまたはワーカーとして参加する
スウォームのステータスを確認する	get-swarm	すべてのエージェントとステータスを確認する
タスクを一覧表示する	get-tasks	フィルターを使ってタスクを表示する
タスクを委任する	send-task	エージェントまたはプールにタスクを割り当てる
タスクを取得する	task-action	プールからタスクを取得する
進捗を更新する	store-progress	完了または失敗としてマークする
メッセージを送信する	post-message	@メンション付きでチャットする
メッセージを読む	read-messages	未読メッセージやメンションを確認する

一般的なワークフロー

リーダーとして開始する

1. Use `join-swarm` with name and isLead=true
2. Use `get-swarm` to see available workers
3. Use `send-task` to delegate work to specific agents or pool
4. Monitor with `get-tasks` and `get-task-details`

ワーカーとして開始する

1. Use `join-swarm` with name (isLead=false)
2. Use `poll-task` to check for assignments
3. Use `task-action` to claim unassigned tasks
4. Use `store-progress` to report completion

タスクを委任する

1. Use `send-task` with:
   - title: Clear task description
   - description: Detailed requirements
   - toAgentId: Specific agent OR leave empty for pool
   - tags: For categorization
   - dependsOnTaskIds: If blocked by other tasks

ステータスを確認する

1. Use `get-swarm` - Shows all agents (name, status, current task)
2. Use `get-tasks` - Filter by status, tags, or search text
3. Use `get-task-details` - Full task info, output, and logs

エージェント間のコミュニケーション

1. Use `list-channels` - See available chat channels
2. Use `post-message` with:
   - channelId: Target channel
   - content: Message text (supports @mentions)
   - replyToMessageId: For threading
3. Use `read-messages` with:
   - unreadOnly: true for new messages
   - mentionsOnly: true for @mentions to you

タスクの状態

状態	説明
pending	作成済みですが、まだ開始されていません
in_progress	作業中です
completed	正常に完了しました
failed	理由とともに失敗しました
blocked	依存関係の解決待ちです

トラブルシューティング

「エージェントが見つかりません」

最初にスウォームに参加する必要があります。名前を指定して join-swarm を使用してください。

「タスクがあなたに割り当てられていません」

作業を始める前に、task-action を使用してタスクを取得してください。

「利用可能なタスクがありません」

異なるフィルターを指定して get-tasks を確認してください。タスクが割り当て済みか、ブロックされている可能性があります。

他のエージェントが表示されない

get-swarm を使用してエージェントの一覧を更新してください。エージェントが切断されている可能性があります。

詳細リファレンス

MCP ツールの完全なドキュメントについては、MCP-REFERENCE.md を参照してください。