Benutzereingabe
$ARGUMENTS
Sie MÜSSEN die Benutzereingabe vor dem Fortfahren berücksichtigen (falls nicht leer).
Vorausführungsprüfungen
Prüfung auf Erweiterungs-Hooks (vor der Spezifikation):
- Prüfen Sie, ob
.specify/extensions.ymlim Projektstammverzeichnis existiert. - Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel
hooks.before_specify. - Wenn das YAML nicht analysiert 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, und 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 Folgendes basierend auf seinem
optional-Flag 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):
Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf sein Ende warten, bevor Sie fortfahren. Führen Sie ihn so aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten wörtlichen## 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-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
Der Text, den der Benutzer nach /speckit-specify in der auslösenden Nachricht eingegeben hat, ist die Funktionsbeschreibung. Gehen Sie davon aus, dass Sie ihn in dieser Konversation immer verfügbar haben, auch wenn $ARGUMENTS unten wörtlich erscheint. Fordern Sie den Benutzer nicht auf, ihn zu wiederholen, es sei denn, er hat einen leeren Befehl angegeben.
Gegeben diese Funktionsbeschreibung, führen Sie Folgendes durch:
-
Generieren Sie einen prägnanten Kurznamen (2-4 Wörter) für die Funktion:
- Analysieren Sie die Funktionsbeschreibung und extrahieren Sie die aussagekräftigsten Schlüsselwörter.
- Erstellen Sie einen 2-4 Wörter langen Kurznamen, der das Wesen der Funktion erfasst.
- Verwenden Sie nach Möglichkeit das Format Aktion-Nomen (z.B. "add-user-auth", "fix-payment-bug").
- Behalten Sie technische Begriffe und Akronyme bei (OAuth2, API, JWT usw.).
- Halten Sie ihn prägnant, aber beschreibend genug, um die Funktion auf einen Blick zu verstehen.
- Beispiele:
- "Ich möchte Benutzerauthentifizierung hinzufügen" → "benutzer-auth"
- "OAuth2-Integration für die API implementieren" → "oauth2-api-integration"
- "Ein Dashboard für Analysen erstellen" → "analysen-dashboard"
- "Fehler bei Zahlungsverarbeitungs-Timeout beheben" → "behebe-zahlungs-timeout"
-
Branch-Erstellung (optional, über Hook):
Wenn in den Vorausführungsprüfungen oben ein
before_specify-Hook erfolgreich ausgeführt wurde, hat er einen Git-Branch erstellt/gewechselt und JSON mitBRANCH_NAMEundFEATURE_NUMausgegeben. Notieren Sie sich diese Werte als Referenz, aber der Branch-Name bestimmt nicht den Verzeichnisnamen der Spezifikation.Wenn der Benutzer explizit
GIT_BRANCH_NAMEangegeben hat, übergeben Sie es an den Hook, damit das Branch-Skript den genauen Wert als Branchnamen verwendet (unter Umgehung aller Präfix-/Suffix-Generierung). -
Erstellen Sie das Funktionsspezifikationsverzeichnis:
Spezifikationen befinden sich standardmäßig im Verzeichnis
specs/, es sei denn, der Benutzer gibt explizitSPECIFY_FEATURE_DIRECTORYan.Auflösungsreihenfolge für
SPECIFY_FEATURE_DIRECTORY:- Wenn der Benutzer explizit
SPECIFY_FEATURE_DIRECTORYangegeben hat (z.B. über Umgebungsvariable, Argument oder Konfiguration), verwenden Sie es unverändert. - Andernfalls generieren Sie es automatisch unter
specs/:- Überprüfen Sie
.specify/init-options.jsonauffeature_numbering(bevorzugt) oderbranch_numbering(veraltet, nur Migration – wird in einer zukünftigen Version entfernt). - Wenn
"timestamp": Präfix istYYYYMMDD-HHMMSS(aktueller Zeitstempel). - Wenn
"sequential"oder nicht vorhanden: Präfix istNNN(nächste verfügbare 3-stellige Nummer nach Scannen vorhandener Verzeichnisse inspecs/). - Konstruieren Sie den Verzeichnisnamen:
<präfix>-<kurzname>(z.B.003-benutzer-authoder20260319-143022-benutzer-auth). - Setzen Sie
SPECIFY_FEATURE_DIRECTORYaufspecs/<verzeichnisname>. - Wenn
branch_numberingverwendet wurde (undfeature_numberingnicht vorhanden war), geben Sie eine einzeilige Warnung aus: "⚠️branch_numberingin init-options.json ist veraltet. Benennen Sie es infeature_numberingum."
- Überprüfen Sie
Erstellen Sie das Verzeichnis und die Spezifikationsdatei:
mkdir -p SPECIFY_FEATURE_DIRECTORY- Lösen Sie die aktive
spec-templateüber den SpecKit-Präset-/Vorlagenauflösungsstapel auf (entsprichtspecify preset resolve spec-template). - Kopieren Sie die aufgelöste
spec-template-Datei als Ausgangspunkt nachSPECIFY_FEATURE_DIRECTORY/spec.md. - Setzen Sie
SPEC_FILEaufSPECIFY_FEATURE_DIRECTORY/spec.md. - Persistieren Sie den aufgelösten Pfad in
.specify/feature.json:Schreiben Sie den tatsächlichen aufgelösten Verzeichnispfadwert (z.B.{ "feature_directory": "<aufgelöstes funkionsverzeichnis>" }specs/003-benutzer-auth), nicht den wörtlichen StringSPECIFY_FEATURE_DIRECTORY. Dies ermöglicht es nachgelagerten Befehlen (/speckit-plan,/speckit-tasksusw.), das Funktionsverzeichnis zu finden, ohne sich auf Git-Branch-Namenskonventionen stützen zu müssen.
WICHTIG:
- Sie dürfen nur eine Funktion pro
/speckit-specify-Aufruf erstellen. - Der Spezifikationsverzeichnisname und der Git-Branch-Name sind unabhängig – sie können gleich sein, aber dies ist die Wahl des Benutzers.
- Das Spezifikationsverzeichnis und die Datei werden immer von diesem Befehl erstellt, niemals vom Hook.
- Wenn der Benutzer explizit
-
Laden Sie die aktive aufgelöste
spec-template-Datei, um die erforderlichen Abschnitte zu verstehen. -
WENN VORHANDEN: Laden Sie
.specify/memory/constitution.mdfür Projektprinzipien und Governance-Einschränkungen. -
Befolgen Sie diesen Ausführungsablauf:
- Parsen Sie die Benutzerbeschreibung aus den Argumenten. Wenn leer: FEHLER "Keine Funktionsbeschreibung bereitgestellt".
- Extrahieren Sie Schlüsselkonzepte aus der Beschreibung. Identifizieren Sie: Akteure, Aktionen, Daten, Einschränkungen.
- Bei unklaren Aspekten:
- Treffen Sie fundierte Annahmen basierend auf Kontext und Branchenstandards.
- Markieren Sie nur mit [NEEDS CLARIFICATION: spezifische Frage], wenn:
- Die Wahl den Umfang oder die Benutzererfahrung der Funktion erheblich beeinflusst.
- Mehrere vernünftige Interpretationen mit unterschiedlichen Auswirkungen existieren.
- Kein vernünftiger Standardwert existiert.
- BEGRENZUNG: Maximal 3 [NEEDS CLARIFICATION]-Marker insgesamt.
- Priorisieren Sie Klarstellungen nach Auswirkung: Umfang > Sicherheit/Datenschutz > Benutzererfahrung > technische Details.
- Füllen Sie den Abschnitt "Benutzerszenarien und Tests" aus. Wenn kein klarer Benutzerablauf: FEHLER "Benutzerszenarien können nicht bestimmt werden".
- Generieren Sie funktionale Anforderungen. Jede Anforderung muss testbar sein. Verwenden Sie vernünftige Standardwerte für nicht spezifizierte Details (dokumentieren Sie Annahmen im Abschnitt "Annahmen").
- Definieren Sie Erfolgskriterien. Erstellen Sie messbare, technologieunabhängige Ergebnisse. Enthalten Sie sowohl quantitative Metriken (Zeit, Leistung, Volumen) als auch qualitative Maße (Benutzerzufriedenheit, Aufgabenerfüllung). Jedes Kriterium muss ohne Implementierungsdetails überprüfbar sein.
- Identifizieren Sie Schlüsselentitäten (falls Daten betroffen sind).
- Rückgabe: ERFOLG (Spezifikation bereit zur Planung).
-
Schreiben Sie die Spezifikation in die Datei SPEC_FILE unter Verwendung der Vorlagenstruktur, ersetzen Sie Platzhalter mit konkreten Details aus der Funktionsbeschreibung (Argumenten), während Sie die Abschnittsreihenfolge und Überschriften beibehalten.
-
Qualitätsvalidierung der Spezifikation: Nach dem Schreiben der ersten Spezifikation validieren Sie sie anhand von Qualitätskriterien:
a. Erstellen Sie eine Spezifikations-Qualitätscheckliste: Generieren Sie eine Checklistendatei unter
SPECIFY_FEATURE_DIRECTORY/checklists/requirements.mdunter Verwendung der Checklistenvorlagenstruktur mit diesen Validierungselementen:# Spezifikations-Qualitätscheckliste: [FUNKTIONSNAME] **Zweck**: Validierung der Spezifikationsvollständigkeit und -qualität vor dem Fortfahren mit der Planung **Erstellt**: [DATUM] **Funktion**: [Link zu spec.md] ## Inhaltsqualität - [ ] Keine Implementierungsdetails (Sprachen, Frameworks, APIs) - [ ] Fokussiert auf Benutzerwert und Geschäftsanforderungen - [ ] Für nicht-technische Stakeholder geschrieben - [ ] Alle obligatorischen Abschnitte abgeschlossen ## Vollständigkeit der Anforderungen - [ ] Keine [NEEDS CLARIFICATION]-Marker mehr vorhanden - [ ] Anforderungen sind testbar und eindeutig - [ ] Erfolgskriterien sind messbar - [ ] Erfolgskriterien sind technologieunabhängig (keine Implementierungsdetails) - [ ] Alle Akzeptanzszenarien sind definiert - [ ] Grenzfälle sind identifiziert - [ ] Umfang ist klar abgegrenzt - [ ] Abhängigkeiten und Annahmen identifiziert ## Funktionsbereitschaft - [ ] Alle funktionalen Anforderungen haben klare Akzeptanzkriterien - [ ] Benutzerszenarien decken primäre Abläufe ab - [ ] Funktion erfüllt messbare Ergebnisse, die in den Erfolgskriterien definiert sind - [ ] Keine Implementierungsdetails in die Spezifikation eingeflossen ## Hinweise - Als unvollständig markierte Elemente erfordern Spezifikationsaktualisierungen vor `/speckit-clarify` oder `/speckit-plan`b. Führen Sie einen Validierungscheck durch: Überprüfen Sie die Spezifikation anhand jedes Checklistenelements:
- Bestimmen Sie für jedes Element, ob es bestanden oder nicht bestanden wird.
- Dokumentieren Sie spezifische gefundene Probleme (zitieren Sie relevante Spezifikationsabschnitte).
c. Behandlung der Validierungsergebnisse:
-
Wenn alle Elemente bestanden sind: Markieren Sie die Checkliste als abgeschlossen und fahren Sie mit dem Abschnitt "Obligatorische Post-Execution-Hooks" fort.
-
Wenn Elemente nicht bestanden werden (außer [NEEDS CLARIFICATION]):
- Listen Sie die nicht bestandenen Elemente und spezifischen Probleme auf.
- Aktualisieren Sie die Spezifikation, um jedes Problem zu beheben.
- Führen Sie die Validierung erneut durch, bis alle Elemente bestanden sind (maximal 3 Iterationen).
- Wenn nach 3 Iterationen immer noch nicht bestanden, dokumentieren Sie die verbleibenden Probleme in den Checklistenhinweisen und warnen Sie den Benutzer.
-
Wenn [NEEDS CLARIFICATION]-Marker verbleiben:
-
Extrahieren Sie alle [NEEDS CLARIFICATION: ...]-Marker aus der Spezifikation.
-
BEGRENZUNGSPRÜFUNG: Wenn mehr als 3 Marker vorhanden sind, behalten Sie nur die 3 kritischsten (nach Umfang/Sicherheit/Benutzererfahrungsauswirkung) und treffen Sie fundierte Annahmen für die restlichen.
-
Präsentieren Sie für jede benötigte Klarstellung (maximal 3) dem Benutzer Optionen in diesem Format:
## Frage [N]: [Thema] **Kontext**: [Zitieren Sie den relevanten Spezifikationsabschnitt] **Was wir wissen müssen**: [Spezifische Frage aus dem NEEDS CLARIFICATION-Marker] **Vorgeschlagene Antworten**: | Option | Antwort | Auswirkungen | |--------|---------|------------| | A | [Erste vorgeschlagene Antwort] | [Was dies für die Funktion bedeutet] | | B | [Zweite vorgeschlagene Antwort] | [Was dies für die Funktion bedeutet] | | C | [Dritte vorgeschlagene Antwort] | [Was dies für die Funktion bedeutet] | | Eigen | Geben Sie Ihre eigene Antwort an | [Erklären Sie, wie benutzerdefinierte Eingaben bereitgestellt werden] | **Ihre Wahl**: _[Warten auf Benutzerantwort]_ -
KRITISCH - Tabellenformatierung: Stellen Sie sicher, dass Markdown-Tabellen korrekt formatiert sind:
- Verwenden Sie konsistente Leerzeichen mit ausgerichteten Rohren.
- Jede Zelle sollte Leerzeichen um den Inhalt haben:
| Inhalt |nicht|Inhalt|. - Der Kopfzeilentrenner muss mindestens 3 Bindestriche haben:
|--------|. - Testen Sie, ob die Tabelle in der Markdown-Vorschau korrekt gerendert wird.
-
Nummerieren Sie die Fragen fortlaufend (F1, F2, F3 - maximal 3 insgesamt).
-
Präsentieren Sie alle Fragen zusammen, bevor Sie auf Antworten warten.
-
Warten Sie, bis der Benutzer mit seinen Entscheidungen für alle Fragen antwortet (z.B. "F1: A, F2: Eigen - [Details], F3: B").
-
Aktualisieren Sie die Spezifikation, indem Sie jeden [NEEDS CLARIFICATION]-Marker durch die vom Benutzer ausgewählte oder bereitgestellte Antwort ersetzen.
-
Führen Sie die Validierung erneut durch, nachdem alle Klarstellungen gelöst sind.
-
d. Aktualisieren Sie die Checkliste: Aktualisieren Sie nach jeder Validierungsiteration die Checklistendatei mit dem aktuellen Bestanden/Nicht-Bestanden-Status.
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 Projektstammverzeichnis existiert.
- Wenn es nicht existiert oder keine Hooks unter
hooks.after_specifyregistriert 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_specify. - Wenn das YAML nicht analysiert 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, und 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 Folgendes basierend auf seinem
optional-Flag 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 sein Ende warten, bevor Sie fortfahren. Führen Sie ihn so aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten wörtlichen## Erweiterungs-Hooks **Automatischer Hook**: {extension} Ausführung: `/{command}` EXECUTE_COMMAND: {command} Warten Sie auf das Ergebnis des Hook-Befehls, bevor Sie mit dem Abschlussbericht 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 (
optional: true):## Erweiterungs-Hooks **Optionaler Post-Hook**: {extension} Befehl: `/{command}` Beschreibung: {description} Prompt: {prompt} Zur Ausführung: `/{command}`
- Obligatorischer Hook (
Abschlussbericht
Wenn Sie die Ausführung abgeschlossen haben, fassen Sie dem Benutzer die Ergebnisse mit dem folgenden strukturierten Format zusammen:
## Spezifikation: [FUNKTIONSNAME]
**Spezifikationsdatei**: `SPEC_FILE`
**Feature-Verzeichnis**: `SPECIFY_FEATURE_DIRECTORY`
**Erfolgskriterien**:
- [Zusammenfassung der wichtigsten Erfolgskriterien]
**Ausstehende Klarstellungen**:
- [Anzahl] Fragen zur Klärung (maximal 3)
**Nächste Schritte**:
1. Überprüfen Sie die Spezifikation in `SPEC_FILE`
2. Führen Sie `/speckit-plan` aus, um die Planung zu starten
3. Bei ausstehenden Klarstellungen: Beantworten Sie die Fragen oben