La skill Superpowers systematic debugging para Codex.
La skill systematic debugging de Superpowers evita que Codex pruebe arreglos a ciegas. Tiene que investigar, encontrar la causa raíz y escribir un test que falle antes de tocar el código. Viene en el plugin Superpowers de Jesse Vincent.
Actualizado el 12 de noviembre de 2026 · 3 min de lectura
De un vistazo
| Nombre de la skill | systematic-debugging |
| Incluida en | El plugin Superpowers, de Jesse Vincent |
| Instalación | codex plugin add superpowers@openai-curated, o /plugins en Codex |
| Codex la usa | Cada vez que se topa con un bug, un test que falla o un comportamiento inesperado, antes de proponer un arreglo |
| Fuente | openai/plugins en GitHub |
Qué hace
La regla central de la skill es “ningún arreglo sin investigar antes la causa raíz”. Codex avanza por cuatro fases y termina cada una antes de pasar a la siguiente:
- Causa raíz: lee el error y el stack trace completos, reproduce el bug, revisa los cambios recientes y, en sistemas de varias partes, registra lo que entra y sale de cada capa para ver dónde se rompe.
- Patrón: busca código parecido que funcione, lee la referencia entera y anota cada diferencia.
- Hipótesis: plantea una sola causa y por qué, la comprueba con el cambio más pequeño posible y, si falla, formula una hipótesis nueva en lugar de acumular arreglos.
- Implementación: escribe un test que falle, hace un único arreglo en el origen y verifica que no se haya roto nada más.
Si fallan tres arreglos seguidos, la skill le dice a Codex que se detenga y cuestione la arquitectura contigo antes de intentar un cuarto. También enumera los pensamientos que delatan un atajo, como “prueba a cambiar X y a ver qué pasa”.
La carpeta incluye guías de apoyo para rastrear un bug hacia atrás por la pila de llamadas, añadir validación en varias capas y sustituir timeouts fijos por sondeo de condiciones, además de un script find-polluter.sh que localiza por bisección qué test deja archivos no deseados.
Cuándo usarla
Instálala si Codex suele parchear síntomas, amontonar arreglos o dar vueltas en círculo con un bug. Es especialmente útil con tests inestables, fallos de build y bugs que atraviesan varios componentes.
Pruébala
Usa la skill systematic debugging. El test de checkout empezó a fallar en CI después del merge de ayer, pero en local pasa. Encuentra la causa raíz antes de cambiar nada.
¿Funciona en Claude Code?
Sí. El README de Superpowers incluye Claude Code entre los agentes compatibles, con instalación desde el marketplace oficial de plugins de Claude. Usa ese plugin en lugar de copiar esta carpeta, porque la skill remite a otras skills de Superpowers para el desarrollo guiado por tests y la verificación.
Sigue leyendo
- Plugins vs skills en CodexQué es una skill, qué añade un plugin encima y cuándo usar cada uno.
- Skills de Codex: cómo instalarlas, usarlas y crear las tuyasDónde viven las skills, cómo instalarlas y cómo escribir una.
- Todas las skills de CodexTodas las skills del directorio, agrupadas según para qué sirven.