Communitygithub.com

Construtor de Agentes ADK

Construa agentes de IA prontos para produção usando o Google Agent Development Kit com integração de assistentes de IA, padrões React, orquestração multi-agente e bibliotecas de ferramentas abrangentes. Use quando o contexto apropriado for detectado. Ative com frases relevantes com base no propósito da habilidade.

O que é Construtor de Agentes ADK?

Esta habilidade, Construtor de Agentes ADK, capacita desenvolvedores a criar agentes de IA prontos para produção utilizando o Google Agent Development Kit (ADK). Ela é útil para cenários que vão desde agentes únicos com fluxos de trabalho ReAct adaptativos até sistemas multi-agente com orquestração sequencial, paralela ou em loop, ideais para tarefas complexas e de múltiplas etapas. A habilidade suporta as plataformas Claude Code, Cursor e Codex, gerando um scaffold de projeto completo com ponto de entrada do agente, registro de ferramentas, configuração e testes. Seu funcionamento é baseado na escolha entre arquitetura de agente único ou multi-agente, definição da superfície de ferramentas (incluindo ferramentas ADK integradas e personalizadas), scaffolding do projeto com estrutura de diretórios como `src/agents/`, `src/tools/` e `tests/`, implementação do agente mínimo viável com testes de fumaça e, opcionalmente, comandos de deploy para o Vertex AI Agent Engine com checklist de validação pós-implantação.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Construtor de Agentes ADK faz?

Construa agentes prontos para produção com o Google Agent Development Kit (ADK): scaffolding, integração de ferramentas, padrões de orquestração, testes e deploy opcional no Vertex AI Agent Engine.

Visão Geral

  • Cria um scaffold ADK mínimo e voltado para produção (ponto de entrada do agente, registro de ferramentas, configuração e testes).
  • Suporta fluxos de trabalho ReAct de agente único e orquestração multi-agente (Sequencial/Paralelo/Loop).
  • Produz uma checklist de validação adequada para CI (lint/testes/prompts de fumaça) e verificação opcional de deploy no Agent Engine.

Pré-requisitos

  • Runtime Python compatível com seu projeto (geralmente Python 3.10+)
  • google-adk instalado e importável
  • Se for fazer deploy: acesso a um projeto do Google Cloud com Vertex AI ativado e permissões para implantar runtimes do Agent Engine
  • Segredos disponíveis via variáveis de ambiente ou um gerenciador de segredos (nunca codificados diretamente)

Instruções

  1. Confirme o escopo: scaffold de agente apenas local vs. deploy no Vertex AI Agent Engine.
  2. Escolha uma arquitetura:
    • Agente único (ReAct) para tarefas adaptativas orientadas por ferramentas
    • Sistema multi-agente (especialistas + orquestrador) para fluxos de trabalho complexos e de múltiplas etapas
  3. Defina a superfície de ferramentas (ferramentas ADK integradas + quaisquer ferramentas personalizadas que você precisar) e as credenciais necessárias.
  4. Crie o scaffold do projeto:
    • src/agents/, src/tools/, tests/, e um arquivo de dependências (pyproject.toml ou requirements.txt)
  5. Implemente o agente mínimo viável e um prompt de teste de fumaça; adicione testes de regressão para falhas de ferramentas.
  6. Se for fazer deploy, produza um comando adk deploy ... e uma checklist de validação pós-implantação (AgentCard/endpoints de tarefa, permissões, logs).

Saída

  • Um scaffold ADK pronto para repositório (arquivos e diretórios) mais código inicial do agente
  • Stubs de ferramentas e pontos de conexão (onde adicionar novas ferramentas com segurança)
  • Um plano de teste e validação (testes unitários e um prompt de fumaça mínimo)
  • Opcional: comandos de deploy e etapas de verificação para o Agent Engine

Tratamento de Erros

  • Problemas de dependência/runtime: forneça comandos de instalação fixados e valide as importações.
  • Falhas de autenticação/permissão: identifique a função/API ausente e proponha correções de privilégio mínimo.
  • Falhas de ferramentas/limites de taxa: adicione orientação de retentativas/backoff e um teste de regressão para evitar recorrência.

Exemplos

Exemplo: Scaffold de um agente ReAct único

  • Solicitação: "Crie um agente ADK que resuma PRs e proponha atualizações de teste."
  • Resultado: ponto de entrada do agente + registro de ferramentas + um comando de teste de fumaça para verificação local.

Exemplo: Orquestrador multi-agente

  • Solicitação: "Construa uma equipe de supervisor + implantador + verificador e faça deploy no Agent Engine."
  • Resultado: esqueleto do orquestrador, responsabilidades de cada agente e adk deploy ... + verificações de integridade pós-implantação.

Recursos

  • Guia detalhado completo (mantido para referência): ${CLAUDE_SKILL_DIR}/references/SKILL.full.md
  • Padrões do repositório (fonte da verdade):
    • 000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md
    • 000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
  • Documentação do 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".

Habilidades Relacionadas