チーム通信プロトコル は何をしますか？
エージェントチーム間の構造化されたメッセージングプロトコル。メッセージタイプの選択、計画の承認、シャットダウン手順、および回避すべきアンチパターンを含みます。このスキルは、新しく生成されたチームのコミュニケーション基準を設定する際、ダイレクトメッセージとブロードキャストのどちらを送信すべきか判断する際、チームリーダーが実装者の計画を事前にレビュー・承認する必要がある場合、すべてのタスク完了後にチームを正常にシャットダウンする場合、または統合ポイントでのチームメイト間の調整ミスをデバッグする場合に使用します。
はじめに
このスキルでは、複数のAIエージェントチーム内での一貫性を確保するための、構造化されたメッセージングプロトコルを定義します。
メッセージタイプ
| タイプ | 説明 | 使用例 |
|---|---|---|
DIRECT | 1対1のメッセージ。ターゲットエージェントにのみ表示されます。 | コードレビューの依頼、実装情報の共有 |
BROADCAST | すべてのチームメンバーに送信されるメッセージ。トピックがチーム全体に関わる場合に使用します。 | 計画の更新、ステータス変更、一般的な注意事項 |
ダイレクト vs ブロードキャストの判断
- ダイレクト: メッセージが特定のエージェントまたは設定されたグループにのみ関係する場合。
- ブロードキャスト: メッセージがチーム全体にとって重要である場合（例：目標の変更、APIの変更、リリースの延期）。
計画承認プロトコル
1. 実装者が計画を提出
実装者は、詳細なアクション可能なステップを含む計画を、チームリーダー（TL）（優先度順：チームリーダー、調整役、自身）にダイレクトメッセージで送信します。
2. チームリーダーがレビュー
チームリーダーは以下を確認します：
- 計画がすべてのタスク要件をカバーしているか。
- 依存関係が特定されているか。
- 見積もりが妥当か。
3. 承認または修正要求
チームリーダーは、以下のいずれかのメッセージで応答します：
- 承認:
計画[計画ID]承認済み。次に進んでください。 - 修正要求:
計画[計画ID]修正が必要：[具体的な変更点]。
4. 実装者が調整
実装者は、承認を受け取るまで計画を調整・再提出します。
シャットダウン手順
通常シャットダウン
すべての作業が完了した場合：
BROADCAST: すべてのタスクが完了しました。最終確認を開始します。
→ 確認後：
BROADCAST: シャットダウン中です。さらなる指示がない限り、これ以上の作業は必要ありません。
緊急シャットダウン
予期しない問題が発生した場合（クリティカルエラー、リソース不足）：
DIRECT: TL：緊急シャットダウンが必要です。理由：[簡単な説明]。
→ TLが確認した場合：
BROADCAST: 緊急シャットダウン。理由：[簡単な説明]。直ちに作業を停止してください。
アンチパターン（避けるべきパターン）
| アンチパターン名 | 説明 | 推奨される解決策 |
|---|---|---|
| ゴーストメッセージ | エージェントが応答を待たずにメッセージを送信し、相手に届いていないと想定する。 | 明確な確認応答プロトコルを使用する。 |
| 情報過多ブロードキャスト | チーム全体の関心がない詳細をブロードキャストする。 | 特定のトピックにはダイレクトメッセージを使用する。 |
| シャットダウン後の活動 | シャットダウンがブロードキャストされた後もタスクを続ける。 | シャットダウンメッセージを確認し、すぐに作業を停止する。 |
| 未承認の作業 | チームリーダーの明示的な承認なしにタスクを開始する。 | 作業を開始する前に、チームリーダーに計画を承認してもらう。 |
監視と調整
統合ポイントでの調整の問題を検出するには、チームメイトが適切なメッセージタイプを使用していない、またはシャットダウンプロトコルに従っていない兆候を探してください。調整が中断された場合、問題を特定するために監査ログとメッセージ履歴を確認してください。
ベストプラクティス
- 常に確認応答する: 受信したメッセージには
確認済み：[メッセージID]で返信する。 - 簡潔に保つ: ダイレクトメッセージとブロードキャストの両方で、明確で簡単に読めるメッセージを心がける。
- 一意のIDを使用する: メッセージと計画を追跡しやすくするために一意のIDを使用する。
- 定期的に更新する: 作業中に、重要なマイルストーンが完了したらブロードキャストで更新する。
例
# 実装者からチームリーダーへの計画提出
DIRECT: TL：認証機能の計画を提出します。ID：pln-001。
# チームリーダーから実装者への承認
DIRECT: 実装者：計画 pln-001 承認済み。次に進んでください。
# シャットダウンのブロードキャスト
BROADCAST: すべてのタスクが完了しました。シャットダウン中です。
ライセンス
このスキルは、標準的なMITライセンスの下で利用可能です。