タスクオーケストレーション

サブエージェントを効率的に並列運用し、複雑なタスクを分割・実行する。

トリガー条件

•複数観点からの調査が必要なとき
•独立した複数のサブタスクを実行するとき
•長時間タスクをバックグラウンドで実行するとき

1. 利用可能なサブエージェント

サブエージェント	役割	主な用途
`task-researcher`	事前調査・コンテキスト収集	実装前の現状把握、依存関係の調査
`plan-digger`	プランレビュー・SOW作成	イシュー分析、反復レビュー、SOW出力
`task-executor`	タスク分割・実装実行	複雑なタスクの分割と段階的実装
`quality-gainner`	品質チェック・自動修正	TypeScript/リントエラーの検出・修正
`Explore`	コードベース探索・検索	ファイル検索、コード構造の理解
`Plan`	実装計画の設計	アーキテクチャ設計、実装戦略の立案

2. 並列実行の原則

フェーズ1: 調査（Investigation）

複数の task-researcher を並列起動し、異なる観点から情報を収集する。

code

# 並列調査の例
Task ツールを複数回並列で呼び出し:

1. subagent_type: task-researcher
   prompt: "認証システムの現状実装を調査してください"

2. subagent_type: task-researcher
   prompt: "関連するAPIエンドポイントの構造を調査してください"

3. subagent_type: Explore
   prompt: "設定ファイルとスキーマ定義を探索してください"

フェーズ2: 計画（Planning）

plan-digger でプランを練り、SOWを作成する。

code

# プランニングの例
Task ツールを呼び出し:

subagent_type: plan-digger
prompt: "このイシューに対する実装プランをレビューし、SOWを作成してください"

フェーズ3: 実装（Execution）

独立したサブタスクを task-executor で同時実行する。

code

# 並列実装の例
Task ツールを複数回並列で呼び出し:

1. subagent_type: task-executor
   prompt: "ユーザー認証モジュールを実装してください"

2. subagent_type: task-executor
   prompt: "データベーススキーマを作成してください"

フェーズ4: 検証（Verification）

quality-gainner で品質をチェックし、問題を自動修正する。

code

# 品質検証の例
Task ツールを呼び出し:

subagent_type: quality-gainner
prompt: "実装したコードの品質をチェックし、問題があれば修正してください"

3. バックグラウンド実行

長時間かかるタスクは run_in_background: true を指定する。

バックグラウンド起動

code

Task ツールを呼び出し:

subagent_type: task-executor
prompt: "全テストスイートを実行してください"
run_in_background: true

結果の取得

code

TaskOutput ツールを呼び出し:

task_id: [起動時に返されたID]
block: false  # 完了を待たない場合

開発サーバーの起動

ユーザーに動作確認させる場合：

code

Bash ツールを呼び出し:

command: "npm run dev"
run_in_background: true

4. 注意事項

競合の回避

•同一ファイルの同時編集禁止: 複数エージェントが同じファイルを編集しない
•依存関係の考慮: 依存するタスクは順次実行する
•フェーズの分離: 調査→計画→実装→検証の順序を守る

エージェント間の連携

•各エージェントの完了を確認してから次フェーズへ進む
•調査結果は実装エージェントに適切に引き継ぐ
•検証で発見された問題は quality-gainner が自動修正

リソース管理

•同時起動するエージェント数は必要最小限に
•バックグラウンドタスクは完了後に適切に処理
•不要なエージェントは起動しない

5. 実行パターン例

パターンA: イシュー対応（フルフロー）

code

1. [並列調査]
   - task-researcher: 既存実装の調査
   - task-researcher: 関連するテストの調査
   - Explore: ディレクトリ構造の確認

2. [計画・レビュー]
   - plan-digger: SOW作成と反復レビュー

3. [並列実装]
   - task-executor: コア機能の実装
   - task-executor: テストの実装

4. [検証・修正]
   - quality-gainner: 品質チェックと自動修正

パターンB: バグ修正

code

1. [調査]
   - task-researcher: バグの原因調査
   - Explore: 関連コードの探索

2. [実装]
   - task-executor: 修正の実装

3. [検証]
   - quality-gainner: 修正の検証と品質チェック

パターンC: リファクタリング

code

1. [並列調査]
   - task-researcher: 対象コードの依存関係調査
   - task-researcher: 影響範囲の調査

2. [計画]
   - plan-digger: リファクタリング計画のSOW作成

3. [段階的実装]
   - task-executor: 段階1の実装
   - [検証後]
   - task-executor: 段階2の実装

4. [最終検証]
   - quality-gainner: 全体の品質チェックと修正

パターンD: クイック修正

code

1. [実装]
   - task-executor: 修正の実装

2. [検証]
   - quality-gainner: 品質チェック

チェックリスト

並列実行前

• タスク間の依存関係を確認した
• 同一ファイルへの同時アクセスがないか確認した
• 適切なサブエージェントを選択した

各フェーズ完了時

• 全エージェントの完了を確認した
• 結果を次フェーズに適切に引き継いだ
• エラーや問題がないか確認した

タスク完了時

• 全フェーズが正常に完了した
• バックグラウンドタスクを適切に処理した
• 最終的な品質検証を実施した