/qa — Flujo de Trabajo de Control de Calidad
Ejecuta esta skill para realizar un control de calidad exhaustivo sobre cambios recientes o un archivo específico.
Archivos Modificados Recientemente
!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "no se detectaron cambios recientes"
Fase 1: Reconocimiento
- Detectar framework de pruebas comprobando:
Gemfilecon rspec/minitest → RSpec o Minitestmix.exs→ ExUnitpackage.jsoncon jest/vitest → Jest o Vitestplaywright.config→ Playwright
- Identificar archivos modificados — si
$ARGUMENTSes la ruta de un archivo, usar ese; en caso contrario ejecutargit diff --name-only HEAD~1 - Clasificar cada archivo por nivel de riesgo:
- CRÍTICO: autenticación, pagos, modelos de datos, utilidades compartidas, endpoints de API
- ALTO: lógica de negocio, servicios, controladores
- MEDIO: vistas, serializadores, ayudantes, configuración
- BAJO: documentación, comentarios, formato
- Leer cada archivo modificado y sus pruebas existentes (si las hay). Si se han modificado más de ~5 archivos,
delegar esta lectura al agente
codebase-explorery trabajar a partir de su resumen — mantener el contexto principal para las preguntas y las pruebas. - Construir una tabla de contexto:
| Archivo | Tipo | Riesgo | ¿Pruebas Existentes? |
|---|---|---|---|
| ... | ... | ... | ... |
Fase 2: Interrogatorio
Antes de escribir cualquier prueba, realizar de 3 a 8 preguntas de sondeo usando AskUserQuestion. Agrupar las preguntas — no preguntar de una en una.
Buenas preguntas (centradas en el riesgo):
- "Esto afecta al flujo de pagos — ¿debo probar casos extremos de reembolso?"
- "La nueva validación rechaza la entrada vacía. ¿Qué pasa con cadenas solo unicode?"
- "Este servicio llama a una API externa — ¿debo simularla o probar la integración?"
Malas preguntas (no preguntar esto):
- "¿Qué hace este código?" (léelo tú mismo)
- "¿Debo escribir pruebas?" (sí, siempre)
- "¿Qué framework de pruebas debo usar?" (detéctalo)
Fase 3: Plan de Pruebas
Presentar un plan de pruebas estructurado ANTES de escribir cualquier especificación. Organizar por categoría:
Categorías de Pruebas
- Camino Feliz — las entradas esperadas producen salidas esperadas
- Casos Extremos — valores límite, entradas vacías, valores máximos, nil/null
- Casos de Error — entrada no válida, fallos de red, tiempos de espera, permiso denegado
- Bizarro/Adversarial — cadenas de inyección SQL, etiquetas de script, emojis, cadenas de 10MB, acceso concurrente
- Rendimiento — consultas N+1, colecciones ilimitadas, consultas lentas (solo para riesgo CRÍTICO/ALTO)
- Integración — interacciones entre componentes (solo cuando se modifican varios archivos)
Presentar como tabla:
| # | Categoría | Descripción de la Prueba | Nivel de Riesgo |
|---|---|---|---|
| 1 | Camino Feliz | Crea registro con parámetros válidos | ALTO |
| ... | ... | ... | ... |
Esperar la aprobación del usuario antes de continuar.
Fase 4: Escritura de Especificaciones
Escribir las especificaciones siguiendo estos patrones:
- Una aserción por prueba (cuando sea práctico)
- Nombres descriptivos —
it "devuelve 404 cuando el registro no se encuentra"noit "funciona" - Estructura Arrange-Act-Assert
- Sin invitados misteriosos — todos los datos de la prueba visibles en ella
- Probar comportamiento, no implementación — no probar métodos privados directamente
- Usar fábricas/fixtures adecuados al framework
- Agrupar por comportamiento con bloques
describe/context
Calidad del Código de Prueba
Las pruebas también son código — aplicar los mismos principios:
- KISS: Sin ayudantes de prueba sobreingenierizados. Si la configuración tiene más de 10 líneas, simplificar la prueba o el código bajo prueba.
- YAGNI: No probar escenarios que no pueden ocurrir. No añadir pruebas "por si acaso" para estados imposibles.
- DRY (con moderación): Preferir duplicación clara sobre ejemplos compartidos ingeniosos. Una prueba debe leerse de principio a fin sin saltar a 3 archivos auxiliares.
- Código Limpio: Nombres de prueba descriptivos que se lean como documentación. Sin invitados misteriosos — todos los datos visibles en la prueba.
Ver @reference.md para notas de pruebas específicas del framework (RSpec, Minitest, ExUnit, Jest/Vitest).
Fase 5: Ejecución y Verificación
- Ejecutar las nuevas especificaciones — ejecución dirigida (solo el nuevo archivo)
- Corregir cualquier fallo — leer error, leer fuente, corregir causa raíz
- Ejecutar la suite completa — asegurar que nada más se rompe
- Producir el informe de QA — Ver @reference.md para la plantilla del informe, auditoría de valores centrales y verificación de racionalización.
Veredicto: ENVIAR / CORREGIR Y VOLVER A PROBAR / NECESITA RETRABAJO