チーム・エージェント・オーケストレーション は何をしますか？
このスキルは、エージェントが単独のアシスタントではなく、チームとして管理されている場合に使用します。目的は、チームベースのオーケストレーションを信頼性の高いものにすることです。つまり、明確な作業項目、明示的な所有権、エージェントかんばん状態、ブランチ分離、コントロールペーンの可視性、そしてマージゲートを提供します。
アクティベーションタイミング
- タスクが複数のエージェント、ツール、ハーネス、ブランチ、またはワークツリーを跨いでいる場合。
- ユーザーがチームオーケストレーション、エージェントかんばん、スクワッド、コンダクター、コントロールペーン、マネージャー、デスクトップアプリ、Zellij、tmux、Hermes、Devin、Codex、Claude Code、またはマルチエージェントワークについて言及した場合。
- プロジェクトが、人とエージェント間で共有されるワークフロー状態を必要とする場合。
- 既存のエージェントファンアウトが出力を生成しているが、マージ可能なプロダクトになっていない場合。
運用モデル
すべてのエージェントを、狭い契約を持つチームメイトとして扱います。
- 所有者: 作業項目に対して説明責任を持つ人またはエージェント。
- スコープ: ファイル、ブランチ、ツールサーフェス、および禁止領域。
- 状態: バックログ、準備完了、実行中、レビュー、ブロック中、マージ済み、またはアーカイブ済み。
- 証拠: テスト、スクリーンショット、ログ、レビューノート、または評価レポート。
- マージゲート: 統合を許可する正確な条件。
エージェントかんばん
作業をセッション間で可視化する必要がある場合は、エージェントかんばんを使用します。
| 列 | 意味 | 出口基準 |
|---|---|---|
| バックログ | 候補となる作業項目。まだ具体化されていない | 受け入れ基準が記述されていること |
| 準備完了 | 具体化され、割り当て可能 | 所有者とブランチ/ワークツリーが割り当てられていること |
| 実行中 | エージェントが積極的に作業中 | ハンドオフ成果物と変更ファイルが存在すること |
| レビュー | 作業は完了したが、マージされていない | テスト、差分レビュー、リスクチェックが合格していること |
| ブロック中 | 外部からの入力が必要、またはゲートに失敗 | ブロッカーに所有者と次のアクションが設定されていること |
| マージ済み | メインラインに統合された | PRがマージされた、またはローカルメインが更新されたこと |
| アーカイブ済み | もはや関連性がない | 理由が記録されていること |
各カードは以下のスキーマに従う必要があります:
{
"id": "agent-card-001",
"title": "動的ワークフロースキルの構築",
"owner": "codex",
"state": "running",
"branch": "product/dynamic-workflow-team-orchestration",
"worktree": ".",
"acceptance": [
"スキルが存在すること",
"テストが必要な概念をカバーしていること",
"コンテンツ成果物に動画と記事の視点が含まれていること"
],
"merge_gate": "lint、フォーカステスト、カタログチェックに合格すること",
"handoff": "path/to/handoff.md"
}
チームベースのオーケストレーションフロー
- ボードを具体化する: 曖昧な野心を作業項目に変換し、所有者とマージゲートを設定します。
- 実行モードを選択する: シングルエージェント、動的ワークフローモード、dmux/tmux、ワークツリーファンアウト、または外部デスクトップオーケストレーターから選択します。
- 境界を割り当てる: カードごとに1人の所有者、明確なファイルスコープ、そしてインテグレーターなしでの重複書き込みを禁止します。
- エージェントを実行する: 各エージェントはコードだけでなく、証拠とハンドオフノートを書き出します。
- 順番にレビューする: テスト、差分レビュー、セキュリティ/リスクチェック、コンテンツ/プロダクトのポリッシュの順に行います。
- 意図的にマージする: 1人のインテグレーターが競合を解決し、コントロールペーンまたはステータス成果物を更新します。
- 再利用可能なスキルを抽出する: カードのパターンが繰り返される場合は、それを
skills/に昇格させます。
コントロールペーンの要件
チームオーケストレーションに役立つコントロールペーンは、以下を表示する必要があります:
- アクティブな作業項目とそのエージェントかんばん状態。
- 所有者、ハーネス、ブランチ、ワークツリー、最終ハートビート。
- ハンドオフ成果物、テスト、スクリーンショット、PRへのリンク。
- 所有者とブロック解除アクションでグループ化されたブロッカー。
- 感覚ではなく、ゲートによるマージ準備状態。
- 共有スキルになるべき再利用可能なワークフロー候補。
オペレーターが「これを所有しているのは誰か、何が変更されたか、どのゲートが失敗したか、何が安全にマージできるか」を答えられるようになるまでは、自動化を追加しないでください。
動的ワークフローとの互換性
カードが動的ワークフローモードを必要とする場合:
- タスクローカルなハーネスをカード所有者の下に置きます。
- 入力と出力をカードに保存します。
- 「実行中」から「レビュー」に移行する前に評価を必須とします。
- 繰り返し使用された後にのみ、ハーネスを共有スキルに昇格させます。
注意すべき障害モード
- エージェントスープ: 多くのエージェントが実行中だが、所有者やマージゲートがない。
- 見えない作業: 有用な出力がチャットのトランスクリプト内にのみ存在する。
- ボードの形骸化: かんばんボードは存在するが、カードに受け入れ基準がない。
- 重複書き込み: 並行するエージェントがワークツリーなしで同じファイルを編集する。
- プロダクト成果物の欠如: プロセスがドキュメントは生成するが、実行可能または公開可能なサーフェスを生成しない。
出力基準
各オーケストレーションパスを以下で終了します:
- ボード/カードの変更。
- マージ済みまたは保留中のブランチ。
- テストと評価の証拠。
- 所有者と次のアクションが設定されたブロッカー。
- 新しい共有スキルの候補。