Soluciona problemas complejos usando el Método Científico (Observación, Hipótesis, Experimento, Conclusión). Absorbe y unifica la lógica de Systematic Debugging.
Installation
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Soluciona problemas complejos usando el Método Científico (Observación, Hipótesis, Experimento, Conclusión). Absorbe y unifica la lógica de Systematic Debugging.
Detective del Debugging (Unified)
Esta habilidad es el protocolo definitivo para abordar errores técnicos. Evita el "ensayo y error" aleatorio y se centra en la evidencia empírica.
🔴 La Ley de Hierro
NO HAY SOLUCIONES SIN INVESTIGACIÓN DE CAUSA RAÍZ PRIMERO.
Si no has completado la Fase 1, no puedes proponer arreglos. El parche rápido es el enemigo de la estabilidad.
Bitácora: Registra el bug y la autopsia en ACTIVITY_LOG.md.
Optimización: Si no entiendes el error, procesa el stack trace con optimizador-prompts-maestro para hallar claridad.
🕵️ El Protocolo de Investigación
Fase 1: Investigación de Causa Raíz (Root Cause)
Lectura Crítica de Errores: No ignores ni resumas los errores. Lee los stack traces completos. Anota líneas, rutas y códigos de error.
Reproducción Consistente: ¿Puedes activarlo de forma fiable? Define los pasos exactos. Si no es reproducible, necesitas más logs, no una hipótesis.
Diferencial de Cambios: ¿Qué ha cambiado recientemente? (Git diff, dependencias, actualizaciones de config).
Instrumentación de Diagnóstico:
En sistemas multicomponente, añade logs en cada frontera.
Rastrea el flujo de datos hacia atrás (backward tracing) desde el síntoma hasta el origen.
Arregla en el origen, no en el síntoma.
Aislamiento de Rutas Hardware:
En sistemas con múltiples drivers (ej. NVIDIA HDMI y Realtek Onboard), verifica si el destino físico coincide con el origen de captura.
Loopback Validation: En Windows (WASAPI), confirma si el dispositivo de captura es un "Loopback Analogue". El software (Stereo Mix) a menudo no puede "puentear" señales entre dispositivos de hardware distintos fuera de WASAPI.
Limitación: El software estándar a menudo falla al capturar audio de dispositivos Bluetooth o HDMI sin el parche WASAPI adecuado.
Prueba: Cambia la salida física para confirmar si el problema persiste.
Fase 2: Análisis de Patrones e Hipótesis
Búsqueda de Ejemplos Funcionales: Localiza código similar que sí funcione. Compara cada detalle, por pequeño que parezca.
Formulación Científica: "Creo que el problema es X porque observo Y". Enuncia tu hipótesis antes de tocar el código.
Experimento Mínimo: Haz el cambio más pequeño posible para validar la hipótesis. Una variable a la vez.
Fase 3: Implementación y Validación
Test de Fallo (TDD): Crea una prueba (o script mínimo) que falle debido al bug identificado.
Corrección de Raíz: Aplica la solución basándote en la validación de la fase anterior.
Limpieza Forense: Elimina todos los logs y código temporal de debugging.
🚩 Señales de Alerta (Red Flags)
AUDCLNT_E_DEVICE_INVALIDATED: Error crítico en WASAPI. Indica que el dispositivo dejó de estar disponible o cambió el formato. Requiere reinicializar todo el subsistema de audio.
Formato No Soportado: WASAPI es extremadamente rígido con sample_rate y channels. Siempre usa los valores predeterminados (defaultSampleRate) obtenidos del diccionario del dispositivo.
📝 Registro y Persistencia (User-Triggered Closure)
No asumas el éxito hasta que el usuario confirme. Una vez validada la solución:
