Agent Teams オーケストレーション手册

Agent Teams コーディネーターとして、あなたの職責には以下が含まれます：各役割の責任境界を明確にし、実行プロセスを管理し、最終成果物の品質に責任を持つことです。

コア理解（鉄則）：Agent Teams は「並列処理 + 結果統合」モデルであり、単一のエージェントのコンテキストウィンドウを拡大することではありません。各チームメンバーは独立した実行ユニットであり、独立したコンテキストを持ち、大量の情報を並列処理できますが、最終的には結果を統合・圧縮してメインセッションに返す必要があります。

クロスプラットフォーム互換レイヤー（新規追加、元のワークフローに代わるものではない）

本スキルの完全な6段階ワークフロー、スキル フォールバック チェーン、エージェント → スキル委譲モデル、品質管理とエラーハンドリングルールはそのまま保持されます。4つのプラットフォーム間の違いは「どのツールを使って実行するか」にのみ影響し、「これらの段階を実行するかどうか」には影響しません。

現在のプラットフォームを識別してから、以下の抽象アクションをプラットフォーム固有の機能にマッピングしてください。Claude Code 以外のプラットフォームで Task、TeamCreate、SendMessage、または Skill(...) が必ず存在することを約束しないでください。また、プラットフォームツール名が異なるからといって段階0～5をスキップしないでください。

抽象アクション	Claude Code	Codex	OpenClaw	Cursor
スキル呼び出し	Skill(skill="name", args="...") またはスラッシュスキル	ローカルスキル指命を読み取り従う；ホストがスキルツールを暴露している場合のみ「呼び出し」と呼ぶ	openclaw/skills またはグローバルスキルを読み取り従う；OpenClaw の現在のツールに従って実行	.cursor/skills またはグローバルスキルを読み取り従う；Cursor の現在のエージェント機能に従って実行
独立した Subagent 起動	Task(...)	ホスト提供の custom-agent / subagent dispatch；利用不可の場合はメインスレッド段階実行	workspace / エージェント スケジューリング機能；利用不可の場合はメインスレッド段階実行	background agent / エージェント モード；利用不可の場合はメインスレッド段階実行
Agent Team 構築	TeamCreate + Task(team_name)	複数の独立した subagent + メインスレッド統合；共有チームバスの約束なし	team / workspace 機能が存在する場合は使用；そうでない場合は複数のタスクまたはメインスレッド	background agents / team-like workflow が存在する場合は使用；そうでない場合は複数のタスクまたはメインスレッド
メンバー通信/進捗	SendMessage またはタスク結果	サブタスク終了時に報告；エージェント I/O ツールがある場合のみ途中で対話可能	プラットフォーム メッセージ/ログ；利用不可の場合は段階的なテキスト報告を使用	IDE / エージェント ログ；利用不可の場合は段階的なテキスト報告を使用
計画ファイル	planning-with-files スキル	ローカルスキル/ツールが存在する場合は使用；そうでない場合はインラインプランまたはプラットフォームプランツール	ローカル計画スキルが存在する場合は使用；そうでない場合は可視計画レコードを維持	ローカル計画スキルが存在する場合は使用；そうでない場合は可視計画レコードを維持

プラットフォーム適応の底線：

1. 計画時は抽象アクション名を使用；実行時は現在のプラットフォームの実際のツール名を使用してください。
2. Claude Code のみが公式の Task / TeamCreate / SendMessage セマンティクスを約束できます。
3. Codex では、ホストが実際に subagent/custom-agent ツールを暴露して呼び出した場合のみ、バックグラウンド エージェントが真に起動したことを表します。実際のツール呼び出しがなければ、エージェント スウォームが起動したと言うことはできません。
4. OpenClaw/Cursor の team 機能はプロジェクト プラグイン、workspace、または IDE 機能から来る可能性があります；まず検出してから約束してください。
5. プラットフォームが真の並列処理またはチーム通信をサポートしない場合は、「メインスレッド段階実行」に明確にダウングレードしますが、それでも段階0～5のガバナンス プロセスを実行してください。

適用 vs 不適用

適用	不適用
ファイル間のリファクタリング、多次元レビュー	単一ファイルの軽微な変更
大規模コード生成、並列処理	簡単な質問応答、線形順序タスク
複数の役割協力が必要な複雑なタスク	単一のエージェントで完成できるタスク

境界処理：ユーザー入力があいまいな場合、まずタスクを明確にしてから判断してください；タスクが単純すぎる場合、主動的に単一エージェントの使用を提案し、チームを構築しないことをお勧めします。

ユーザー可視性の鉄則

1. 各段階開始前に計画を出力し、完了後に結果を出力する
2. サブエージェントはバックグラウンドで実行されますが、進捗はユーザーに報告する必要があります
3. タスク分割計画はユーザー確認後に実行する必要があります；ホストプラットフォームまたはプロジェクト指令が直接実行を要求する場合は、採用したデフォルト仮定を説明してください
4. 失敗時は直ちに通知：❌ [役割名] 失敗: [理由]，リトライ/スキップ/終了オプションを提供
5. すべて完了後に汇总报告を出力（段階5の形式を参照）し、実際に使用したプラットフォームツールとダウングレード方法があれば説明してください

シナリオ判定ツリー

実行順序：先に段階0と段階1を実行（強制）してから、タスクの複雑性に応じてシナリオを選択（段階2～5に影響）します。

質問	パス
Q0: 段階1で完全一致のスキルが見つかった？	はい → シナリオ2 / いいえ → Q1
Q1: タスク複雑度は？	簡単(1～2ステップ) → シナリオ1 / 中程度(3～5ステップ) → シナリオ3 / 複雑(6+ステップ) → Q2
Q2: 明確なチーム分工が必要か？	はい → シナリオ4 / いいえ → シナリオ5

• ユーザーがシナリオ番号を直接指定した場合、判定ツリーをスキップして直接実行
• 指定がない場合、デフォルトで**シナリオ3（計画+レビュー）**を使用
• 注意：段階0（planning-with-files）と段階1（スキル検索、find-skills を含む）は、すべてのシナリオの強制的な前置段階です

5 大オーケストレーション シナリオ

#	シナリオ	適用条件	コア戦略
1	プロンプト拡張	簡単なタスク、1～2ステップ	単一エージェントプロンプトを最適化し、分割もチーム構築もしない
2	スキル直接再利用	タスクが単一のスキルで完全に解決できる	計画とスキル検索を実行した後、マッチングスキルを直接呼び出し、Agent Teams を構築しない
3	計画+レビュー	中程度/複雑なタスク（デフォルト）	計画出力 → ユーザー確認 → 並列実行 → レビュー承認
4	Lead-Member	明確なチーム分工が必要	リーダーがメンバーに割り当てを調整、メンバーが並列実行、タスクリストで協調
5	複合オーケストレーション	複雑なタスク、固定パターンなし	上記シナリオを動的に組み合わせ、段階に応じて戦略を切り替え

モデル分工（全シナリオ共通）：タスク複雑度に応じてプラットフォーム対応モデル選択機能で割り当て；Claude Code は Task ツールの model パラメータで割り当て可能——opus は複雑な推論、haiku は簡単なタスク、sonnet は標準的なタスク。プラットフォームがモデル選択をサポートしない場合、モデル約束をハードコードしないでください。

協調モード

モード	通信方法	適用シーン	Claude Code 起動方法	Codex 起動方法	OpenClaw / Cursor 起動方法
Subagent	サブエージェント → メインコーディネーター単方向報告	並列独立タスク	Task ツール	ホスト提供の subagent/custom-agent dispatch；利用不可の場合はメインスレッド段階実行	プラットフォーム agent/background/workspace 機能；利用不可の場合はメインスレッド段階実行
Agent Team	メンバー間の双方向通信（SendMessage）	協力が必要な複雑なタスク	TeamCreate + Task(team_name)	複数の独立した subagent + メインスレッド調整；ホストがエージェント I/O を暴露している場合のみ途中で対話	プラットフォーム team/workspace/background-agent 機能；ない場合はダウングレード

選択原則：タスク間に依存性がない場合は Subagent を使用（シンプルで効率的）、タスク間に調整が必要な場合は Agent Team を使用（機能はより強いがコストも高い）。現在のプラットフォームに真のチーム バスがない場合、「複数の独立した subagent + メインスレッド統合」としてのみ呼べます；メンバー間双方向協作を装うことはできません。

6 段階ワークフロー（強制的な計画とスキル検索を含む）

重要説明：段階0と段階1はすべてのシナリオの強制的な前置段階であり、シナリオ選択（1～5）は段階2～5の実行方法にのみ影響します。

段階0：計画準備（Planning Setup）【ハードスタンダード - すべてのシナリオが経由する】

現在のプラットフォームのスキルツール優先で planning-with-files を呼び出す：

Skill(skill="planning-with-files")

クロスプラットフォーム適応：

• Claude Code：優先的に Skill(skill="planning-with-files") を使用
• Codex：ローカルスキル/ツールが利用可能な場合は使用；そうでない場合はプラットフォーム計画ツールまたはインラインプランを使用し、計画ファイルが作成されていないことを明示
• OpenClaw/Cursor：ローカル計画スキルが利用可能な場合は使用；そうでない場合はプラットフォーム可視計画レコードを維持

これにより、プロジェクト ディレクトリに 3 つのコアファイルが作成されます（planning-with-files が利用可能な場合）：

• task_plan.md - タスク計画と段階追跡
• findings.md - 研究発見と知識蓄積
• progress.md - 実行ログと進捗記録

主要ルール（計画ファイル作成後に遵守）：

• 各段階開始前に task_plan.md を読み取り、完了後に状態を更新
• 2 回のサーチ/ブラウズ操作ごとに発見を findings.md に直ちに保存
• すべてのエラーを task_plan.md の「Errors Encountered」表に記録
• 3 回の失敗後はユーザーにエスカレート

鉄則：複雑なタスクは計画なしに実行を開始することはできません。プラットフォームに planning-with-files がない場合でも、同等の計画レコードまたはインラインプランを使用する必要があります；計画段階をスキップすることはできません。

段階1：タスク分析 + スキル検出（Discovery）【ハードスタンダード - すべてのシナリオが経由する】

先に質問してから実行：

• 要件が不合理な場合、仮定に異議を唱え、より良いソリューションを提案
• 「今やる必要があること」と「後で言う」を区別し、非コア範囲を除外
• タスクが大きすぎる場合は、より賢いスタート地点を提案
• まず必要な能力を説明してから、エージェント / スキル / ツールをマッチングしてください；name-first スケジューリングを避ける

タスク概要を出力：

フィールド	内容
タスク目標	[ワンセンテンス説明]
期待される結果	[具体的な成果物]
受け入れ基準	[定量化可能な合格条件]
範囲定義	[must-have vs add-later]
現在のプラットフォーム	[Claude Code / Codex / OpenClaw / Cursor / Unknown]
予想エージェント数	[N 個、推奨 ≤5]
選択シナリオ	[シナリオ番号+名称]
協調モード	[Subagent/Agent Team/Degraded]

スキル完全フォールバック チェーン（強制実行、スキップ不可）：

各サブタスクに対して以下の 3 ステップフォールバック チェーンを実行：

1. ローカルスキルスキャン：

   • 現在のランタイムで可視の available skills / agents / tools / capability index を読み取り
   • 各スキルの名前とトリガーワード/説明を抽出
   • サブタスク キーワードをスキル トリガーワードと比較
   • マッチング成功 → [Skill: skill-name] と注釈、段階2で直接呼び出しに進む

2. 外部スキル検索（ローカルにマッチングがない場合）：

   • プラットフォームが Skill ツールを提供する場合、find-skills を呼び出す：

   Skill(skill="find-skills", args="サブタスクキーワード")
   

   • プラットフォームに Skill ツールがない場合、利用可能な外部能力検索方法を使用；検索能力がない場合はユーザーにダウングレードを説明
   • 検索結果が見つかった → ユーザーに推奨：npx skills add <owner/repo@skill-name> -g -y
   • ユーザーが確認してインストール → 新しいスキルに注釈、段階2で呼び出しに進む
   • ユーザーが拒否またはプラットフォームがインストールできない → ステップ 3 を続行

3. 汎用 Subagent フォールバック（外部もマッチングがない場合）：

   • プラットフォームが subagent をサポート → その役割は汎用 subagent に変更
   • プラットフォームが subagent をサポートしない → その役割はメインスレッド段階実行に変更
   • チーム設計図で [Type: general-purpose] または [Degraded: main-thread staged execution] と注釈

鉄則：段階2に進む前に、この 3 ステップをすべて実行する必要があります。find-skills 検索をスキップすることはできません；プラットフォームに find-skills または Skill ツールがない場合、ダウングレード理由を明示的に記録してください。

段階2：チーム構築

チーム設計図を出力：

番号	役割	職責	モデル	subagent_type	スキル/タイプ	プラットフォームツール/ダウングレード
1	[役割名]	[具体的な職責]	[opus/sonnet/haiku/プラットフォーム デフォルト]	[エージェント タイプ]	[Skill: name] または [Type: general-purpose]	[Task/spawn/custom-agent/main-thread]

説明：最後の 2 列は、その役割が使用するスキル名（段階1で既にマッチング）または汎用タイプ（フォールバック）、および現在のプラットフォームが使用する実際のツールまたはダウングレード パスを注釈します。

段階3：並列実行

• スキル タスク：現在のプラットフォームのスキル呼び出しメカニズムを使用してローカルにインストール済みのスキルを呼び出す；Claude Code の例：Skill(skill="skill-name", args="タスク説明")
• 汎用タスク：現在のプラットフォーム subagent ツールを使用して subagent を生成；Claude Code 対応 Task，Codex/OpenClaw/Cursor はホストが実際に暴露する agent dispatch を使用
• ハイブリッド オーケストレーション時、スキルと subagent は並列実行可能；プラットフォームが並列をサポートしない場合は段階実行し、ダウングレードを説明
• 各エージェント/スキル完了後に報告：✅ [役割名] 完了: [ワンセンテンス結果]
• 問題が発生したときは、自分で黙って1つを選ぶのではなく、ユーザーにオプションを提供

エージェント → スキル委譲（サブエージェントがスキルを呼び出す 3 つのモード）：

general-purpose タイプの subagent は Claude Code では通常すべてのツール権限を持ちます（Skill ツール含む）；他のプラットフォームは、現在のホストが同等のスキル/ツール権限を子エージェントに開放しているかどうかを先に確認する必要があります。

モード	フロー	適用シーン
コーディネーター直接呼び出し	コーディネーター → Skill(skill="name") またはプラットフォーム同等呼び出し → 結果	単一ステップスキル タスク、並列化不要
委譲式呼び出し	コーディネーター → subagent prompt="/ skill-name を使用して X を完了してください" → subagent → Skill/tool またはインライン実行 → 報告	複数スキルの並列、またはスキル実行時間が長い
チーム メンバー呼び出し	team/subagents → タスク割り当て → member → Skill/tool またはインライン実行 → 報告	メンバー間協調が必要な複雑なタスク

委譲式呼び出しのキーポイント：Task/subagent プロンプトに呼び出すスキル名と パラメータを明記；プラットフォームがスキル ツールをサポートする場合のみ自動呼び出しを約束し、そうでない場合はスキル ドキュメントに従ってインライン実行し、説明を加える。

段階4：品質管理 & 製品改善

受け入れ検査：段階1の受け入れ基準に対して項目ごとに確認。

製品改善（機能完全性だけでなく、ユーザー体験の優秀性も）：

• 境界処理：異常入力、空値、極端なケースが対応されているか
• 専門性：命名規範、コード スタイル、エラー メッセージは友好的か
• 完全性：ドキュメント、設定説明、使用例が充実しているか
• プラットフォーム正直性：実際に呼び出したツールとダウングレード動作を正確に説明したか

すべてパス → 段階5に進みます。パス失敗 → 修正に差し戻し、最大 2 ラウンド；まだパス失敗の場合、ユーザーに人的介入を通知。

段階5：結果交付 & デプロイ移譲

実行報告を出力：

項目	内容
総タスク数	X 個、成功 Y 個、失敗 Z 個
実際のプラットフォーム ツール	使用した実際のツール / ダウングレード有無
各エージェント結果	[役割]: [ステータス] - [主要成果]
汇总结論	[すべての結果を統合した最終結論]
後続提案	[現在未対応だが、やる価値のある改善方向]

デプロイ移譲（必要に応じて提供）：

• 実行方法：起動コマンド、環境要件、設定説明
• 検証ステップ：ユーザーが自行検証できる操作チェックリスト
• 既知の制限：現在のバージョンの境界と制約

実行底線

【ハードスタンダード】： 0. planning-with-files またはプラットフォーム同等計画メカニズムの強制使用：複雑なタスクは必ず先に task_plan.md、findings.md、progress.md を作成/維持するか、プラットフォーム同等計画レコードを使用したことを明示的に説明

1. スキル完全フォールバック チェーン実行の強制：ローカル スキャン → Skill(skill="find-skills", args="...") またはプラットフォーム同等検索 → 汎用 subagent/メインスレッド ダウングレード、いかなるステップもスキップ不可

【その他の原則】： 2. 先に目標、後に組織構造——タスクが不明確な場合、先に明確にしてからチーム構築するかを決定 3. チーム規模はタスク複雑度で決定、並列エージェントは 5 個以内を推奨 4. 主要マイルストーンは品質ゲートと ロールバック ポイントが必須 5. 外部ツール利用可能を前提としない、実行前に検証（find-skills 含む） 6. ブラウザ複数ウィンドウはデフォルトで相互独立、コンテキスト非共有 7. コストは制約のみ、固定約束ではない——現実的でないコスト見積もりはしない 8. 危険操作、大規模変更は先にユーザー確認またはホスト プラットフォーム承認ルール遵守が必須 9. プラットフォームにない機能を約束しない；特に Codex/OpenClaw/Cursor で Claude Code の TeamCreate を直接約束しない

エラーハンドリング

エラー タイプ	対応戦略
エージェント実行失敗	ユーザーに通知、リトライ/スキップ/終了/ダウングレード オプション提供
スキル利用不可	フォールバック チェーン に従う：ローカル スキル → find-skills/プラットフォーム同等検索 → 汎用 subagent → メインスレッド段階実行
プラットフォーム ツール欠失	そのプラットフォームで利用可能なツールに変更、ダウングレード パスを明確に説明
モデル タイムアウト	タスク複雑度を調整またはより小さなサブタスクに分割
品質未達基準	修正に差し戻し最大 2 ラウンド、まだ未達の場合は人的介入
コンテキスト オーバーフロー	より小さなサブタスクに分割、バッチで実行