Zum Inhalt springen
Codex DesignBETA

Superpowers-Systematic-Debugging-Skill für Codex.

Der Systematic-Debugging-Skill von Superpowers hält Codex davon ab, Korrekturen auf gut Glück zu versuchen. Es muss untersuchen, die eigentliche Ursache finden und einen fehlschlagenden Test schreiben, bevor es Code ändert. Er ist im Superpowers-Plugin von Jesse Vincent enthalten.

Aktualisiert am 12. November 2026 · 3 Min. Lesezeit

Auf einen Blick

Skill-Namesystematic-debugging
Enthalten inDem Superpowers-Plugin, von Jesse Vincent
Installationcodex plugin add superpowers@openai-curated oder /plugins in Codex
Codex nutzt ihnImmer, wenn es auf einen Bug, einen fehlschlagenden Test oder unerwartetes Verhalten stößt, bevor es eine Korrektur vorschlägt
Quelleopenai/plugins auf GitHub

Was der Skill macht

Die Kernregel des Skills lautet „no fixes without root cause investigation first“: keine Korrektur ohne vorherige Ursachenanalyse. Codex arbeitet vier Phasen ab und schließt jede ab, bevor die nächste beginnt:

  • Ursache: Fehlermeldung und Stack Trace vollständig lesen, den Bug reproduzieren, kürzliche Änderungen prüfen und in mehrteiligen Systemen protokollieren, was in jede Schicht hinein- und aus ihr herausgeht, um zu sehen, wo es bricht.
  • Muster: ähnlichen Code finden, der funktioniert, die Referenz vollständig lesen und jeden Unterschied auflisten.
  • Hypothese: eine Ursache samt Begründung benennen, sie mit der kleinstmöglichen Änderung testen und bei einem Fehlschlag eine neue Hypothese bilden, statt Korrekturen zu stapeln.
  • Umsetzung: einen fehlschlagenden Test schreiben, eine einzige Korrektur an der Quelle vornehmen und prüfen, dass nichts anderes kaputtgegangen ist.

Schlagen drei Korrekturen hintereinander fehl, weist der Skill Codex an, aufzuhören und mit dir die Architektur zu hinterfragen, bevor es einen vierten Versuch gibt. Außerdem listet er Gedanken auf, die eine Abkürzung verraten, etwa „just try changing X and see“.

Der Ordner enthält ergänzende Anleitungen dazu, einen Bug durch den Call Stack zurückzuverfolgen, Validierung auf mehreren Schichten einzubauen und feste Timeouts durch Polling auf Bedingungen zu ersetzen, dazu ein Skript find-polluter.sh, das per Bisektion findet, welcher Test unerwünschte Dateien hinterlässt.

Wann du ihn nutzt

Installiere ihn, wenn Codex dazu neigt, Symptome zu flicken, Korrekturen aufeinanderzustapeln oder sich bei einem Bug im Kreis zu drehen. Am nützlichsten ist er bei wackeligen Tests, fehlschlagenden Builds und Bugs, die mehrere Komponenten betreffen.

Ausprobieren

Einen fehlschlagenden Test richtig debuggen
Nutze den systematic-debugging-Skill. Der Checkout-Test schlägt seit dem gestrigen Merge in der CI fehl, läuft lokal aber durch. Finde die eigentliche Ursache, bevor du irgendetwas änderst.

Funktioniert er in Claude Code?

Ja. Das README von Superpowers führt Claude Code als unterstützten Agenten, installiert über den offiziellen Claude-Plugin-Marketplace. Nutze dieses Plugin, statt den Ordner zu kopieren, weil der Skill für testgetriebene Entwicklung und Verifikation auf andere Superpowers-Skills verweist.

Weiterlesen

Ein unabhängiges Plugin für Codex. Nicht mit OpenAI verbunden und nicht von OpenAI unterstützt.