adk-agent-builder

ADK Agent Builder

使用 Google 的 Agent Development Kit（ADK）构建可用于生产环境的 Agent：搭建脚手架、配置工具、编排模式、测试，以及可选部署到 Vertex AI Agent Engine。

概述

• 创建简洁、面向生产环境的 ADK 脚手架（Agent 入口点、工具注册表、配置和测试）。
• 支持单 Agent 的 ReAct 风格工作流，以及多 Agent 编排（Sequential/Parallel/Loop）。
• 生成适用于 CI 的验证清单（lint/测试/冒烟提示词），并可选择验证 Agent Engine 部署。

前置条件

• 与项目兼容的 Python 运行时（通常为 Python 3.10+）
• 已安装 google-adk 且可导入
• 如果要部署：可访问已启用 Vertex AI 的 Google Cloud 项目，并具有部署 Agent Engine 运行时的权限
• 通过环境变量或密钥管理器提供密钥（绝不硬编码）

说明

1. 确认范围：仅限本地的 Agent 脚手架，还是部署到 Vertex AI Agent Engine。
2. 选择架构：
   • 单 Agent（ReAct），适用于自适应的工具驱动任务
   • 多 Agent 系统（专业 Agent + 协调器），适用于复杂的多步骤工作流
3. 定义工具范围（内置 ADK 工具 + 所需的自定义工具）以及所需凭据。
4. 搭建项目脚手架：
   • src/agents/、src/tools/、tests/ 和依赖文件（pyproject.toml 或 requirements.txt）
5. 实现最小可用 Agent 和冒烟测试提示词；为工具故障添加回归测试。
6. 如果要部署，请提供 adk deploy ... 命令和部署后验证清单（AgentCard/任务端点、权限、日志）。

输出

• 可直接用于代码仓库的 ADK 脚手架（文件和目录）以及初始 Agent 代码
• 工具桩和接入点（安全添加新工具的位置）
• 测试与验证计划（单元测试和最简冒烟提示词）
• 可选：Agent Engine 的部署命令和验证步骤

错误处理

• 依赖/运行时问题：提供固定版本的安装命令并验证导入。
• 身份验证/权限失败：指出缺失的角色/API，并提出遵循最小权限原则的修复方案。
• 工具故障/速率限制：提供重试/退避建议，并添加回归测试以防问题再次发生。

示例

示例：搭建单个 ReAct Agent

• 请求：“创建一个 ADK Agent，用于总结 PR 并提出测试更新建议。”
• 结果：Agent 入口点 + 工具注册表 + 用于本地验证的冒烟测试命令。

示例：多 Agent 协调器

• 请求：“构建一个由 supervisor、deployer 和 verifier 组成的团队，并部署到 Agent Engine。”
• 结果：协调器框架、各 Agent 的职责，以及 adk deploy ... + 部署后健康检查。

资源

• 实现模式（脚手架、工具配置、编排）：${CLAUDE_SKILL_DIR}/references/implementation.md
• 完整示例（单 Agent + 多 Agent）：${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 文档：