Ingeniero ADK
Diseña agentes y sistemas multi-agente del Agent Development Kit (ADK) listos para producción: estructura limpia, capacidad de prueba, uso seguro de herramientas y automatización de despliegue.
Resumen
Usa este skill para implementar código de agente ADK que sea mantenible y desplegable: límites de módulo claros, interfaces de herramienta estructuradas, pruebas de regresión y una lista de verificación de despliegue (local o Agent Engine).
Prerrequisitos
- Un runtime objetivo (Python/Java/Go) coherente con las versiones fijadas del proyecto.
- ADK instalado (y cualquier SDK de modelo/proveedor requerido configurado).
- Un ejecutor de pruebas disponible en el repositorio (pruebas unitarias como mínimo).
- Si se despliega: acceso a un proyecto de Google Cloud y permisos para el objetivo de despliegue elegido.
Instrucciones
- Aclarar requisitos: objetivos del agente, superficie de herramientas, restricciones de latencia/coste y objetivo de despliegue.
- Proponer arquitectura: agente único vs multi-agente, patrón de orquestación, estrategia de estado (Memory Bank / almacén externo).
- Andamiar la estructura: punto(s) de entrada del agente, módulos de herramientas, configuración y pruebas.
- Implementar de forma incremental:
- agregar una herramienta a la vez con validación de entrada y salidas estructuradas.
- agregar pruebas de regresión para cada herramienta y flujos de prompt críticos.
- Agregar salvaguardas operativas: reintentos/backoff, tiempos de espera, registro y mensajes de error seguros.
- Validar localmente (pruebas + prompts de humo) y proporcionar un plan de despliegue (cuando se solicite).
Salida
- Un plan de arquitectura concreto y un diseño de archivos.
- Implementaciones (o parches) de agentes y herramientas con pruebas.
- Una lista de verificación de validación (comandos a ejecutar, resultados esperados y diagnóstico de fallos).
- Opcional: instrucciones de despliegue y comprobaciones de salud posteriores al despliegue.
Manejo de Errores
- Fallos de compilación/prueba: aislar el módulo que falla, minimizar la reproducción, corregir y agregar una prueba de regresión.
- Errores de herramienta/tiempo de ejecución: imponer respuestas de error estructuradas y reintentos seguros cuando sea apropiado.
- Fallos de despliegue: proporcionar el comando exacto que falla, los registros a inspeccionar y las correcciones IAM de mínimo privilegio.
Ejemplos
Ejemplo: Puesta en producción de un agente ADK existente
- Solicitud: "Refactoriza este agente en una estructura de módulo limpia y agrega pruebas antes de que despleguemos."
- Resultado: diseño
src/reorganizado, límites de herramientas, un conjunto de pruebas y una lista de verificación de despliegue.
Ejemplo: Flujo de trabajo multi-agente
- Solicitud: "Construye un equipo de agentes validador + desplegador + monitor con un orquestador secuencial."
- Resultado: esqueleto del orquestador, responsabilidades por agente y pruebas de humo para cada paso.
Recursos
- Manual completo detallado (conservado como referencia):
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - Estándares del repositorio (fuente de verdad):
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- Documentación de ADK / Agent Engine: https://cloud.google.com/vertex-ai/docs/agent-engine