Superkräfte

Superpowers ist ein Skill-Paket für Entwicklungsworkflows für KI-Coding-Tools. Es sorgt dafür, dass die KI Anforderungen klärt und Pläne erstellt, bevor sie Code schreibt, wodurch die Anzahl wiederholter Überarbeitungen reduziert wird.


Häufige Schwierigkeiten beim KI-gestützten Programmieren

Nachdem du die Anforderungen beschrieben hast, beginnt die KI sofort mit dem Schreiben von Code. Erst nachdem Hunderte Zeilen geschrieben wurden, merkst du, dass die Richtung nicht stimmt – Randfälle werden nicht behandelt, der Schnittstellenstil passt nicht und die zentrale Logik wurde missverstanden.

Dann korrigierst du hin und her und verbringst manchmal mehr Zeit mit Kurskorrekturen als mit dem anfänglichen Schreiben des Codes.

Schlimmer ist es bei komplexen Anforderungen mit mehreren Modulen und phasenweiser Umsetzung. Die KI driftet beim Schreiben allmählich vom Kurs ab, und wenn du es bemerkst, wurden bereits viele Dateien geändert, was ein Rollback mühsam macht.


Grundursache

Das Standardverhalten von KI-Programmierwerkzeugen nach Erhalt der Anforderungen ist es, direkt Code zu schreiben。

Bei einfachen Aufgaben ist das in Ordnung, aber bei etwas komplexeren Anforderungen überspringt „das direkte Schreiben“ einen entscheidenden Schritt:das vollständige Verständnis der Anforderungen。

Jede Unklarheit in den Anforderungen wird schließlich zu einem Problem im Code. Die KI stellt nicht proaktiv Fragen und hat auch keinen systematischen Implementierungsplan. Sie arbeitet einfach auf Basis ihres aktuellen Verständnisses weiter, und wenn sie vom Kurs abkommt, muss sie zurückkommen und Dinge korrigieren.

Wenn die KI vor dem Schreiben von Code zuerst Anforderungen klären, einen Implementierungsplan auflisten und Grenzen bestätigen könnte und dann endlich mit dem Programmieren beginnen würde, wäre der gesamte Prozess viel stabiler.


Was ist Superpowers?

Superpowers ist eine Sammlung vonEntwicklungs-Workflow-Skill-Paketen für KI-Programmierwerkzeuge.。

Es organisiert die Schlüsselphasen der Softwareentwicklung – Anforderungsklärung, Implementierungsplanung, testgetriebene Entwicklung, Code-Review und Branch-Management – in Skill-Dateien. Sobald sie in KI-Programmierwerkzeuge geladen sind, löst die KI automatisch den entsprechenden Workflow zum richtigen Zeitpunkt aus, ohne dass jedes Mal manuelle Prompts erforderlich sind.

In einem Satz:Installiere eine Entwicklungsmethodik in die KI, lass sie nach dem Prozess arbeiten, statt sofort mit dem Programmieren zu beginnen, sobald sie Anforderungen erhält.。

ProjektInformation
GitHub-Repositoryhttps://github.com/obra/superpowers
LizenzMIT
Unterstützte ToolsClaude Code、Cursor、Codex CLI、Codex App、Gemini CLI、GitHub Copilot CLI

Workflow-Überblick

Der Kernprozess von Superpowers ist in vier Phasen unterteilt. Jede Phase hat klare Ziele und Ergebnisse, und die KI überspringt keinen Schritt.

Superpowers 工作流程图

PhaseNameWas es tutAusgabe
1AnforderungsklärungDie KI stellt Rückfragen, klärt Unklarheiten und präsentiert Designpläne abschnittsweise zur Bestätigung.Bestätigtes Anforderungsdokument
2ImplementierungsplanungDie Arbeit in konkrete Aufgaben von jeweils 2-5 Minuten aufteilen. Jede Aufgabe enthält Dateien, Code und Verifikationsmethoden.Ausführbare Aufgabenliste
3Aufgaben ausführenAufgaben nacheinander ausführen. Nach jeder Aufgabe eine zweistufige Prüfung (Spezifikation + Qualität) durchführen.Verifizierter Code
4Code liefernBestätige, dass alle Aufgaben abgeschlossen sind und der Code den Designvorgaben und Qualitätsstandards entspricht.Zu liefernder Code

Installation

Verschiedene KI-Coding-Tools haben unterschiedliche Installationsmethoden. Wähle die Methode, die zu dem Tool passt, das du verwendest.

Claude Code (empfohlen)

Claude Code kann direkt aus dem offiziellen Plugin-Marktplatz installiert werden.

# 从官方插件市场安装(推荐)
/plugin install superpowers@claude-plugins-official

Es kann auch über den eigenen Marktplatz von Superpowers installiert werden.

# 添加 Superpowers 市场
/plugin marketplace add obra/superpowers-marketplace

# 从 Superpowers 市场安装
/plugin install superpowers@superpowers-marketplace

Cursor

Installiere durch Eingabe eines Befehls im Agent-Dialogfeld von Cursor.

# 在 Agent 对话框里输入
/add-plugin superpowers

Du kannst auch im Plugin-Marktplatz nachsuperpowerssuchen und installieren.

Codex CLI

# 打开插件管理界面
/plugins

# 搜索 superpowers,选择 Install Plugin

Gemini CLI

# 通过扩展安装
gemini extensions install https://github.com/obra/superpowers

Jedes Tool muss separat installiert werden. Wenn du es in Claude Code installierst, heißt das nicht, dass es auch in Cursor verfügbar ist.

ToolInstallationsmethodeOb ein zusätzlicher Marktplatz erforderlich ist
Claude Code/plugin installEs wird nur der offizielle Marktplatz benötigt, oder du kannst den Superpowers-Marktplatz verwenden
Cursor/add-pluginoder den Plugin-Marktplatz durchsuchenNicht erforderlich
Codex CLI/pluginsIn der Oberfläche suchen und installierenNicht erforderlich
Gemini CLIgemini extensions installNicht erforderlich

Erfahrung nach der Installation

Nach der Installation musst du keine neuen Befehle lernen oder deine Arbeitsgewohnheiten ändern. Beschreibe Anforderungen einfach wie gewohnt; Superpowers greift automatisch im Hintergrund ein.

Beim Starten eines neuen Features

Nachdem du die Anforderungen beschrieben hast, wird die KInichtsofort mit dem Schreiben von Code beginnen.

Sie wird dir zuerst ein paar Rückfragen stellen, Unklarheiten klären und den Designplan abschnittsweise zur Bestätigung vorlegen.

Diese Phase heißtBrainstorming; ihr Zweck ist es, die Anforderungen vor Beginn der Arbeit abzugleichen. Nachdem du bestätigt hast, geht die KI zum nächsten Schritt über.

Eintritt in die Implementierungsphase

Sobald die Anforderungen bestätigt sind, generiert die KI einen Implementierungsplan, der die Arbeit in konkrete Aufgaben von jeweils 2-5 Minuten aufteilt.

Jede Aufgabe umfasst: welche Dateien beteiligt sind, welcher Code geschrieben werden soll und wie überprüft wird.

Die Granularität des Plans wird detailliert genug sein, dass "ein Junior-Engineer ihn anhand der Beschreibung ausführen kann" -- dieses Design soll es Subagenten ermöglichen, jeden Schritt zuverlässig auszuführen und Verständnisabweichungen während der Ausführung zu reduzieren.

Ausführungsphase

Nachdem der Plan bestätigt wurde, führt die KI Aufgaben nacheinander aus.

Nach Abschluss jeder Aufgabe führt eszwei Prüfrunden durch: Zuerst wird geprüft, ob sie den Designspezifikationen entspricht, dann die Codequalität.

Wenn Probleme gefunden werden, werden sie innerhalb der aktuellen Aufgabe gelöst und nicht auf spätere Aufgaben übertragen.

Du musst nicht den gesamten Ausführungsprozess überwachen. Lass die KI einfach laufen. Wenn sie nicht weiterkommt, pausiert sie und kommt zu dir.

Installation überprüfen

Zum Beispiel geben wir in Claude Code ein:

Design an attractive mobile phone product promotional page.

Du wirst superpowers:brainstorming sehen, was bedeutet, dass die Installation erfolgreich war:

Ein typisches Anfängerszenario: Entwicklung einer Todo-App von Grund auf

Angenommen, wir möchten eine Todo-App implementieren, die CRUD unterstützt (React + Local Storage).

Traditioneller direkter Prompt-Ansatz:

用 React 帮我写一个 Todo App.

KI generiert normalerweise eine große Menge Code auf einmal. Oberflächlich betrachtet wirkt er funktionsvollständig, aber in Wirklichkeit können die folgenden Probleme bestehen:

  • Unsachgemäße Zustandsverwaltung
  • Fehlende Unit-Tests
  • Randfälle (z. B. leere Listen, gleichzeitige Operationen) werden nicht behandelt
  • Eine Änderung an einer Stelle kann leicht andere Fehler einführen
  • Das Ergebnis ist oft schwer zu wartender Code, mit hohen Iterationskosten später.

Der strukturierte Ansatz von Superpowers ist völlig anders. Er lässt die KI nicht sofort in die Codierungsphase eintreten, sondern geht mit den folgenden Schritten vor:


Detaillierte Erklärung der Kern-Workflows

Superpowers bietet drei Kern-Workflows, die jeweils einen anderen Teil der Entwicklung abdecken.

Testgetriebene Entwicklung (TDD)

test-driven-developmentDer Skill zwingt die KI, die RED-GREEN-REFACTOR-Sequenz zu befolgen.

Schreibe zuerst einen fehlschlagenden Test, beobachte, wie er fehlschlägt, schreibe dann den minimalen Code, damit er besteht, und refaktoriere schließlich.

Wenn KI Code schreibt, bevor sie Tests schreibt, verlangt dieser Skill, dass sie den Code löscht und von vorn beginnt.

SchrittNameWas es tut
REDSchreibe einen fehlschlagenden TestSchreibe zuerst einen Testfall, der derzeit fehlschlägt und das erwartete Verhalten klärt.
GREENSchreibe minimalen Code, um zu bestehenSchreibe nur den minimalen Code, damit der Test besteht, nichts weiter.
REFACTORIERENRefaktorisierenOptimiere die Codestruktur unter dem Schutz der Tests und stelle sicher, dass die Tests weiterhin bestehen.

Für Projekte, die nicht an TDD gewöhnt sind, kann sich dieser Prozess etwas unangenehm anfühlen, aber er reduziert Situationen, in denen Fehler später entdeckt werden und man zurückgehen und sie beheben muss.

Git-Worktree-Isolierung

using-git-worktreesNach der Design-Bestätigung automatisch einen isolierten Arbeitsbranch erstellen.

Auf diese Weise verschmutzen die Codeänderungen der KI nicht direkt den Main-Branch. Das ist nützlich für paralleles Multitasking oder wenn ein Rollback erforderlich ist.

Git Worktree ist eine native Git-Funktion, mit der Sie mehrere Branches gleichzeitig in verschiedene Verzeichnisse im selben Repository auschecken können, verglichen mitgit stash + git checkoutsauberer.

Systematisches Debugging

systematic-debuggingDer Skill bringt die KI dazu, bei Problemen einem 4-stufigen Fehlerbehebungsprozess zu folgen, anstatt zu raten.

Wenn ein Fehler auftritt, identifizieren Sie zuerst die Grundursache und beheben Sie sie dann, anstatt direkt mit der Änderung von Code zu beginnen und zu sehen, was passiert.

SchritteWas zu tun istWarum
1. Das Problem reproduzierenBestätigen Sie, dass es zuverlässig reproduziert werden kann, und protokollieren Sie die AuslösebedingungenEin Bug, der nicht reproduziert werden kann, kann nicht als behoben verifiziert werden
2. Die Grundursache identifizierenGrenzen Sie den Bereich Schritt für Schritt ein, um die spezifische Codezeile zu finden, die das Problem verursachtFixes, die nur Symptome behandeln, führen zu neuen Problemen
3. Die Fehlerbehebung implementierenDen Code basierend auf der Grundursache anpassenDen Umfang der Änderungen minimieren
4. Die Fehlerbehebung überprüfenBestätigen, dass das Problem behoben ist und keine neuen Probleme eingeführt werdenSicherstellen, dass die Fehlerbehebung wirksam ist

Ein paar Dinge, die Sie vor der Verwendung wissen sollten

Der Prozess wird länger

Nach der Installation von Superpowers durchlaufen selbst einfache Anforderungen eine Anforderungsanalyse und Planung, bevor Code geschrieben wird.

Wenn Sie nur einen kleinen Fehler beheben oder eine Zeile Konfiguration hinzufügen, kann dieser Prozess übertrieben erscheinen.

Superpowers eignet sich für die Feature-Entwicklung mit einem gewissen Grad an Komplexität. Bei einfachen Aufgaben lassen Sie die KI einfach den Code direkt schreiben – es ist nicht nötig, diesen gesamten Workflow anzuwenden.

Erfordert Ihre Teilnahme an frühen Diskussionen

BrainstormingDie Phase erfordert, dass du Fragen beantwortest und Pläne bestätigst.

Wenn du denkst: „Übergib es einfach der KI und lass es vollautomatisch laufen“, dann wird dir dieses Design Unbehagen bereiten.

Superpowers wird positioniert alskollaborative Entwicklung zwischen Menschen und KI, nicht als vollständig automatisierte Codegenerierung.

Die Erfahrung variiert je nach Tool

Die README erwähnt, dass Claude zwei Stunden lang laufen kann, ohne vom Plan abzuweichen, aber diese Leistung variiert je nach Tool, Projekt und Aufgabenkomplexität, sodass die tatsächliche Erfahrung abweichen kann.

Zu beachtende PunkteBeschreibungAnwendbare Szenarien
Längerer ProzessSelbst einfache Anforderungen durchlaufen vor der Implementierung eine AnalyseFeature-Entwicklung mittlerer oder höherer Komplexität
Erfordert die Teilnahme an DiskussionenDie Brainstorming-Phase erfordert, dass du den Plan bestätigstEntwickler, die bereit sind, vorab Zeit für die Abstimmung zu investieren
ErfahrungsunterschiedeDie Performance variiert je nach Tool und Projekt.Alle Nutzer müssen sich dessen bewusst sein.
Weitere Erweiterungen