mcpField
D
dispatching-parallel-agents

dispatching-parallel-agents

github.com/lucianghindaエージェントワークフロー42539 回インストール1 日前に更新
リポジトリ

dispatching-parallel-agents について

dispatching-parallel-agents は、独立した問題の調査を並行して進めるためのエージェント調整スキルです。範囲と制約を明確にしたタスクへ分割し、結果の確認と統合まで支援します。

主な機能

  1. 01独立した問題領域の特定
  2. 02焦点を絞ったタスク作成
  3. 03背景と制約の提示
  4. 04エージェントの並行実行
  5. 05結果の確認と統合

活用シーン

  1. 01無関係なテスト失敗の調査
  2. 02別々のサブシステム問題の並行対応
  3. 03全テスト前の独立した修正の調整

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/lucianghinda/superpowers-ruby --skill dispatching-parallel-agents

インストール後、Claude Code で/dispatching-parallel-agentsを入力して読み込まれたか確認します。

詳細

並列エージェントへのタスク割り当て

概要

コンテキストを分離した専門エージェントにタスクを委任します。指示とコンテキストを正確に作成することで、エージェントが集中してタスクを成功させられるようにします。エージェントにセッションのコンテキストや履歴を引き継がせてはいけません。必要な情報だけを用意します。これにより、調整作業のために自分のコンテキストも維持できます。

複数の無関係な失敗（異なるテストファイル、異なるサブシステム、異なるバグ）がある場合、順番に調査すると時間が無駄になります。それぞれの調査は独立しており、並行して進められます。

基本原則： 独立した問題領域ごとにエージェントを 1 つ割り当てます。並行して作業させましょう。

使用する場面

digraph when_to_use {
    "Multiple failures?" [shape=diamond];
    "Are they independent?" [shape=diamond];
    "Single agent investigates all" [shape=box];
    "One agent per problem domain" [shape=box];
    "Can they work in parallel?" [shape=diamond];
    "Sequential agents" [shape=box];
    "Parallel dispatch" [shape=box];

    "Multiple failures?" -> "Are they independent?" [label="yes"];
    "Are they independent?" -> "Single agent investigates all" [label="no - related"];
    "Are they independent?" -> "Can they work in parallel?" [label="yes"];
    "Can they work in parallel?" -> "Parallel dispatch" [label="yes"];
    "Can they work in parallel?" -> "Sequential agents" [label="no - shared state"];
}

次の場合に使用します：

  • 異なる根本原因によって 3 つ以上のテストファイルが失敗している
  • 複数のサブシステムがそれぞれ独立して壊れている
  • それぞれの問題を、ほかの問題のコンテキストなしで理解できる
  • 調査間に共有状態がない

次の場合は使用しないでください：

  • 失敗が関連している（一方を修正すればほかも直る可能性がある）
  • システム全体の状態を理解する必要がある
  • エージェント同士が干渉する可能性がある

パターン

1. 独立した領域を特定する

問題の内容ごとに失敗を分類します：

  • ファイル A のテスト：ツール承認フロー
  • ファイル B のテスト：バッチ完了時の動作
  • ファイル C のテスト：中断機能

各領域は独立しています。ツール承認の修正は、中断テストに影響しません。

2. エージェントに範囲を絞ったタスクを作成する

各エージェントに次の内容を渡します：

  • 具体的な範囲： 1 つのテストファイルまたはサブシステム
  • 明確な目標： 対象のテストを通過させる
  • 制約： ほかのコードを変更しない
  • 期待する出力： 調査結果と修正内容の要約
3. 並行して割り当てる
// In Claude Code / AI environment
Task("Fix agent-tool-abort.test.ts failures")
Task("Fix batch-completion-behavior.test.ts failures")
Task("Fix tool-approval-race-conditions.test.ts failures")
// All three run concurrently
4. 確認して統合する

エージェントから結果が返ってきたら：

  • 各要約を読む
  • 修正が互いに競合しないことを確認する
  • テストスイート全体を実行する
  • すべての変更を統合する

エージェントへのプロンプトの構成

適切なエージェントプロンプトは、次の条件を満たします：

  1. 焦点が明確 — 問題領域が 1 つに絞られている
  2. 自己完結している — 問題を理解するために必要なコンテキストがすべて含まれている
  3. 出力が具体的 — エージェントに何を返してほしいかが明確である
Fix the 3 failing tests in src/agents/agent-tool-abort.test.ts:

1. "should abort tool with partial output capture" - expects 'interrupted at' in message
2. "should handle mixed completed and aborted tools" - fast tool aborted instead of completed
3. "should properly track pendingToolCount" - expects 3 results but gets 0

These are timing/race condition issues. Your task:

1. Read the test file and understand what each test verifies
2. Identify root cause - timing issues or actual bugs?
3. Fix by:
   - Replacing arbitrary timeouts with event-based waiting
   - Fixing bugs in abort implementation if found
   - Adjusting test expectations if testing changed behavior

Do NOT just increase timeouts - find the real issue.

Return: Summary of what you found and what you fixed.

よくある間違い

❌ 範囲が広すぎる： 「すべてのテストを修正して」— エージェントが混乱します
✅ 具体的： 「agent-tool-abort.test.ts を修正して」— 範囲が明確です

❌ コンテキストがない： 「競合状態を修正して」— エージェントには問題の場所がわかりません
✅ コンテキストを含める： エラーメッセージとテスト名を貼り付けます

❌ 制約がない： エージェントがすべてをリファクタリングする可能性があります
✅ 制約を設ける： 「本番コードは変更しないでください」または「テストのみを修正してください」

❌ 出力が曖昧： 「修正して」— 何が変更されたかわかりません
✅ 具体的： 「根本原因と変更内容の要約を返してください」

使用しない場面

関連する失敗： 1 つの修正でほかも直る可能性があるため、まずまとめて調査します
全体のコンテキストが必要： 理解するにはシステム全体を見る必要があります
探索的なデバッグ： 何が壊れているのかまだわかりません
共有状態： 同じファイルの編集や同じリソースの使用により、エージェント同士が干渉します

セッションでの実例

シナリオ： 大規模なリファクタリング後、3 つのファイルで 6 件のテストが失敗

失敗：

  • agent-tool-abort.test.ts：3 件の失敗（タイミングの問題）
  • batch-completion-behavior.test.ts：2 件の失敗（ツールが実行されない）
  • tool-approval-race-conditions.test.ts：1 件の失敗（実行回数 = 0）

判断： 問題領域は独立しており、中断ロジック、バッチ完了、競合状態はそれぞれ別の問題です

割り当て：

Agent 1 → Fix agent-tool-abort.test.ts
Agent 2 → Fix batch-completion-behavior.test.ts
Agent 3 → Fix tool-approval-race-conditions.test.ts

結果：

  • エージェント 1：タイムアウトをイベントベースの待機に置き換え
  • エージェント 2：イベント構造のバグを修正（threadId の位置が誤っていた）
  • エージェント 3：非同期ツールの実行完了を待つ処理を追加

統合： すべての修正は独立しており、競合もなく、テストスイート全体が成功しました

短縮できた時間： 3 つの問題を順番に解決する代わりに、並行して解決

主なメリット

  1. 並列化 — 複数の調査を同時に進められます
  2. 集中 — 各エージェントの範囲が狭く、追跡するコンテキストが少なくなります
  3. 独立性 — エージェント同士が干渉しません
  4. 速度 — 1 つの問題にかかる時間で 3 つの問題を解決できます

検証

エージェントからの報告を受け取った後：

  1. 各サマリーを確認する - 変更内容を把握します
  2. 競合を確認する - エージェントが同じコードを編集していないか確認します
  3. 全テストを実行する - すべての修正が連携して機能することを確認します
  4. 抜き取り確認を行う - エージェントが系統的な誤りを犯す場合があります

実際の効果

デバッグセッション（2025-10-03）の実績：

  • 3つのファイルで6件の失敗
  • 3つのエージェントを並行して派遣
  • すべての調査が同時に完了
  • すべての修正を正常に統合
  • エージェントによる変更間の競合はゼロ

コメント

Markdown 対応