11 KiB
11 KiB
Error Fix
Identifica la causa raíz del mensaje de error, predice el tiempo de resolución y propone soluciones probadas. Aprende patrones de errores similares y presenta inmediatamente la solución adecuada.
Uso
/fix-error [opciones]
Opciones
- Ninguna : Análisis de error estándar
--deep: Modo de análisis profundo (incluye dependencias y factores ambientales)--preventive: Análisis enfocado en medidas preventivas--quick: Solo presenta correcciones aplicables inmediatamente
Ejemplos Básicos
# Análisis de error estándar
npm run build 2>&1
/fix-error
「Analizar error de compilación y presentar método de corrección」
# Modo de análisis profundo
python app.py 2>&1
/fix-error --deep
「Analizar causa raíz del error incluyendo factores ambientales」
# Enfoque en corrección inmediata
cargo test 2>&1
/fix-error --quick
「Presentar método de corrección aplicable inmediatamente」
# Enfoque en medidas preventivas
./app 2>&1 | tail -50
/fix-error --preventive
「Presentar corrección del error y medidas preventivas futuras」
Colaboración con Claude
# Análisis de log de errores
cat error.log
/fix-error
「Identificar causa raíz del error y proponer método de corrección」
# Resolución de fallo de pruebas
npm test 2>&1
/fix-error --quick
「Analizar prueba fallida y presentar propuesta de corrección aplicable inmediatamente」
# Análisis de stack trace
python script.py 2>&1
/fix-error --deep
「Identificar ubicación del problema desde este stack trace y analizar incluyendo factores ambientales」
# Resolver múltiples errores juntos
grep -E "ERROR|WARN" app.log | tail -20
/fix-error
「Clasificar estos errores y advertencias por prioridad y proponer método de resolución para cada uno」
Predicción de Tiempo de Resolución de Error
🚀 Corrección inmediata (dentro de 5 minutos)
├─ Typos, imports olvidados
├─ Variables de entorno no configuradas
├─ Referencia de variables no definidas
└─ Tiempo predicho: 2-5 minutos
⚡ Corrección rápida (dentro de 30 minutos)
├─ Inconsistencia de dependencias
├─ Error de archivo de configuración
├─ Discrepancia de tipos
└─ Tiempo predicho: 10-30 minutos
🔧 Investigación necesaria (dentro de 2 horas)
├─ Error de lógica compleja
├─ Conflicto de procesamiento asíncrono
├─ Problema de integración API
└─ Tiempo predicho: 30 minutos-2 horas
🔬 Análisis profundo (medio día o más)
├─ Originado en arquitectura
├─ Colaboración de múltiples sistemas
├─ Degradación de rendimiento
└─ Tiempo predicho: 4 horas-varios días
Base de Datos de Patrones de Errores Similares
Errores frecuentes y soluciones inmediatas
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 "Cannot read property 'X' of undefined/null" (frecuencia: extremadamente alta)
├─ Causa principal: Falta de verificación null del objeto
├─ Tiempo de resolución: 5-10 minutos
└─ Solución: Añadir optional chaining (?.) o verificación null
📊 "ECONNREFUSED" / "ENOTFOUND" (frecuencia: alta)
├─ Causa principal: Servicio no iniciado o error de configuración URL
├─ Tiempo de resolución: 5-15 minutos
└─ Solución: Confirmar inicio de servicio, verificar variables de entorno
📊 "Module not found" / "Cannot resolve" (frecuencia: alta)
├─ Causa principal: Paquete no instalado, error de especificación de ruta
├─ Tiempo de resolución: 2-5 minutos
└─ Solución: Ejecutar npm install, verificar ruta relativa
📊 "Unexpected token" / "SyntaxError" (frecuencia: media)
├─ Causa principal: Discrepancia de paréntesis/comillas, uso de palabra reservada
├─ Tiempo de resolución: 2-10 minutos
└─ Solución: Verificar syntax highlighting, ejecutar Linter
📊 "CORS policy" / "Access-Control-Allow-Origin" (frecuencia: media)
├─ Causa principal: Falta de configuración CORS del lado servidor
├─ Tiempo de resolución: 15-30 minutos
└─ Solución: Configuración CORS del servidor, configuración proxy
📊 "Maximum call stack size exceeded" (frecuencia: baja)
├─ Causa principal: Bucle infinito/recursión, referencia circular
├─ Tiempo de resolución: 30 minutos-2 horas
└─ Solución: Verificar condición de terminación de recursión, resolver referencia circular
Matriz de Prioridad de Análisis de Error
| Prioridad | Icono | Alcance Impacto | Dificultad Resolución | Plazo Respuesta | Descripción |
|---|---|---|---|---|---|
| Critical | 🔴 Respuesta urgente | Amplio | Bajo | Inicio dentro 15 min | Parada total sistema, riesgo pérdida datos |
| High Priority | 🟠 Respuesta temprana | Amplio | Alto | Inicio dentro 1 hora | Parada función principal, afecta muchos usuarios |
| Medium | 🟡 Respuesta planificada | Limitado | Alto | Respuesta mismo día | Restricción función parcial, existe solución alternativa |
| Low | 🟢 Observación | Limitado | Bajo | Próxima modificación | Fallo menor, pequeño impacto en UX |
Proceso de Análisis
Phase 1: Recopilación de Información de Error
🔴 Ejecución obligatoria:
- Obtención completa del mensaje de error
- Verificación del stack trace
- Identificación de condiciones de ocurrencia (reproducibilidad)
🟡 Ejecución temprana:
- Recopilación información ambiente (OS, versión, dependencias)
- Historial de cambios inmediatos (git log, commits recientes)
- Verificación logs relacionados
🟢 Ejecución adicional:
- Estado recursos del sistema
- Estado de red
- Estado servicios externos
Phase 2: Análisis de Causa Raíz
-
Organización de síntomas superficiales
- Contenido exacto del mensaje de error
- Timing y patrón de ocurrencia
- Identificación del alcance de impacto
-
Identificación de causa profunda
- Aplicación de análisis 5 Whys
- Rastreo de dependencias
- Verificación de diferencias ambientales
-
Verificación de hipótesis
- Creación de código mínimo de reproducción
- Ejecución de prueba de aislamiento
- Refinamiento de causas
Phase 3: Implementación de Solución
🔴 Manejo inmediato (hotfix):
- Corrección mínima para suprimir síntomas
- Aplicación de solución temporal
- Preparación para despliegue de emergencia
🟡 Resolución fundamental:
- Corrección esencial para la causa
- Adición de casos de prueba
- Actualización de documentación
🟢 Implementación de medidas preventivas:
- Fortalecimiento de manejo de errores
- Configuración de monitoreo/alertas
- Mejora de pipeline CI/CD
Ejemplo de Salida
🚨 Reporte de Análisis de Error
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 Resumen del Error
├─ Tipo: [Compilación/Tiempo ejecución/Lógico/Ambiental]
├─ Urgencia: 🔴 Alta / 🟡 Media / 🟢 Baja
├─ Alcance impacto: [Nombre función/Componente]
└─ Reproducibilidad: [100% / Intermitente / Condición específica]
🔍 Causa Raíz
├─ Causa directa: [Causa específica]
├─ Factor de fondo: [Ambiente/Configuración/Dependencias]
└─ Disparador: [Condición de ocurrencia]
💡 Solución
🔴 Manejo inmediato:
1. [Comando/código de corrección específico]
2. [Medida temporal]
🟡 Resolución fundamental:
1. [Método de corrección esencial]
2. [Refactoring necesario]
🟢 Medidas preventivas:
1. [Mejora de manejo de errores]
2. [Adición de pruebas]
3. [Configuración de monitoreo]
📝 Procedimiento de Verificación
1. [Método de verificación tras aplicar corrección]
2. [Comando de ejecución de pruebas]
3. [Items de verificación de funcionamiento]
Método de Análisis por Tipo de Error
Error de Compilación/Build
# Error de tipo TypeScript
Verificación obligatoria (alta):
- Configuración de tsconfig.json
- Existencia de archivos de definición de tipo (.d.ts)
- Exactitud de declaraciones import
# Error de lifetime de Rust
Verificación obligatoria (alta):
- Movimiento de ownership
- Período válido de referencia
- Conflicto de mutabilidad
Error de Tiempo de Ejecución
# Referencia Null/Undefined
Verificación obligatoria (alta):
- Falta de optional chaining
- Timing de inicialización
- Espera de completación de procesamiento asíncrono
# Error relacionado con memoria
Verificación obligatoria (alta):
- Obtención de heap dump
- Análisis de log GC
- Detección de referencia circular
Error de Dependencias
# Conflicto de versión
Verificación obligatoria (alta):
- Consistencia de archivo lock
- Requisitos de peer dependencies
- Dependencias transitivas
# Error de resolución de módulo
Verificación obligatoria (alta):
- Configuración NODE_PATH
- Configuración de alias de ruta
- Enlaces simbólicos
Precauciones
- Absolutamente prohibido: Juicio basado solo en parte del mensaje de error, aplicación de solución Stack Overflow sin verificación
- Condiciones de excepción: Medidas temporales permitidas solo bajo estas 3 condiciones:
- Respuesta de emergencia ambiente producción (resolución fundamental obligatoria dentro 24 horas)
- Fallo servicio externo (medio alternativo durante espera de recuperación)
- Bug conocido de framework (esperando lanzamiento de versión corregida)
- Recomendación: Priorizar identificación de causa raíz, evitar corrección superficial
Mejores Prácticas
- Recopilación completa de información: Verificar mensaje de error desde inicio hasta final
- Verificación de reproducibilidad: Priorizar creación de código mínimo de reproducción
- Enfoque gradual: Comenzar con pequeñas correcciones y verificar
- Documentación: Registrar proceso de resolución para compartir conocimiento
Trampas Comunes
- Manejo de síntomas: Corrección superficial que pasa por alto causa raíz
- Generalización excesiva: Aplicar ampliamente solución de caso específico
- Omisión de verificación: No confirmar efectos secundarios tras corrección
- Personalización de conocimiento: No documentar método de resolución
Comandos Relacionados
/design-patterns: Analizar problemas de estructura de código y proponer patrones/tech-debt: Analizar causa raíz de errores desde perspectiva de deuda técnica/analyzer: Cuando se necesita análisis de causa raíz más profundo