Saltar al contenido
Codex DesignBETA

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 skillsystematic-debugging
Incluida enEl plugin Superpowers, de Jesse Vincent
Instalacióncodex plugin add superpowers@openai-curated, o /plugins en Codex
Codex la usaCada vez que se topa con un bug, un test que falla o un comportamiento inesperado, antes de proponer un arreglo
Fuenteopenai/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

Depurar bien un test que falla
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

Un plugin independiente para Codex. No está afiliado a OpenAI ni cuenta con su respaldo.