ADK Agent Builder は何をしますか？
GoogleのAgent Development Kit（ADK）を使用して、本番環境対応のエージェントを構築します。スキャフォールディング、ツールの配線、オーケストレーションパターン、テスト、およびオプションのVertex AI Agent Engineへのデプロイをサポートします。
概要
- 最小限で本番志向のADKスキャフォールディング（エージェントエントリポイント、ツールレジストリ、設定、テスト）を作成します。
- シングルエージェントのReActスタイルワークフローとマルチエージェントオーケストレーション（Sequential/Parallel/Loop）をサポートします。
- CI（lint/テスト/スモークプロンプト）およびオプションのAgent Engineデプロイメント検証に適した検証チェックリストを作成します。
前提条件
- プロジェクトと互換性のあるPythonランタイム（通常はPython 3.10以上）
google-adkがインストールされ、インポート可能であること- デプロイする場合：Vertex AIが有効化され、Agent Engineランタイムをデプロイする権限を持つGoogle Cloudプロジェクトへのアクセス
- 環境変数またはシークレットマネージャーを介して利用可能なシークレット（ハードコーディングしないこと）
手順
- スコープを確認する：ローカルのみのエージェントスキャフォールディングか、Vertex AI Agent Engineへのデプロイか。
- アーキテクチャを選択する：
- シングルエージェント（ReAct）：適応型のツール駆動タスク向け
- マルチエージェントシステム（スペシャリスト+オーケストレーター）：複雑なマルチステップワークフロー向け
- ツールのサーフェス（組み込みADKツール + 必要なカスタムツール）と必要な認証情報を定義する。
- プロジェクトをスキャフォールディングする：
src/agents/、src/tools/、tests/、および依存関係ファイル（pyproject.tomlまたはrequirements.txt）
- 最小限の実行可能なエージェントとスモークテストプロンプトを実装し、ツール障害に対する回帰テストを追加する。
- デプロイする場合、
adk deploy ...コマンドとデプロイ後の検証チェックリスト（AgentCard/タスクエンドポイント、権限、ログ）を作成する。
出力
- リポジトリ対応のADKスキャフォールディング（ファイルとディレクトリ）とスターターエージェントコード
- ツールスタブと配線ポイント（新しいツールを安全に追加する場所）
- テストと検証計画（単体テストと最小限のスモークプロンプト）
- オプション：Agent Engineのデプロイコマンドと検証手順
エラーハンドリング
- 依存関係/ランタイムの問題：固定されたインストールコマンドを提供し、インポートを検証する。
- 認証/権限の失敗：不足しているロール/APIを特定し、最小権限の修正を提案する。
- ツールの失敗/レート制限：リトライ/バックオフのガイダンスを追加し、再発を防ぐための回帰テストを追加する。
例
例：シングルReActエージェントのスキャフォールディング
- リクエスト：「PRを要約し、テストの更新を提案するADKエージェントを作成して。」
- 結果：エージェントエントリポイント + ツールレジストリ + ローカル検証用のスモークテストコマンド。
例：マルチエージェントオーケストレーター
- リクエスト：「スーパーバイザー + デプロイヤー + 検証担当者のチームを構築し、Agent Engineにデプロイして。」
- 結果：オーケストレーターのスケルトン、エージェントごとの責務、
adk deploy ...+ デプロイ後のヘルスチェック。
リソース
- 詳細な完全ガイド（参考用に保管）：
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - リポジトリ標準（信頼できるソース）：
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- ADK / Agent Engine ドキュメント：https://cloud.google.com/vertex-ai/docs/agent-engine