mcpField
C
coordinator

coordinator

github.com/hjewkesエージェントワークフロー436 回インストール35 週間前に更新
リポジトリ

coordinator について

Coordinatorは、音声/テキストの応答モードとエージェントチームを管理するスキルです。モードごとの応答規則に加え、計画に沿って並行タスクを割り当て、結果を検証する手順を定めています。

主な機能

  1. 01音声モードとテキストモードの切り替え
  2. 02モード別の応答規則を適用
  3. 03並行エージェントチームの調整
  4. 04計画マニフェストのウェーブに沿って実行
  5. 05割り当て後に結果を検証

活用シーン

  1. 01トリガーワードで応答スタイルを変更
  2. 02独立した作業を複数のエージェントに分担
  3. 03構造化された計画に沿ってタスクを実行

インストール

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

$npx skills add https://github.com/hjewkes/agent-skills --skill coordinator

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

同梱ファイルreferences/team-orchestration.md

詳細

コーディネーター

概要

2 つの役割を管理します。出力モードの切り替え(音声とテキスト)と、並列タスク実行のためのエージェントチームのオーケストレーションです。

音声/テキストモードの切り替え

トリガーワード:"vm"、"voice mode" → VOICE に切り替えます。"tm"、"text mode" → TEXT に切り替えます。

VOICE モードのルール
  • 短い文を使用し、各文は最大 2 行にします
  • すべてのリストに箇条書きを使用します
  • 3 行を超えるコードブロックは使わず、代わりに口頭で要約します
  • ツールを実行する前に確認します:"[アクション]を実行します。よろしいですか?"
  • 平易な言葉を使い、専門用語は避けます
  • コード変更を示す際は、差分を表示するのではなく、変更内容を説明します
TEXT モードのルール(デフォルト)
  • 詳細な回答をコードブロック付きで提示します
  • 差分、完全な実装、詳細な説明を示します
  • 破壊的な操作を除き、事前確認なしでツールを実行します

エージェントチームのオーケストレーション

チームを使用する場合
  • タスクに 3 つ以上の独立したサブタスクがある場合
  • サブタスクごとに異なる専門知識が必要な場合(例:実装+テスト+レビュー)
  • マージの競合を起こさずに作業を並列化できる場合
オーケストレーションの詳細

完全な調整パターン(DECOMPOSE -> WAVE PLAN -> DISPATCH -> GATE -> VERIFY)、エージェントの起動ルール、モデル選択表、コンテキスト予算の管理、競合の解決方法については、references/team-orchestration.md を参照してください。

計画主導のオーケストレーション

構造化された計画(.claude/plans/<plan-id>/)に基づいて実行をオーケストレーションする場合:

セッション開始時

plan.md と manifest.json を読みます。マニフェストにはウェーブとタスクの依存関係が定義されています。マニフェストのウェーブ分けをそのまま使用し、ウェーブ構成を再導出しないでください。

各ウェーブの境界で

ディスクから manifest.json を読み直します。これにより、コンテキスト圧縮で情報が失われるのを防ぎます。各ウェーブの完了後に、マニフェスト内のタスクのステータスを更新します。

エージェントへの指示

各エージェントにはブリーフィングファイルを指定します。ブリーフィングの内容をインラインで貼り付けないでください。指示プロンプトには、plan-id、task-id、ブリーフィングのパス、作業ディレクトリを含めます。

最終ウェーブの後
  1. 必要に応じて、実行メモを .claude/plans/<plan-id>/summary.md に記録します
  2. 計画ディレクトリを削除します:rm -rf .claude/plans/<plan-id>/
  3. 削除に失敗した場合は警告しますが、処理を中断しないでください

よくある間違い

  • プロンプトに十分なコンテキストを含めずにエージェントを起動する
  • 複数のエージェントに同じファイルを変更させる
  • エージェントの出力を統合した後の検証を省略する
  • 本来は順次進めるべきタスクにチームを使う
  • 依存関係のあるタスクを同じウェーブに入れる(タスク B がタスク A の出力を必要とする場合は、別のウェーブにする)
  • エージェントにブリーフィングファイルを指定せず、ブリーフィング全文をインラインで貼り付ける
  • ウェーブの境界でマニフェストを読み直さない(コンテキスト圧縮によって状態が失われる可能性があります)

コメント