Benutzereingabe
$ARGUMENTS
Sie MÜSSEN die Benutzereingabe berücksichtigen, bevor Sie fortfahren (falls nicht leer).
Vorab-Prüfungen
Prüfung auf Erweiterungs-Hooks (vor der Aufgabengenerierung):
- Prüfen Sie, ob
.specify/extensions.ymlim Projektstamm existiert. - Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel
hooks.before_tasks. - Wenn das YAML nicht geparst werden kann oder ungültig ist, überspringen Sie es nicht stillschweigend: Teilen Sie dem Benutzer mit, dass
.specify/extensions.ymlnicht gelesen werden konnte (inklusive des Parser-Fehlers) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten obligatorischen (optional: false) Hooks. Fahren Sie dann normal fort. - Filtern Sie Hooks heraus, bei denen
enabledexplizitfalseist. Behandeln Sie Hooks ohne einenabled-Feld als standardmäßig aktiviert. - Versuchen Sie für jeden verbleibenden Hook nicht, Hook-
condition-Ausdrücke zu interpretieren oder auszuwerten:- Wenn der Hook kein
condition-Feld hat oder dieses null/leer ist, behandeln Sie den Hook als ausführbar. - Wenn der Hook eine nicht-leere
conditiondefiniert, überspringen Sie den Hook und überlassen Sie die Bedingungsauswertung der HookExecutor-Implementierung.
- Wenn der Hook kein
- Ersetzen Sie bei der Erstellung von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (
.) durch Bindestriche (-). Beispiel:speckit.git.commit→/speckit-git-commit. - Geben Sie für jeden ausführbaren Hook basierend auf seinem
optional-Flag Folgendes aus:- Optionaler Hook (
optional: true):## Erweiterungs-Hooks **Optionaler Pre-Hook**: {extension} Befehl: `/{command}` Beschreibung: {description} Eingabeaufforderung: {prompt} Zur Ausführung: `/{command}` - Obligatorischer Hook (
optional: false):
Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Beendigung warten, bevor Sie fortfahren. Führen Sie ihn auf dieselbe Weise aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten literalen## Erweiterungs-Hooks **Automatischer Pre-Hook**: {extension} Ausführen: `/{command}` EXECUTE_COMMAND: {command} Warten Sie auf das Ergebnis des Hook-Befehls, bevor Sie mit der Gliederung fortfahren.{command}-ID abweichen, z. B. führt ein Skills-Mode-Agent ihn als/skill:speckit-...oder$speckit-...aus). Das bloße Ausgeben des Blocks führt den Hook nicht aus.
- Optionaler Hook (
- Wenn keine Hooks registriert sind oder
.specify/extensions.ymlnicht existiert, überspringen Sie dies stillschweigend.
Gliederung
-
Einrichtung: Führen Sie
.specify/scripts/bash/setup-tasks.sh --jsonvom Repository-Stamm aus aus und parsen Sie FEATURE_DIR, TASKS_TEMPLATE_CONTENT, TASKS_TEMPLATE und die Liste AVAILABLE_DOCS.FEATURE_DIRundTASKS_TEMPLATEmüssen absolute Pfade sein, wenn sie angegeben werden.AVAILABLE_DOCSist eine Liste von Dokumentnamen/relativen Pfaden, die unterFEATURE_DIRverfügbar sind (z. B.research.mdodercontracts/). Für einfache Anführungszeichen in Argumenten wie "I'm Groot" verwenden Sie die Escape-Syntax: z. B. 'I'''m Groot' (oder doppelte Anführungszeichen, wenn möglich: "I'm Groot"). -
Design-Dokumente laden: Lesen Sie aus FEATURE_DIR:
- Erforderlich: plan.md (Tech-Stack, Bibliotheken, Struktur), spec.md (User Stories mit Prioritäten)
- Optional: data-model.md (Entitäten), contracts/ (Schnittstellenverträge), research.md (Entscheidungen), quickstart.md (Testszenarien)
- FALLS VORHANDEN: Laden Sie
.specify/memory/constitution.mdfür Projektprinzipien und Governance-Einschränkungen. - Hinweis: Nicht alle Projekte haben alle Dokumente. Generieren Sie Aufgaben basierend auf dem, was verfügbar ist.
-
Aufgabengenerierungs-Workflow ausführen:
- Laden Sie plan.md und extrahieren Sie Tech-Stack, Bibliotheken, Projektstruktur.
- Laden Sie spec.md und extrahieren Sie User Stories mit ihren Prioritäten (P1, P2, P3, usw.)
- Wenn data-model.md existiert: Extrahieren Sie Entitäten und ordnen Sie sie User Stories zu.
- Wenn contracts/ existiert: Ordnen Sie Schnittstellenverträge User Stories zu.
- Wenn research.md existiert: Extrahieren Sie Entscheidungen für Einrichtungsaufgaben.
- Generieren Sie Aufgaben, organisiert nach User Story (siehe Aufgabengenerierungs-Regeln unten).
- Generieren Sie einen Abhängigkeitsgraphen, der die Reihenfolge der User-Story-Abschlüsse anzeigt.
- Erstellen Sie Beispiele für parallele Ausführung pro User Story.
- Validieren Sie die Vollständigkeit der Aufgaben (jede User Story hat alle benötigten Aufgaben, unabhängig testbar).
-
tasks.md generieren: Verwenden Sie TASKS_TEMPLATE_CONTENT (aus der obigen JSON-Ausgabe) als Struktur. Aus Kompatibilitätsgründen mit älteren Setup-Skripten, die TASKS_TEMPLATE_CONTENT auslassen, lesen Sie stattdessen TASKS_TEMPLATE. Füllen Sie mit:
- Korrekter Funktionsname aus plan.md.
- Phase 1: Einrichtungsaufgaben (Projektinitialisierung).
- Phase 2: Grundlegende Aufgaben (blockierende Voraussetzungen für alle User Stories).
- Phase 3+: Eine Phase pro User Story (in Prioritätsreihenfolge aus spec.md).
- Jede Phase umfasst: Story-Ziel, unabhängige Testkriterien, Tests (falls angefordert), Implementierungsaufgaben.
- Abschlussphase: Polieren & übergreifende Belange.
- Alle Aufgaben MÜSSEN dem strengen Checklistenformat folgen (siehe Aufgabengenerierungs-Regeln unten).
- Klare Dateipfade für jede Aufgabe.
- Abschnitt "Abhängigkeiten", der die Reihenfolge der Story-Abschlüsse anzeigt.
- Beispiele für parallele Ausführung pro Story.
- Abschnitt zur Implementierungsstrategie (MVP zuerst, inkrementelle Auslieferung).
Obligatorische Post-Execution-Hooks
Sie MÜSSEN diesen Abschnitt abschließen, bevor Sie dem Benutzer den Abschluss melden.
Prüfen Sie, ob .specify/extensions.yml im Projektstamm existiert.
- Wenn es nicht existiert oder keine Hooks unter dem Schlüssel
hooks.after_tasksregistriert sind, fahren Sie mit dem Abschlussbericht fort. - Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel
hooks.after_tasks. - Wenn das YAML nicht geparst werden kann oder ungültig ist, überspringen Sie es nicht stillschweigend: Teilen Sie dem Benutzer mit, dass
.specify/extensions.ymlnicht gelesen werden konnte (inklusive des Parser-Fehlers) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten obligatorischen (optional: false) Hooks. Fahren Sie dann mit dem Abschlussbericht fort. - Filtern Sie Hooks heraus, bei denen
enabledexplizitfalseist. Behandeln Sie Hooks ohne einenabled-Feld als standardmäßig aktiviert. - Versuchen Sie für jeden verbleibenden Hook nicht, Hook-
condition-Ausdrücke zu interpretieren oder auszuwerten:- Wenn der Hook kein
condition-Feld hat oder dieses null/leer ist, behandeln Sie den Hook als ausführbar. - Wenn der Hook eine nicht-leere
conditiondefiniert, überspringen Sie den Hook und überlassen Sie die Bedingungsauswertung der HookExecutor-Implementierung.
- Wenn der Hook kein
- Ersetzen Sie bei der Erstellung von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (
.) durch Bindestriche (-). Beispiel:speckit.git.commit→/speckit-git-commit. - Geben Sie für jeden ausführbaren Hook basierend auf seinem
optional-Flag Folgendes aus:- Obligatorischer Hook (
optional: false) — Sie MÜSSENEXECUTE_COMMAND:für jeden obligatorischen Hook ausgeben:
Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Beendigung warten, bevor Sie fortfahren. Führen Sie ihn auf dieselbe Weise aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten literalen## Erweiterungs-Hooks **Automatischer Hook**: {extension} Ausführen: `/{command}` EXECUTE_COMMAND: {command}{command}-ID abweichen, z. B. führt ein Skills-Mode-Agent ihn als/skill:speckit-...oder$speckit-...aus). Das bloße Ausgeben des Blocks führt den Hook nicht aus. - Optionaler Hook (
optional: true):## Erweiterungs-Hooks **Optionaler Hook**: {extension} Befehl: `/{command}` Beschreibung: {description} Eingabeaufforderung: {prompt} Zur Ausführung: `/{command}`
- Obligatorischer Hook (
Abschlussbericht
Geben Sie den Pfad zur generierten tasks.md und eine Zusammenfassung aus:
- Gesamtanzahl der Aufgaben
- Aufgabenanzahl pro User Story
- Identifizierte Parallelisierungsmöglichkeiten
- Unabhängige Testkriterien für jede Story
- Vorgeschlagener MVP-Umfang (typischerweise nur User Story 1)
- Formatvalidierung: Bestätigen Sie, dass ALLE Aufgaben dem Checklistenformat folgen (Checkbox, ID, Labels, Dateipfade)
Kontext für die Aufgabengenerierung: $ARGUMENTS
Die tasks.md sollte sofort ausführbar sein - jede Aufgabe muss spezifisch genug sein, dass ein LLM sie ohne zusätzlichen Kontext abschließen kann.
Aufgabengenerierungs-Regeln
KRITISCH: Aufgaben MÜSSEN nach User Story organisiert sein, um unabhängige Implementierung und Tests zu ermöglichen.
Tests sind OPTIONAL: Generieren Sie Testaufgaben nur, wenn dies in der Funktionsspezifikation explizit angefordert wird oder der Benutzer einen TDD-Ansatz wünscht.
Checklistenformat (ERFORDERLICH)
Jede Aufgabe MUSS strikt diesem Format folgen:
- [ ] [Aufgaben-ID] [P?] [Story?] Beschreibung mit Dateipfad
Formatkomponenten:
- Checkbox: BEGINNEN SIE IMMER mit
- [ ](Markdown-Checkbox) - Aufgaben-ID: Fortlaufende Nummer (T001, T002, T003...) in Ausführungsreihenfolge
- [P] Marker: Nur einfügen, wenn die Aufgabe parallelisierbar ist (unterschiedliche Dateien, keine Abhängigkeiten von unvollständigen Aufgaben)
- [Story] Label: ERFORDERLICH nur für Aufgaben in User-Story-Phasen
- Format: [US1], [US2], [US3], usw. (entspricht User Stories aus spec.md)
- Einrichtungsphase: KEIN Story-Label
- Grundlagenphase: KEIN Story-Label
- User-Story-Phasen: MÜSSEN Story-Label haben
- Abschlussphase: KEIN Story-Label
- Beschreibung: Klare Aktion mit exaktem Dateipfad
Beispiele:
- ✅ RICHTIG:
- [ ] T001 Projektstruktur gemäß Implementierungsplan erstellen - ✅ RICHTIG:
- [ ] T005 [P] Authentifizierungs-Middleware in src/middleware/auth.py implementieren - ✅ RICHTIG:
- [ ] T012 [P] [US1] Benutzermodell in src/models/user.py erstellen - ✅ RICHTIG:
- [ ] T014 [US1] UserService in src/services/user_service.py implementieren - ❌ FALSCH:
- [ ] Benutzermodell erstellen(fehlende ID und Story-Label) - ❌ FALSCH:
T001 [US1] Modell erstellen(fehlende Checkbox) - ❌ FALSCH:
- [ ] [US1] Benutzermodell erstellen(fehlende Aufgaben-ID) - ❌ FALSCH:
- [ ] T001 [US1] Modell erstellen(fehlender Dateipfad)
Aufgabenorganisation
-
Aus User Stories (spec.md) - PRIMÄRE ORGANISATION:
- Jede User Story (P1, P2, P3...) erhält eine eigene Phase.
- Ordnen Sie alle zugehörigen Komponenten ihrer Story zu:
- Modelle, die für diese Story benötigt werden
- Dienste, die für diese Story benötigt werden
- Schnittstellen/UI, die für diese Story benötigt werden
- Wenn Tests angefordert: Tests, die für diese Story spezifisch sind
- Markieren Sie Story-Abhängigkeiten (die meisten Stories sollten unabhängig sein).
-
Aus Verträgen:
- Ordnen Sie jeden Schnittstellenvertrag → der User Story zu, die er bedient.
- Wenn Tests angefordert: Jeder Schnittstellenvertrag → Vertragstestaufgabe [P] vor der Implementierung in der Phase dieser Story.
-
Aus Datenmodell:
- Ordnen Sie jede Entität der/den User Story(s) zu, die sie benötigt.
- Wenn eine Entität mehrere Stories bedient: Platzieren Sie sie in der frühesten Story oder in der Einrichtungsphase.
- Beziehungen → Aufgaben auf Dienstebene in der entsprechenden Story-Phase.
- Zitieren Sie für jedes Feld mit Einschränkungen in data-model.md (max_length, nullable/required, Enum-Werte, Validierungsregeln) die Einschränkung wörtlich in der Aufgabenbeschreibung, damit sie nicht dem Ermessen zur Implementierungszeit überlassen bleibt.
-
Aus Einrichtung/Infrastruktur:
- Gemeinsame Infrastruktur → Einrichtungsphase (Phase 1)
- Grundlegende/blockierende Aufgaben → Grundlagenphase (Phase 2)
- Story-spezifische Einrichtung → innerhalb der Phase dieser Story.
Phasenstruktur
- Phase 1: Einrichtung (Projektinitialisierung)
- Phase 2: Grundlagen (blockierende Voraussetzungen - MÜSSEN vor User Stories abgeschlossen sein)
- Phase 3+: User Stories in Prioritätsreihenfolge (P1, P2, P3...)
- Innerhalb jeder Story: Tests (falls angefordert) → Modelle → Dienste → Endpunkte → Integration
- Jede Phase sollte ein vollständiges, unabhängig testbares Inkrement sein.
- Abschlussphase: Polieren & übergreifende Belange
Erledigt, wenn
- tasks.md mit allen Phasen, Aufgaben-IDs und Dateipfaden generiert
- Erweiterungs-Hooks gemäß den Regeln unter "Obligatorische Post-Execution-Hooks" ausgelöst oder übersprungen
- Abschlussbericht an den Benutzer mit Aufgabenanzahl, Story-Aufschlüsselung und MVP-Umfang