チームエージェントオーケストレーション は何をしますか？
このスキルは、エージェントが単一のアシスタントではなく、チームとして管理される場合に使用します。目的は、チームベースのオーケストレーションを信頼性の高いものにすることです。明確な作業項目、明示的な所有権、エージェントかんばん状態、ブランチの分離、コントロールペインの可視性、マージゲートを提供します。
アクティベーション条件
- タスクが複数のエージェント、ツール、ハーネス、ブランチ、またはワークツリーにまたがっている場合。
- ユーザーがチームオーケストレーション、エージェントかんばん、スクワッド、コンダクター、コントロールペイン、マネージャー、デスクトップアプリ、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へのリンク。
- 所有者とブロック解除アクションでグループ化されたブロッカー。
- 「雰囲気」ではなく、ゲートごとのマージ準備状況。
- 共有スキルになるべき再利用可能なワークフロー候補。
オペレーターが「これは誰が所有しているのか、何が変更されたのか、どのゲートが失敗したのか、何を安全にマージできるのか」を答えられるまでは、自動化を追加しないでください。
動的ワークフロー互換性
カードが動的ワークフローモードを必要とする場合:
- タスクローカルなハーネスをカード所有者の下に置きます。
- 入力と出力をカードに保存します。
- 「実行中」から「レビュー」に移行する前に評価を要求します。
- 繰り返し使用された後にのみ、ハーネスを共有スキルに昇格させます。
注意すべき障害モード
- エージェントスープ: 多くのエージェントが実行中で、所有者やマージゲートがない。
- 不可視な作業: 有用な出力がチャットのトランスクリプトにのみ存在する。
- ボードシアター: かんばんボードは存在するが、カードに受け入れ基準がない。
- 重複書き込み: 並列エージェントがワークツリーなしで同じファイルを編集する。
- 成果物欠如: プロセスがドキュメントを生成するが、実行可能または公開可能なサーフェスを生成しない。
出力標準
各オーケストレーションパスは、以下で終了します。
- ボード/カードの変更。
- マージ済みまたは保留中のブランチ。
- テストと評価の証拠。
- 所有者と次のアクションが指定されたブロッカー。
- 新しい共有スキルの候補。