agent-team-builder

エージェントチームビルダー

対話形式のヒアリングを通じて、ビジネスワークフロー向けの本番環境対応マルチエージェントチーム構成を設計、生成します。このスキルで生成するのは構成ファイルであり、エージェントの実行やデプロイは行いません。

目次

• references/team-templates.md — 営業、サポート、リサーチ、コンテンツチームの出発点。
• references/config-schema.md — team-config.yaml の完全なスキーマと、高度な機能（A2A メッセージング、スケーリング、共有コンテキスト）。
• references/output-files.md — 生成するファイルと最終回答の形式。

ワークフロー

設計を始める前に、必ずヒアリングを完了してください。ビジネスプロセスを理解せずにチーム構成を生成してはいけません。

1. ヒアリングを行います。 次の項目について、一度に1つずつユーザーに質問します。

   • プロセス名（自動化する対象）。
   • 現状（関与する担当者、引き継ぎのタイミング）。
   • 課題（遅延、エラー、ボトルネックが発生する箇所）。
   • 処理量（1日、1週間、1か月あたりの実行回数）。
   • 成功指標（所要時間、エラー率、満足度）。
   • 制約（コンプライアンス、承認ゲート、人間の介在）。
   • 連携先（CRM、メール、Slack、データベース、API）。

2. チームアーキテクチャを設計します。 エージェントの最小数（通常は3～7）を決定します。必要に応じて次の役割タイプを選択します。

   • コーディネーター — ワークフローを統括し、タスクを振り分け、例外に対応します。
   • スペシャリスト — 1つの領域に関する深い専門知識を持ちます。
   • バリデーター — 品質保証、コンプライアンス確認、出力レビューを行います。
   • インターフェース — 外部とのコミュニケーションを担当します。
   • データ — データの取得、変換、保存を管理します。

   通信パターンとして、ハブアンドスポーク（順次処理）、パイプライン（直線処理）、メッシュ（協調処理）、ブロードキャスト（通知）から選択します。適合するテンプレートがある場合は、references/team-templates.md のテンプレートを出発点にしてください。

3. 各エージェントを仕様化します。 次の項目を定義します。エージェント ID、役割名、完全な本番環境対応システムプロンプト、ツールアクセス（最小権限）、入力スキーマ、出力スキーマ、引き継ぎルール、エスカレーションルール、成功基準、障害モード。

4. 構成ファイルを生成します。 references/output-files.md に従い、references/config-schema.md に準拠した team-config.yaml、エージェントごとの agents/{id}/prompt.md、workflow.md、test-scenarios.yaml を生成します。

5. デザインを提示します。 references/output-files.md の回答形式を使用します。

実行ルール

1. 必ずヒアリングから始めます。
2. 最小権限の原則を適用します。各エージェントには、必要なツールとアクセス権のみを付与します。
3. 障害を想定して設計します。すべてのエージェントに、障害モードと復旧策を設定します。
4. 人間が介在する仕組みを維持します。重大な判断のためのエスカレーション経路を含めます。
5. 測定可能な成果を定義します。すべてのエージェントに、追跡可能な成功基準を設定します。
6. 小規模から始めます。エージェントを3～4体にすることを推奨し、パフォーマンスデータに基づいて拡張します。
7. すべてを文書化します。生成する構成を自己文書化され、保守しやすいものにします。
8. デプロイ前にチームを検証できるよう、テストシナリオを生成します。
9. 全面展開の前に、パイロットフェーズを実施することを推奨します。
10. 生成する構成にAPIキー、パスワード、シークレットを含めてはいけません。環境変数の参照を使用します。

生成される team-config.yaml は、エージェントオーケストレーションフレームワークで使用することを想定しています。生成するシステムプロンプトはすべて出発点として扱い、実環境でのパフォーマンスに基づいて改良してください。