Du verwandelst eine grobe Idee in eine wohlgeformte Aufgabe in der TODO.md. Die grobe Idee:
$ARGUMENTS
Dies ist ein Verfeinerungs-Workflow, keine Implementierung. Schreibe keinen Code. Schreibe nicht in die
TODO.md, bis die Aufgabe klar ist und der Benutzer sie genehmigt hat. Arbeite in diesen Schritten:
1. Lies die Verfassung
Finde die Verfassungsdateien des Projekts und lies sie – befolge ihre Konventionen, insbesondere die Risikostufen und alle Regeln zu autonomen Agenten / TODO-Lebenszyklus.
- Wenn
sprint.confexistiert, lies die inSPRINT_CONSTITUTION_FILESaufgeführten Dateien (in der angegebenen Reihenfolge). - Ansonsten lies die vorhandenen Dateien
AGENTS.mdundCLAUDE.md(sowie alle projektspezifischen Anleitungen, auf die sie verweisen, z. B. ein frontend-spezifischesCLAUDE.md). - Überfliege
.githooks/README.md, falls vorhanden, damit du den nachgelagerten Effekt korrekt beschreiben kannst. Wenn keine dieser Dateien existiert, teile dem Benutzer mit, dass das Repository noch nicht initialisiert ist, und biete/sprint:bootstrapan.
2. Verankere die Idee im echten Code (nicht raten)
Finde die tatsächlichen Symbole/Dateien, die von der Idee berührt werden, sowie ihren Einflussbereich:
- Code-Graph (bevorzugt, falls verfügbar): die Tools
mcp__codegraph__*(codegraph_search,…_callers,…_callees,…_impact,…_context) oder die CLI (codegraph context "<die Idee>",codegraph callers <symbol>,codegraph impact <symbol>); führe zuerstcodegraph sync .aus, wenn der Index veraltet erscheint. - Fallback (kein Code-Graph): Verwende Grep/Glob, um die relevanten Symbole und ihre Aufrufer zu finden. Lies die wenigen Dateien, die tatsächlich relevant sind. Nenne konkrete Funktionen/Dateien und wo die Änderung landet.
3. Hinterfrage sie (der Kern dieses Skills)
Stelle die Idee dem vorhandenen Code kritisch gegenüber. Bringe Folgendes ans Licht:
- Ist es eine Frage oder eine Aufgabe? Wenn es wirklich eine Frage ist („…oder übersehe ich etwas?“), beantworte sie zuerst anhand des Codes – die vorhandene Logik deckt möglicherweise bereits einen Teil davon ab.
- Der tatsächliche Umfang und die kleinste Änderung, die einen Mehrwert liefert.
- Die Risikostufe (gemäß der Verfassung /
AGENTS.md). Wenn sie hoch ist, sage das – sie wird nicht automatisch implementiert; die Kette delegiert sie an einen Menschen. - Die Entscheidungen, die der Benutzer treffen muss, nicht du (Produkt-/UX-/Richtlinienentscheidungen). Stelle dem Benutzer diese wenigen Entscheidungen mit AskUserQuestion. Erfinde keine Antworten auf echte Produktentscheidungen; korrigiere falsche Annahmen anhand von Beweisen aus dem Codebestand.
4. Entwirf EINEN strukturierten Eintrag (die vier Zutaten)
Schreibe einen Entwurf mit:
- einer klaren zwingenden Aufgabe (keine Frage),
- der Risikostufe,
- einem konkreten Erledigungskriterium (welcher gezielte Test muss grün sein / welches Verhalten ist überprüfbar),
- Datei-/Funktionshinweisen aus Schritt 2. Halte dich an die kleinste wertvolle Änderung. Zeige den Entwurf und verfeinere ihn, bis der Benutzer zufrieden ist.
5. Schreibe ihn in die TODO.md und übergib dann
- Füge den genehmigten Eintrag als
- [ ]-Eintrag in der Nähe des Anfangs derTODO.mdhinzu. - Frage, ob er zum einzigen aktiven Eintrag gemacht werden soll – wenn ja, verschiebe die anderen aktuell aktiven
Einträge in einen
<!-- … -->-Block (oder unter## 🚧 Zurückgestellt) gemäß der Überspring-Konvention, sodass die Kette nur diesen einen aufgreift. - Committe nicht automatisch. Sage dem Benutzer: Das Committen der
TODO.mdstartet die Plan→Implementieren→Überprüfen-Kette (die Implementierung landet auf dem impl-Branch, nichts wird automatisch gemergt). Biete an zu committen, wenn der Benutzer möchte, dass der Prozess jetzt beginnt.
Halte den Dialog knapp: Verankere zuerst, frage nur nach den Entscheidungen, die wichtig sind, und schreibe dann.