mcpField
A
adk-agent-builder

adk-agent-builder

github.com/jeremylongshoreエージェントワークフロー2.9k39 回インストール2 日前に更新
リポジトリ

adk-agent-builder について

Google Agent Development Kit（ADK）エージェントの構築と検証を支援するスキルです。ローカルの単一エージェントから、Vertex AI Agent Engine への任意のデプロイを含むマルチエージェント構成まで、コードやテストを整えたい開発者向けです。

主な機能

  1. 01ADK プロジェクトのひな形作成
  2. 02単一・マルチエージェント構成
  3. 03ツール接続と初期コード
  4. 04テストと CI 検証チェックリスト
  5. 05任意の Agent Engine デプロイ

活用シーン

  1. 01ローカル ReAct エージェントの開始
  2. 02マルチエージェントワークフローの構成
  3. 03デプロイ前のテスト準備
  4. 04Agent Engine デプロイの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill adk-agent-builder

インストール後、Claude Code で/adk-agent-builderを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

ARD.md
PRD.md
references/
errors.md
examples.md
implementation.md

詳細

ADK エージェントビルダー

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 プロジェクトへのアクセス
  • 環境変数またはシークレットマネージャー経由で利用できるシークレット（ハードコードしないでください）

手順

  1. 範囲を確認します。ローカルのみのエージェントスキャフォールドにするか、Vertex AI Agent Engine にデプロイするかを決めます。
  2. アーキテクチャを選択します。
    • 適応的なツール駆動型タスクには単一エージェント（ReAct）
    • 複雑な複数ステップのワークフローにはマルチエージェントシステム（専門エージェント＋オーケストレーター）
  3. ツールの範囲（ADK 組み込みツールと必要なカスタムツール）および必要な認証情報を定義します。
  4. プロジェクトをスキャフォールドします。
    • src/agents/、src/tools/、tests/、および依存関係ファイル（pyproject.toml または requirements.txt）
  5. 最小限の実用的なエージェントとスモークテスト用プロンプトを実装し、ツールの障害に対する回帰テストを追加します。
  6. デプロイする場合は、adk deploy ... コマンドとデプロイ後の検証チェックリスト（AgentCard／タスクエンドポイント、権限、ログ）を用意します。

出力

  • リポジトリですぐに使える ADK スキャフォールド（ファイルとディレクトリ）およびスターターエージェントコード
  • ツールのスタブと接続ポイント（新しいツールを安全に追加する場所）
  • テストと検証の計画（ユニットテストと最小限のスモークプロンプト）
  • 任意：Agent Engine のデプロイコマンドと検証手順

エラー処理

  • 依存関係／ランタイムの問題：バージョンを固定したインストールコマンドを提示し、インポートを検証します。
  • 認証／権限エラー：不足しているロール／API を特定し、最小権限での解決策を提案します。
  • ツールの障害／レート制限：再試行／バックオフの方針を示し、再発防止の回帰テストを追加します。

例

例：単一の ReAct エージェントをスキャフォールドする

  • リクエスト：「PR を要約してテストの更新を提案する ADK エージェントを作成してください。」
  • 結果：ローカル検証用のエージェントエントリーポイント、ツールレジストリ、スモークテストコマンド。

例：マルチエージェントオーケストレーター

  • リクエスト：「スーパーバイザー、デプロイヤー、検証担当で構成するチームを構築し、Agent Engine にデプロイしてください。」
  • 結果：オーケストレーターの骨組み、各エージェントの役割、adk deploy ...、およびデプロイ後のヘルスチェック。

リソース

  • 実装パターン（スキャフォールド、ツールの接続、オーケストレーション）：${CLAUDE_SKILL_DIR}/references/implementation.md
  • 実例（単一エージェント＋マルチエージェント）：${CLAUDE_SKILL_DIR}/references/examples.md
  • エラー処理と復旧のパターン：${CLAUDE_SKILL_DIR}/references/errors.md
  • 製品／アーキテクチャの背景情報：${CLAUDE_SKILL_DIR}/PRD.md、${CLAUDE_SKILL_DIR}/ARD.md
  • ADK／Agent Engine のドキュメント：

コメント

Markdown 対応