Polyglot Test Agent

Skill de generación de pruebas políglota

Una habilidad impulsada por IA que genera pruebas unitarias completas y funcionales para cualquier lenguaje de programación usando un pipeline coordinado de múltiples agentes.

Cuándo usar esta skill

Usa esta habilidad cuando necesites:

• Generar pruebas unitarias para un proyecto completo o archivos concretos
• Mejorar la cobertura de pruebas de código existente
• Crear archivos de prueba que sigan convenciones del proyecto
• Escribir pruebas que realmente compilen y pasen
• Añadir pruebas para nuevas funcionalidades o código sin pruebas

Cómo funciona

Esta habilidad coordina múltiples agentes especializados en un pipeline Research → Plan → Implement:

Resumen del pipeline

┌─────────────────────────────────────────────────────────────┐
│                     TEST GENERATOR                          │
│  Coordinates the full pipeline and manages state            │
└─────────────────────┬───────────────────────────────────────┘
                      │
        ┌─────────────┼─────────────┐
        ▼             ▼             ▼
┌───────────┐  ┌───────────┐  ┌───────────────┐
│ RESEARCHER│  │  PLANNER  │  │  IMPLEMENTER  │
│           │  │           │  │               │
│ Analyzes  │  │ Creates   │  │ Writes tests  │
│ codebase  │→ │ phased    │→ │ per phase     │
│           │  │ plan      │  │               │
└───────────┘  └───────────┘  └───────┬───────┘
                                      │
                    ┌─────────┬───────┼───────────┐
                    ▼         ▼       ▼           ▼
              ┌─────────┐ ┌───────┐ ┌───────┐ ┌───────┐
              │ BUILDER │ │TESTER │ │ FIXER │ │LINTER │
              │         │ │       │ │       │ │       │
              │ Compiles│ │ Runs  │ │ Fixes │ │Formats│
              │ code    │ │ tests │ │ errors│ │ code  │
              └─────────┘ └───────┘ └───────┘ └───────┘

Step-by-Step Instructions

Paso 1: determinar la solicitud de la persona usuaria

Asegúrate de entender qué está pidiendo la persona usuaria y en qué alcance. Cuando la persona usuaria no exprese requisitos claros sobre estilo de test, objetivos de cobertura o convenciones, usa las guías de unit-test-generation.prompt.md. Este prompt aporta buenas prácticas para descubrir convenciones, estrategias de parametrización, metas de cobertura (objetivo 80%) y patrones por lenguaje.

Paso 2: invocar el generador de pruebas

Empieza invocando el agente polyglot-test-generator con tu solicitud de generación de pruebas:

Generate unit tests for [path or description of what to test], following the [unit-test-generation.prompt.md](unit-test-generation.prompt.md) guidelines

El Test Generator gestionará automáticamente todo el pipeline.

Paso 3: fase de investigación (automática)

El agente polyglot-test-researcher analiza tu código para entender:

• Lenguaje y framework: detecta C#, TypeScript, Python, Go, Rust, Java, etc.
• Framework de pruebas: identifica MSTest, xUnit, Jest, pytest, go test, etc.
• Estructura del proyecto: mapea archivos fuente, pruebas existentes y dependencias
• Comandos de build: descubre cómo compilar y probar el proyecto

Salida: .testagent/research.md

Paso 4: fase de planificación (automática)

El agente polyglot-test-planner crea un plan de implementación estructurado:

• Agrupa archivos en fases lógicas (típicamente 2-5 fases)
• Prioriza por complejidad y dependencias
• Especifica casos de prueba para cada archivo
• Define criterios de éxito por fase

Salida: .testagent/plan.md

Paso 5: fase de implementación (automática)

El agente polyglot-test-implementer ejecuta cada fase de forma secuencial:

1. Read archivos fuente para entender la API
2. Write archivos de prueba siguiendo los patrones del proyecto
3. Build usando el subagente polyglot-test-builder para verificar compilación
4. Test usando el subagente polyglot-test-tester para verificar que las pruebas pasen
5. Fix usando el subagente polyglot-test-fixer si aparecen errores
6. Lint usando el subagente polyglot-test-linter para el formateo del código

Cada fase se completa antes de empezar la siguiente, asegurando progreso incremental.

Tipos de cobertura

• Ruta feliz: entradas válidas producen salidas esperadas
• Casos límite: valores vacíos, fronteras, caracteres especiales
• Casos de error: entradas inválidas, manejo de null, excepciones

Gestión del estado

Todo el estado del pipeline se guarda en la carpeta .testagent/:

Archivo	Propósito
.testagent/research.md	Resultados del análisis del codebase
.testagent/plan.md	Plan de implementación por fases
.testagent/status.md	Seguimiento de progreso (opcional)

Ejemplos

Ejemplo 1: pruebas del proyecto completo

Generate unit tests for my Calculator project at C:\src\Calculator

Ejemplo 2: pruebas de un archivo específico

Generate unit tests for src/services/UserService.ts

Ejemplo 3: cobertura focalizada

Añade pruebas para el módulo de autenticación con foco en casos límite

Referencia de agentes

Agente	Propósito	Herramientas
polyglot-test-generator	Coordina el pipeline	runCommands, codebase, editFiles, search, runSubagent
polyglot-test-researcher	Analiza el codebase	runCommands, codebase, editFiles, search, fetch, runSubagent
polyglot-test-planner	Crea el plan de pruebas	codebase, editFiles, search, runSubagent
polyglot-test-implementer	Escribe archivos de prueba	runCommands, codebase, editFiles, search, runSubagent
polyglot-test-builder	Compila el código	runCommands, codebase, search
polyglot-test-tester	Ejecuta pruebas	runCommands, codebase, search
polyglot-test-fixer	Corrige errores	runCommands, codebase, editFiles, search
polyglot-test-linter	Formatea código	runCommands, codebase, search

Requisitos

• El proyecto debe tener configurado un sistema de build/test
• El framework de pruebas debe estar instalado (o ser instalable)
• VS Code con la extensión GitHub Copilot

Resolución de problemas

Las pruebas no compilan

El agente polyglot-test-fixer intentará resolver errores de compilación. Revisa .testagent/plan.md para verificar la estructura esperada de pruebas.

Las pruebas fallan

Revisa la salida de las pruebas y ajusta expectativas. Algunas pruebas pueden requerir mocks de dependencias.

Se detectó un framework de pruebas incorrecto

Especifica el framework preferido en la solicitud inicial: "Generate Jest tests for..."