ADKエンジニア

ADKエンジニア は何をしますか？

ADK（Agent Development Kit）エージェントおよびマルチエージェントシステムをプロダクションレディに設計します。クリーンな構造、テスト容易性、安全なツール使用、デプロイ自動化を重視します。

概要

このスキルは、保守性と出荷可能性を備えたADKエージェントコードを設計・実装するために使用します。明確なモジュール境界、構造化されたツールインターフェース、回帰テスト、およびデプロイチェックリスト（ローカルまたはAgent Engine）が含まれます。

前提条件

• プロジェクトで固定されたバージョンと一貫性のあるターゲットランタイム（Python/Java/Go）
• インストール済みのADK（および必要なモデル/プロバイダSDKの設定）
• リポジトリで利用可能なテストランナー（最低限ユニットテスト）
• デプロイする場合：Google Cloudプロジェクトへのアクセスと、選択したデプロイターゲットに対する権限

手順

1. 要件を明確化：エージェントの目標、ツールの表面、レイテンシ/コストの制約、デプロイターゲット。
2. アーキテクチャを提案：単一エージェント vs マルチエージェント、オーケストレーションパターン、状態戦略（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 ドキュメント：https://cloud.google.com/vertex-ai/docs/agent-engine