adk-engineer

ADK エンジニア

本番環境に対応できる Agent Development Kit（ADK）エージェントとマルチエージェントシステムを構築します。明確な構成、テスト容易性、安全なツール利用、自動デプロイを重視します。

概要

保守しやすく、リリース可能な ADK エージェントのコードを設計・実装するために、このスキルを使用します。明確なモジュール境界、構造化されたツールインターフェース、リグレッションテスト、デプロイのチェックリスト（ローカルまたは Agent Engine）を用意します。

前提条件

• プロジェクトで固定されているバージョンに対応した実行環境（Python／Java／Go）
• ADK がインストール済みであること（必要なモデル／プロバイダー SDK も設定済みであること）
• リポジトリで利用可能なテストランナー（最低限、ユニットテスト）
• デプロイする場合：Google Cloud プロジェクトへのアクセス権と、選択したデプロイ先に必要な権限

手順

1. 要件を明確にします。エージェントの目標、ツールの範囲、レイテンシ／コストの制約、デプロイ先を確認します。
2. アーキテクチャを提案します。単一エージェントかマルチエージェントか、オーケストレーションパターン、状態管理戦略（Memory Bank／外部ストア）を決定します。
3. 構成を作成します。エージェントのエントリーポイント、ツールのモジュール、設定、テストを用意します。
4. 段階的に実装します。
   • 入力検証と構造化された出力を備えたツールを、一度に1つずつ追加します。
   • 各ツールと重要なプロンプトのフローにリグレッションテストを追加します。
5. 運用上のガードレールを追加します。再試行／バックオフ、タイムアウト、ロギング、安全なエラーメッセージを設定します。
6. ローカルで検証し（テストとスモークプロンプト）、依頼に応じてデプロイ計画を提示します。

出力

• 具体的なアーキテクチャ計画とファイル構成
• テスト付きのエージェントとツールの実装（またはパッチ）
• 検証チェックリスト（実行するコマンド、期待される出力、失敗時の切り分け）
• 任意：デプロイ手順とデプロイ後のヘルスチェック

エラー処理

• ビルド／テストの失敗：失敗したモジュールを特定し、再現手順を最小限にして修正し、リグレッションテストを追加します。
• ツール／ランタイムエラー：適切な場合は構造化されたエラーレスポンスと安全な再試行を徹底します。
• デプロイの失敗：失敗したコマンドを正確に提示し、確認するログと最小権限の IAM 修正方法を示します。

例

例：既存の ADK エージェントを本番環境向けに整備する

• 依頼：「このエージェントのモジュール構成を整理し、デプロイ前にテストを追加してください。」
• 結果：再編成された src/ 構成、ツールの境界、テストスイート、デプロイチェックリスト。

例：マルチエージェントのワークフロー

• 依頼：「逐次オーケストレーターを使って、バリデーター、デプロイヤー、モニターのエージェントチームを構築してください。」
• 結果：オーケストレーターのひな型、各エージェントの役割、各ステップのスモークテスト。

リソース

• 詳細なプレイブック全文（参照用）：${CLAUDE_SKILL_DIR}/references/SKILL.full.md
• リポジトリの標準（正式な基準）：
  • 000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md
  • 000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
• ADK／Agent Engine のドキュメント：