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-Name | systematic-debugging |
| Enthalten in | Dem Superpowers-Plugin, von Jesse Vincent |
| Installation | codex plugin add superpowers@openai-curated oder /plugins in Codex |
| Codex nutzt ihn | Immer, wenn es auf einen Bug, einen fehlschlagenden Test oder unerwartetes Verhalten stößt, bevor es eine Korrektur vorschlägt |
| Quelle | openai/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
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
- Codex-Plugins vs. SkillsWas ein Skill ist, was ein Plugin zusätzlich bündelt und wann du was verwendest.
- Codex-Skills: installieren, nutzen und selbst schreibenWo Skills liegen, wie du sie installierst und wie du selbst einen schreibst.
- Alle Codex-SkillsJeder Skill im Verzeichnis, gruppiert nach Einsatzzweck.