Engenheiro ADK
Projete agentes e sistemas multi-agente do Agent Development Kit (ADK) prontos para produção: estrutura limpa, testabilidade, uso seguro de ferramentas e automação de deploy.
Visão Geral
Use esta skill para implementar código de agente ADK que seja sustentável e implantável: limites de módulo claros, interfaces de ferramentas estruturadas, testes de regressão e uma checklist de deploy (local ou Agent Engine).
Pré-requisitos
- Um runtime alvo (Python/Java/Go) consistente com as versões fixadas do projeto
- ADK instalado (e quaisquer SDKs de modelo/provedor necessários configurados)
- Um executor de testes disponível no repositório (testes unitários no mínimo)
- Se for fazer deploy: acesso a um projeto do Google Cloud e permissões para o alvo de deploy escolhido
Instruções
- Esclareça os requisitos: objetivos do agente, superfície das ferramentas, restrições de latência/custo e alvo de deploy.
- Proponha a arquitetura: agente único vs multi-agente, padrão de orquestração, estratégia de estado (Memory Bank / armazenamento externo).
- Estruture o scaffold: ponto(s) de entrada do agente, módulos de ferramentas, configuração e testes.
- Implemente incrementalmente:
- adicione uma ferramenta por vez com validação de entrada e saídas estruturadas
- adicione testes de regressão para cada ferramenta e fluxos de prompt críticos
- Adicione guardrails operacionais: retries/backoff, timeouts, logging e mensagens de erro seguras.
- Valide localmente (testes + prompts de fumaça) e forneça um plano de deploy (quando solicitado).
Saída
- Um plano de arquitetura concreto e layout de arquivos
- Implementações de agente e ferramentas (ou patches) com testes
- Uma checklist de validação (comandos para executar, saídas esperadas e triagem de falhas)
- Opcional: instruções de deploy e verificações de saúde pós-deploy
Tratamento de Erros
- Falhas de build/teste: isole o módulo com falha, minimize a reprodução, corrija e adicione um teste de regressão.
- Erros de ferramenta/runtime: aplique respostas de erro estruturadas e retries seguros quando apropriado.
- Falhas de deploy: forneça o comando exato que falhou, logs para inspecionar e correções de IAM com privilégio mínimo.
Exemplos
Exemplo: Productionizar um agente ADK existente
- Solicitação: "Refatore este agente em uma estrutura de módulo limpa e adicione testes antes de fazermos o deploy."
- Resultado: layout
src/reorganizado, limites de ferramentas, uma suíte de testes e uma checklist de deploy.
Exemplo: Fluxo de trabalho multi-agente
- Solicitação: "Construa um time de agentes composto por validador + implantador + monitor com um orquestrador sequencial."
- Resultado: esqueleto do orquestrador, responsabilidades por agente e testes de fumaça para cada etapa.
Recursos
- Guia completo detalhado (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.md000-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