Benutzereingabe
$ARGUMENTS
Sie MÜSSEN die Benutzereingabe berücksichtigen, bevor Sie fortfahren (falls nicht leer).
Prüfungen vor der Ausführung
Prüfung auf Erweiterungs-Hooks (vor der Konvergenz):
-
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_converge. -
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 (fügen Sie den Parser-Fehler hinzu) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten, verpflichtenden (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 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}` -
Verpflichtender Hook (
optional: false):## Erweiterungs-Hooks **Automatischer Pre-Hook**: {extension} Ausführung: `/{command}` EXECUTE_COMMAND: {command} Warten Sie auf das Ergebnis des Hook-Befehls, bevor Sie mit dem Ziel fortfahren.Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Abschluss warten, bevor Sie fortfahren. Führen Sie ihn auf die gleiche Weise aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten literarischen
{command}-ID abweichen, z. B. führt ein Skill-Modus-Agent ihn als/skill:speckit-...oder$speckit-...aus). Das bloße Ausgeben des Blocks führt den Hook nicht aus.
-
-
Wenn keine Hooks registriert sind oder
.specify/extensions.ymlnicht existiert, überspringen Sie dies stillschweigend.
Ziel
Schließen Sie die Lücke zwischen dem, was die Spezifikation, der Plan und die Aufgaben eines Features vorgeben, und dem, was der Codebestand derzeit implementiert. Lesen Sie spec.md, plan.md und tasks.md als die einzige Quelle der Absicht (mit der Verfassung als übergeordneten Richtlinien), bewerten Sie den aktuellen Zustand des Codes, bestimmen Sie, welche Anforderungen, Akzeptanzkriterien, Planentscheidungen und vorhandenen Aufgaben nicht erfüllt, unvollständig oder nur teilweise erfüllt sind, und hängen Sie jedes verbleibende Arbeitspaket als neue, nachvollziehbare Aufgabe am Ende von tasks.md an, damit /speckit-implement es abschließen kann. Dieser Befehl MUSS nur ausgeführt werden, nachdem /speckit-implement auf der aktuellen tasks.md ausgeführt wurde und nachdem /speckit-tasks eine vollständige tasks.md erstellt hat.
Dies ist kein Diff-Tool und verfolgt keine Änderungen. Es bewertet den aktuellen Zustand des Codes in Bezug auf die Artefakte des Features – kein Git, kein Branch-Vergleich, keine Historie.
Betriebsbeschränkungen
NUR ANHÄNGEN, NIEMALS ÜBERSCHREIBEN: Der einzige Schreibvorgang des Befehls ist das Anhängen eines neuen Abschnitts ## Phase N: Konvergenz an tasks.md. Er MUSS NICHT:
spec.mdoderplan.mdin irgendeiner Weise ändern;- vorhandene Aufgaben (einschließlich Aufgaben aus einer vorherigen Konvergenzphase) umschreiben, umnummerieren, neu anordnen oder löschen;
- Anwendungscode ändern, erstellen oder löschen – das Vervollständigen der angehängten Aufgaben ist die Aufgabe von
/speckit-implement.
Wenn der Codebestand bereits alles erfüllt, MUSS der Befehl tasks.md byteweise unverändert lassen (keinen leeren Konvergenz-Header) und ein sauberes Ergebnis melden.
Autorität der Verfassung: Die Projektverfassung (.specify/memory/constitution.md) ist nicht verhandelbar. Code, der gegen ein MUSS-Prinzip verstößt, ist der schwerwiegendste Befund und erzeugt eine entsprechende Behebungsaufgabe. Wenn die Verfassung eine unausgefüllte Vorlage ist, überspringen Sie die Verfassungsprüfungen elegant, anstatt zu scheitern.
Ausführungsschritte
1. Konvergenzkontext initialisieren
Führen Sie .specify/scripts/bash/check-prerequisites.sh --json --require-spec --require-tasks --include-tasks einmal vom Repository-Stamm aus und parsen Sie JSON nach FEATURE_DIR und AVAILABLE_DOCS. Leiten Sie absolute Pfade ab:
- SPEC = FEATURE_DIR/spec.md
- PLAN = FEATURE_DIR/plan.md
- TASKS = FEATURE_DIR/tasks.md
- CONSTITUTION =
.specify/memory/constitution.md(falls vorhanden) Wennspec.md,plan.mdodertasks.mdfehlt, STOPPEN Sie mit einer klaren, umsetzbaren Nachricht, die den auszuführenden erforderlichen Befehl nennt (/speckit-specifyfür eine fehlende Spezifikation,/speckit-planfür einen fehlenden Plan,/speckit-tasksfür fehlende Aufgaben). Erzeugen Sie keine partielle Ausgabe. Verwenden Sie für einfache Anführungszeichen in Argumenten wie „I'm Groot“ die Escape-Syntax: z. B. 'I'''m Groot' (oder doppelte Anführungszeichen, wenn möglich: "I'm Groot").
2. Artefakte laden (Progressive Offenlegung)
Laden Sie nur den minimal notwendigen Kontext aus jedem Artefakt:
Aus spec.md:
- Funktionale Anforderungen (FR-###)
- Erfolgskriterien (SC-###) – nur Elemente einschließen, die baubare Arbeit erfordern; Post-Launch-Ergebnis-Metriken und Geschäfts-KPIs ausschließen
- User Stories und deren Akzeptanzszenarien
- Randfälle (falls vorhanden)
Aus plan.md:
- Architektur-/Stack-Entscheidungen und technische Entscheidungen
- Referenzen auf Datenmodelle
- Phasen und benannte Berührungspunkte (Dateien/Komponenten, die der Plan erstellt oder bearbeitet)
- Technische Einschränkungen
Aus tasks.md:
- Aufgaben-IDs (um die nächste ID und nächste Phasennummer zu berechnen)
- Beschreibungen, Phasengruppierung und referenzierte Dateipfade
Aus der Verfassung (falls keine unausgefüllte Vorlage):
- Prinzipnamen und MUSS/SOLLTE normative Aussagen
3. Das Absichtsinventar erstellen
Erstellen Sie ein internes Modell (geben Sie keine Roh-Artefakte aus):
- Anforderungsinventar: ein stabiler Schlüssel pro FR-### / SC-### / Akzeptanzszenario einer User Story (z. B.
US1/AC2), plus die Planentscheidungen und Verfassungsprinzipien, die baubare Verpflichtungen auferlegen. - Code-Umfangskarte: Leiten Sie aus den in
plan.mdundtasks.mdgenannten Dateipfaden sowie einer Schlüsselwortsuche nach den Konzepten, die jede Anforderung beschreibt, die Menge der zu bewertenden Quelldateien und Komponenten ab. Begrenzen Sie die Bewertung auf diese – schließen Sie nicht auf einen Umfang, der über die von den Artefakten definierten hinausgeht.
4. Den Codebestand bewerten und Befunde klassifizieren
Beziehen Sie jede vorhandene Aufgabe in das Absichtsinventar ein, unabhängig vom Kontrollkästchenstatus oder der Konvergenzphase: Abschlussbehauptungen sind keine Nachweise. Überprüfen Sie das aktuelle Verhalten anhand von Spezifikation, Plan, Aufgaben und Verfassung; bewerten Sie bei korrigierenden Aufgabenketten das resultierende Verhalten, nicht die ersetzten Implementierungsdetails. Prüfen Sie sowohl nicht erfüllte Verpflichtungen als auch Implementierungen, die der erklärten Absicht widersprechen, über sie hinausgehen oder außerhalb von ihr liegen.
Erzeugen Sie für jedes Element im Absichtsinventar einen Befund nur dort, wo eine Lücke besteht. Klassifizieren Sie jeden Befund nach Lückentyp:
fehlend: Die erforderliche Arbeit fehlt vollständig im Code.teilweise: Die Arbeit existiert, erfüllt aber die Anforderung / das Akzeptanzkriterium / die Planentscheidung noch nicht vollständig.widerspricht: Der Code tut etwas, das der erklärten Absicht oder einem MUSS-Prinzip der Verfassung widerspricht.nicht angefordert: Der Code enthält Arbeit, die nicht in Spezifikation, Plan oder Aufgaben gefordert wird (zur Kenntnisnahme – Konvergenz löscht keinen Code, sie hängt nur eine Aufgabe an, um dies zu überprüfen/zu rechtfertigen oder zu entfernen).
Jeder Befund enthält: eine stabile ID, den source-ref, auf den er zurückgeht, den gap-type, einen Schweregrad und eine kurze, menschenlesbare Beschreibung mit dem Nachweis (die beobachtete Datei/der beobachtete Bereich).
Randfälle:
- Wenig oder noch kein Code: Behandeln Sie den gesamten spezifizierten Umfang als
fehlendeverbleibende Arbeit, anstatt zu scheitern. - Nichts bleibt übrig: Erzeugen Sie null Befunde und folgen Sie dem konvergierten Zweig in Schritt 7.
5. Schweregrad zuweisen
- KRITISCH: Verstößt gegen ein MUSS-Prinzip der Verfassung, oder eine
fehlende/widersprechendeLücke, die die Basisfunktionalität einer P1-User-Story blockiert. - HOCH: Eine
fehlendeoderteilweiseLücke bei einer Kernfunktionsanforderung oder einem Akzeptanzkriterium. - MITTEL: Eine
teilweiseLücke bei einer sekundären Anforderung, oder einenicht angeforderteErgänzung ohne klare Rechtfertigung. - NIEDRIG: Geringfügige partielle Lücken, Verbesserungen oder
nicht angeforderteErgänzungen mit geringem Risiko.
6. Die Sitzungszusammenfassung der Befunde präsentieren
Geben Sie vor dem Anhängen von etwas eine kompakte, nach Schweregrad gestaffelte Zusammenfassung aus (noch keine Dateischreibvorgänge):
Konvergenzbefunde
| ID | Lückentyp | Schweregrad | Quelle | Nachweis | Verbleibende Arbeit |
|---|---|---|---|---|---|
| F1 | fehlend | HOCH | FR-008 | Beispiel: Kein Append-Only-Schutz in path/to/module.py beim Schreiben von tasks.md erkannt | Append-Only-Durchsetzung hinzufügen |
Zusammenfassungsmetriken:
- Geprüfte Anforderungen / Akzeptanzkriterien
- Geprüfte Planentscheidungen
- Geprüfte Verfassungsprinzipien (oder „übersprungen – Vorlage“)
- Befunde nach Lückentyp (fehlend / teilweise / widerspricht / nicht angefordert)
- Befunde nach Schweregrad
7. Konvergenzaufgaben anhängen (oder Konvergenz melden)
Wenn ein oder mehrere umsetzbare Befunde vorliegen (tasks_appended-Ergebnis):
Hängen Sie gemäß dem Anhängevertrag an das Ende von tasks.md an:
-
Scannen Sie alle vorhandenen Aufgaben-IDs; sei
Mdas Maximum. Bestimmen Sie die nächste PhasennummerN(höchste vorhandene Phase + 1). -
Schreiben Sie einen einzelnen neuen Abschnitts-Header
## Phase N: Konvergenz. -
Geben Sie ein Kontrollkästchen-Element pro umsetzbarem Befund aus, geordnet nach KRITISCH/HOCH zuerst, mit nullaufgefüllten IDs
T{M+1:03d}, T{M+2:03d}, …:- [ ] T042 <imperative Beschreibung> gemäß <source-ref> (<Lückentyp>)<source-ref>führt die Aufgabe auf ihren Ursprung zurück: z. B.FR-003,SC-002,US1/AC2,plan: storage decision,Verfassung II.<Lückentyp>ist einer vonfehlend,teilweise,widerspricht,nicht angefordert.Aufgaben, die gegen die Verfassung verstoßen, MÜSSEN zuerst ausgegeben und als
KRITISCHbeschrieben werden. -
Verwenden Sie niemals vorhandene IDs wieder oder nummerieren Sie sie um. Wenn eine vorherige Konvergenzphase existiert, fügen Sie eine neue, separat nummerierte darunter ein – berühren Sie nicht die alte.
Wenn keine umsetzbaren Befunde vorliegen (konvergiert-Ergebnis):
- Ändern Sie
tasks.mdüberhaupt nicht – keinen leeren Phasen-Header. - Melden Sie: „✅ Konvergiert – die Implementierung erfüllt Spezifikation, Plan und Aufgaben.“
- Fügen Sie die zusammenfassenden Zählungen dessen hinzu, was geprüft wurde.
8. Nächste Schritte bereitstellen (Übergabe)
- Bei
tasks_appended: Geben Sie an, wie viele Aufgaben unter welcher Phase angehängt wurden, und empfehlen Sie,/speckit-implementauszuführen, um sie zu vervollständigen; weisen Sie darauf hin, dass ein nachfolgender Konvergenzlauf weniger oder keine verbleibenden Elemente finden wird. - Bei
konvergiert: Empfehlen Sie, zur Überprüfung / zum Öffnen eines PR überzugehen. Für den spezifizierten Umfang dieses Features ist kein weiterer Implementierungsdurchlauf erforderlich.
9. Prüfung auf Erweiterungs-Hooks
Nachdem Sie das Ergebnis erstellt haben, prüfen Sie, ob .specify/extensions.yml im Projektstammverzeichnis existiert.
-
Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel
hooks.after_converge. -
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 (fügen Sie den Parser-Fehler hinzu) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten, verpflichtenden (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
-
Melden Sie das Konvergenzergebnis (
konvergiertodertasks_appended) in der Sitzung, bevor Sie Hooks auflisten, damit Benutzer entscheiden können, ob sie optionale Folgebefehle ausführen möchten. -
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 Hook**: {extension} Befehl: `/{command}` Beschreibung: {description} Prompt: {prompt} Zur Ausführung: `/{command}` -
Verpflichtender Hook (
optional: false):## Erweiterungs-Hooks **Automatischer Hook**: {extension} Ausführung: `/{command}` EXECUTE_COMMAND: {command}Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Abschluss warten, bevor Sie fortfahren. Führen Sie ihn auf die gleiche Weise aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten literarischen
{command}-ID abweichen, z. B. führt ein Skill-Modus-Agent ihn als/skill:speckit-...oder$speckit-...aus). Das bloße Ausgeben des Blocks führt den Hook nicht aus.
-
-
Wenn keine Hooks registriert sind oder
.specify/extensions.ymlnicht existiert, überspringen Sie dies stillschweigend.