Communitygithub.com

ADK Agent Builder

使用Google Agent Development Kit构建可用于生产环境的AI Agent:脚手架搭建、工具对接、多Agent编排、测试以及可选部署到Vertex AI Agent Engine。

ADK Agent Builder 是什么?

这个技能专门用于基于Google Agent Development Kit(ADK)构建生产级AI Agent。它提供了一个完整的工作流程:从项目脚手架搭建、工具注册与整合、单Agent(ReAct模式)或多Agent编排(支持串行、并行、循环模式),到编写测试和验证计划。如果用户有部署需求,它还能生成部署命令(`adk deploy`)以及部署后的验证清单,确保Agent在Vertex AI Agent Engine上正常运行。技能还包含了完善的错误处理指导,涵盖依赖冲突、权限认证失败和工具限流等常见问题。该技能非常适合需要快速搭建可测试、可部署ADK Agent的开发者。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/adk-agent-builder

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

ADK Agent 构建器

使用 Google 的 Agent Development Kit (ADK) 构建可用于生产环境的 Agent:包括项目骨架生成、工具连接、编排模式、测试,以及可选的部署到 Vertex AI Agent Engine。

概述

  • 创建一个最小化的、面向生产的 ADK 项目骨架(Agent 入口、工具注册表、配置和测试)。
  • 支持单 Agent ReAct 风格工作流和多 Agent 编排(串行/并行/循环)。
  • 生成适合 CI 的验证清单(lint/测试/冒烟提示),以及可选的 Agent Engine 部署验证。

前提条件

  • 与您的项目兼容的 Python 运行时(通常需要 Python 3.10+)
  • 已安装并可导入 google-adk
  • 如果需要部署:需要有一个启用了 Vertex AI 且有权限部署 Agent Engine 运行时的 Google Cloud 项目
  • 通过环境变量或密钥管理器提供密钥(切勿硬编码)

说明

  1. 确定范围:仅本地 Agent 骨架还是需要部署到 Vertex AI Agent Engine。
  2. 选择架构:
    • 单 Agent(ReAct):适用于自适应工具驱动的任务
    • 多 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 编排器

  • 请求:“构建一个监督者 + 部署者 + 验证者团队,并部署到 Agent Engine。”
  • 结果:编排器骨架、每个 Agent 的职责,以及 adk deploy ... + 部署后的健康检查。

资源

  • 完整详细指南(仅供参考):${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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

相关技能