Habilidad de Bucle de Verificación
Un sistema de verificación integral para sesiones de Claude Code.
Cuándo Usarlo
Invoca esta habilidad:
- Después de completar una funcionalidad o un cambio de código significativo
- Antes de crear un PR
- Cuando quieras asegurarte de que se superan las puertas de calidad
- Después de refactorizar
Fases de Verificación
Fase 1: Verificación de Compilación
# Verifica si el proyecto compila
npm run build 2>&1 | tail -20
# O
pnpm build 2>&1 | tail -20
Si la compilación falla, DETENTE y corrige antes de continuar.
Fase 2: Verificación de Tipos
set -o pipefail
# Proyectos TypeScript
npx --no-install tsc --noEmit 2>&1 | head -30
# Proyectos Python
pyright . 2>&1 | head -30
Informa todos los errores de tipo. Corrige los críticos antes de continuar.
Fase 3: Verificación con Linter
# JavaScript/TypeScript
npm run lint 2>&1 | head -30
# Python
ruff check . 2>&1 | head -30
Fase 4: Suite de Pruebas
# Ejecuta pruebas con cobertura
npm run test -- --coverage 2>&1 | tail -50
# Verifica umbral de cobertura
# Objetivo: mínimo 80%
Informa:
- Total de pruebas: X
- Pasadas: X
- Fallidas: X
- Cobertura: X%
Fase 5: Escaneo de Seguridad
# Busca secretos
grep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
# Busca console.log
grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10
Fase 6: Revisión de Cambios (Diff)
# Muestra qué cambió
git diff --stat
git diff HEAD~1 --name-only
Revisa cada archivo modificado en busca de:
- Cambios no intencionados
- Falta de manejo de errores
- Posibles casos extremos
Formato de Salida
Después de ejecutar todas las fases, produce un informe de verificación:
INFORME DE VERIFICACIÓN
=======================
Compilación: [PASS/FAIL]
Tipos: [PASS/FAIL] (X errores)
Lint: [PASS/FAIL] (X advertencias)
Pruebas: [PASS/FAIL] (X/Y pasadas, Z% cobertura)
Seguridad: [PASS/FAIL] (X problemas)
Diff: [X archivos modificados]
General: [LISTO/NO LISTO] para PR
Problemas a Corregir:
1. ...
2. ...
Modo Continuo
Para sesiones largas, ejecuta la verificación cada 15 minutos o después de cambios importantes:
Establece un punto de control mental:
- Después de completar cada función
- Después de terminar un componente
- Antes de pasar a la siguiente tarea
Ejecuta: /verificar
Integración con Hooks
Esta habilidad complementa los hooks PostToolUse, pero proporciona una verificación más profunda. Los hooks detectan problemas inmediatamente; esta habilidad ofrece una revisión exhaustiva.