Benutzereingabe
$ARGUMENTS
Sie MÜSSEN die Benutzereingabe berücksichtigen, bevor Sie fortfahren (falls nicht leer).
Pre-Execution Checks
Auf Erweiterungs-Hooks prüfen (vor der Planung):
- Prüfen, ob
.specify/extensions.ymlim Projektstammverzeichnis existiert. - Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel
hooks.before_plan. - 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 (geben Sie den Parser-Fehler an) und dass keine Hooks überprü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 nicht,
condition-Ausdrücke von Hooks zu interpretieren oder auszuwerten:- Wenn der Hook kein
condition-Feld hat oder es 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 Auswertung der Bedingung der HookExecutor-Implementierung.
- Wenn der Hook kein
- Ersetzen Sie beim Erstellen 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} Prompt: {prompt} Zur Ausführung: `/{command}` - Obligatorischer Hook (
optional: false):
Nachdem Sie den obigen Block ausgegeben haben, MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Abschluss warten, bevor Sie fortfahren. Führen Sie ihn so aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (die Aufrufmethode kann von der oben gezeigten literal## Erweiterungs-Hooks **Automatischer Pre-Hook**: {extension} Ausführung: `/{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-Modus-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 stillschweigend.
Gliederung
-
Setup: Führen Sie
.specify/scripts/bash/setup-plan.sh --jsonvom Repository-Stammverzeichnis aus und parsen Sie JSON für FEATURE_SPEC, IMPL_PLAN, FEATURE_DIR, BRANCH. Verwenden Sie für einfache Anführungszeichen in Argumenten wie „I'm Groot“ Escape-Syntax: z.B. 'I'''m Groot' (oder falls möglich doppelte Anführungszeichen: "I'm Groot"). -
Kontext laden: Lesen Sie FEATURE_SPEC und
.specify/memory/constitution.md. Laden Sie die IMPL_PLAN-Vorlage (bereits kopiert). -
Plan-Workflow ausführen: Folgen Sie der Struktur in der IMPL_PLAN-Vorlage:
- Technischen Kontext ausfüllen (Unbekannte als „NEEDS CLARIFICATION“ markieren)
- Verfassungscheck-Abschnitt aus der Verfassung ausfüllen
- Tore bewerten (FEHLER bei ungerechtfertigten Verstößen)
- Phase 0: research.md generieren (alle NEEDS CLARIFICATION auflösen)
- Phase 1: data-model.md, contracts/, quickstart.md generieren
- Verfassungscheck nach dem Design erneut bewerten
Obligatorische Post-Execution Hooks
Sie MÜSSEN diesen Abschnitt abschließen, bevor Sie dem Benutzer den Abschluss melden.
Prüfen, ob .specify/extensions.yml im Projektstammverzeichnis existiert.
- Wenn es nicht existiert oder keine Hooks unter
hooks.after_planregistriert sind, überspringen Sie zum Abschlussbericht. - Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel
hooks.after_plan. - 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 (geben Sie den Parser-Fehler an) und dass keine Hooks überprü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 nicht,
condition-Ausdrücke von Hooks zu interpretieren oder auszuwerten:- Wenn der Hook kein
condition-Feld hat oder es 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 Auswertung der Bedingung der HookExecutor-Implementierung.
- Wenn der Hook kein
- Ersetzen Sie beim Erstellen 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ÜSSEN für jeden obligatorischen HookEXECUTE_COMMAND:ausgeben:
Nachdem Sie den obigen Block ausgegeben haben, MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Abschluss warten, bevor Sie fortfahren. Führen Sie ihn so aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (die Aufrufmethode kann von der oben gezeigten literal## Erweiterungs-Hooks **Automatischer Hook**: {extension} Ausführung: `/{command}` EXECUTE_COMMAND: {command}{command}-ID abweichen, z.B. führt ein Skills-Modus-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} Prompt: {prompt} Zur Ausführung: `/{command}`
- Obligatorischer Hook (
Abschlussbericht
Der Befehl endet nach dem Phase-1-Design. Berichten Sie den Branch, den IMPL_PLAN-Pfad und die generierten Artefakte.
Phasen
Phase 0: Gliederung & Recherche
-
Unbekannte aus dem technischen Kontext extrahieren (oben):
- Für jedes NEEDS CLARIFICATION → Rechercheaufgabe
- Für jede Abhängigkeit → Best-Practices-Aufgabe
- Für jede Integration → Musteraufgabe
-
Recherche-Agenten generieren und einsetzen:
Für jede Unbekannte im technischen Kontext: Aufgabe: „Recherchiere {unknown} für {feature Kontext}" Für jede Technologieentscheidung: Aufgabe: „Finde Best Practices für {tech} in {domain}" -
Ergebnisse konsolidieren in
research.mdmit folgendem Format:- Entscheidung: [was gewählt wurde]
- Begründung: [warum gewählt]
- Alternativen betrachtet: [was sonst noch bewertet wurde]
Ausgabe: research.md mit allen aufgelösten NEEDS CLARIFICATION
Phase 1: Design & Verträge
Voraussetzungen: research.md vollständig
-
Entitäten aus der Feature-Spezifikation extrahieren →
data-model.md:- Entitätsname, Felder, Beziehungen
- Validierungsregeln aus den Anforderungen
- Zustandsübergänge, falls zutreffend
-
Schnittstellenverträge definieren (falls das Projekt externe Schnittstellen hat) →
/contracts/:- Identifizieren Sie, welche Schnittstellen das Projekt Benutzern oder anderen Systemen bereitstellt
- Dokumentieren Sie das Vertragsformat, das für den Projekttyp geeignet ist
- Beispiele: öffentliche APIs für Bibliotheken, Befehls-Schemas für CLI-Tools, Endpunkte für Webdienste, Grammatiken für Parser, UI-Verträge für Anwendungen
- Überspringen Sie, wenn das Projekt rein intern ist (Build-Skripte, Einmal-Tools usw.)
-
Quickstart-Validierungsleitfaden erstellen →
quickstart.md:- Dokumentieren Sie ausführbare Validierungsszenarien, die belegen, dass die Funktion vollständig funktioniert
- Fügen Sie Voraussetzungen, Setup-Befehle, Test-/Ausführungsbefehle und erwartete Ergebnisse ein
- Verwenden Sie Links oder Verweise auf Verträge und Datenmodelldetails, anstatt sie zu duplizieren
- Fügen Sie keinen vollständigen Implementierungscode, keine Modell-/Service-/Controller-Körper, keine Migrationen oder vollständigen Testsuiten ein
- Halten Sie dieses Artefakt als Validierungs-/Ausführungsleitfaden; Implementierungsdetails gehören in
tasks.mdund die Implementierungsphase
Ausgabe: data-model.md, /contracts/*, quickstart.md
Wichtige Regeln
- Verwenden Sie absolute Pfade für Dateisystemoperationen; verwenden Sie projektrelative Pfade für Verweise in der Dokumentation
- FEHLER bei Torverletzungen oder ungelösten Klarstellungen
Erledigt, wenn
- Plan-Workflow ausgeführt und Design-Artefakte generiert
- Erweiterungs-Hooks gemäß den Regeln im Abschnitt „Obligatorische Post-Execution Hooks“ ausgeführt oder übersprungen
- Abschluss dem Benutzer mit Branch, Planpfad und generierten Artefakten gemeldet