Benutzereingabe
$ARGUMENTS
Sie MÜSSEN die Benutzereingabe berücksichtigen, bevor Sie fortfahren (falls nicht leer).
Scope Guard
Die eigene Arbeit dieses Befehls ist auf die Aktualisierung der Projektverfassung selbst beschränkt. Abhängige Vorlagen und Befehle lesen die Verfassung zur Laufzeit und werden hier nicht geändert.
- Klassifizieren Sie jeden Teil der Benutzereingabe entweder als Verfassungsinhalt oder als separate Absicht außerhalb der Governance.
- Wenn die Eingabe Feature-Implementierung, Codegenerierung, Refactoring, Build- oder Bereitstellungsanfragen enthält, dürfen Sie diese NICHT ausführen. Extrahieren Sie sie stattdessen als zurückgestellte Absichten.
- Sie DÜRFEN KEINE Anwendungsquelldateien, Feature-Routen, Komponenten, Tests, Bereitstellungsdateien oder andere Artefakte erstellen, ändern oder löschen, die nicht mit dem Verfassungs-Workflow zusammenhängen.
- Wenn unklar ist, ob eine Anweisung Verfassungsinhalt ist, fragen Sie nach, bevor Sie Änderungen vornehmen.
- Fügen Sie nach Abschluss der Verfassungsaktualisierung einen Abschnitt
Nächste Schrittefür jede zurückgestellte Absicht ein. Listen Sie die ursprüngliche Absicht auf und schlagen Sie den entsprechenden Befehl aus dem Spec Kit vor, wie z. B./speckit-specify, ohne ihn auszuführen. - Wenn es keine absichten außerhalb der Governance gibt, lassen Sie den Abschnitt
Nächste Schritteweg.
Vorab-Prüfungen
Auf Erweiterungs-Hooks prüfen (vor Verfassungsaktualisierung):
- 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_constitution - Wenn das YAML nicht geparst werden kann oder ungültig ist, überspringen Sie dies nicht stillschweigend: Teilen Sie dem Benutzer mit, dass
.specify/extensions.ymlnicht gelesen werden konnte (geben Sie den Parser-Fehler an), dass keine Hooks geprüft wurden, einschließlich aller dort registrierten obligatorischen (optional: false) Hooks, und fahren Sie dann normal fort. - Filtern Sie Hooks heraus, bei denen
enabledexplizit auffalsegesetzt ist. Behandeln Sie Hooks ohneenabled-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 (-). Zum 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):
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 genauso 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, stillschweigend überspringen.
Gliederung
Sie aktualisieren die Projektverfassung unter .specify/memory/constitution.md. Das aktive
Verfassungsgerüst wird zur Befehlszeit aus der constitution-template über den Spec Kit
Preset/Template-Auflösungsstapel aufgelöst.
Befolgen Sie diesen Ausführungsablauf:
-
Führen Sie
.specify/scripts/bash/resolve-template.sh constitution-template --jsonvom Repository-Stammverzeichnis aus und parsen SieTEMPLATE_CONTENTals die aktive Vorlage.- Der gemeinsame Resolver wendet Projekt-Overrides an, setzt Preset-Ebenen und Erweiterungsebenen zusammen, bevor auf die Kernvorlage zurückgegriffen wird. Es MUSS erfolgreich sein, bevor fortgefahren wird.
- Wenn es fehlschlägt, stoppen Sie und melden Sie den Auflösungsfehler; fahren Sie nicht mit nur einer beitragenden Vorlagenebene fort.
- Wenn
.specify/memory/constitution.mdexistiert, laden Sie es als Quelle für aktuelle projektspezifische Werte und Änderungen. Bewahren Sie Informationen, die noch anwendbar sind, wenn Sie das neu aufgelöste Gerüst anwenden. - Wenn es nicht existiert, verwenden Sie die aufgelöste Vorlage als Anfangsdokument.
- Schreiben Sie nicht zurück in eine versionierte Vorlagenebene.
- Identifizieren Sie jeden Platzhalter-Token der Form
[ALL_CAPS_IDENTIFIER]. WICHTIG: Der Benutzer benötigt möglicherweise weniger oder mehr Prinzipien als die in der Vorlage verwendeten. Wenn eine Zahl angegeben ist, respektieren Sie diese – folgen Sie der allgemeinen Vorlage. Sie werden das Dokument entsprechend aktualisieren.
-
Sammeln/ableiten von Werten für Platzhalter:
- Wenn die Benutzereingabe (Konversation) einen Wert liefert, verwenden Sie ihn.
- Andernfalls schließen Sie aus dem vorhandenen Repository-Kontext (README, Dokumente, frühere Verfassungsversionen, falls eingebettet).
- Für Governance-Daten:
RATIFICATION_DATEist das ursprüngliche Annahmedatum (falls unbekannt, fragen Sie nach oder setzen Sie TODO),LAST_AMENDED_DATEist heute, wenn Änderungen vorgenommen werden, andernfalls behalten Sie das vorherige bei. CONSTITUTION_VERSIONmuss gemäß den semantischen Versionierungsregeln erhöht werden:- MAJOR: Nicht abwärtskompatible Governance-/Prinzip-Entfernungen oder -Neudefinitionen.
- MINOR: Neues Prinzip/neuer Abschnitt hinzugefügt oder wesentlich erweiterte Anleitung.
- PATCH: Klarstellungen, Formulierungen, Tippfehlerkorrekturen, nicht-semantische Verfeinerungen.
- Wenn der Version-Bump-Typ mehrdeutig ist, schlagen Sie eine Begründung vor, bevor Sie endgültig entscheiden.
-
Entwerfen Sie den aktualisierten Verfassungsinhalt unter Verwendung der aufgelösten Vorlage als erforderliche Struktur:
- Ersetzen Sie jeden Platzhalter durch konkreten Text (keine eingeklammerten Tokens mehr, außer absichtlich beibehaltene Vorlagen-Slots, die das Projekt noch nicht definieren möchte – begründen Sie explizit, welche übrig bleiben).
- Behalten Sie die Überschriftenhierarchie bei; Kommentare können entfernt werden, sobald sie ersetzt sind, es sei denn, sie bieten noch klärende Anleitung.
- Stellen Sie sicher, dass jeder Prinzipienabschnitt enthält: prägnante Namenszeile, Absatz (oder Aufzählungsliste) mit nicht verhandelbaren Regeln, explizite Begründung, falls nicht offensichtlich.
- Stellen Sie sicher, dass der Governance-Abschnitt das Änderungsverfahren, die Versionierungsrichtlinie und die Erwartungen an die Compliance-Überprüfung auflistet.
-
Erstellen Sie einen Sync-Impact-Report als HTML-Kommentar am Anfang der Verfassungsdatei nach der Aktualisierung. Dieser Bericht ist temporäres Arbeitsmaterial für die menschliche Überprüfung der Änderung, kein Governance-Inhalt; es wird erwartet, dass er entfernt wird, bevor die geänderte Verfassungsdatei committet wird.
- Versionsänderung: alt → neu
- Liste der geänderten Prinzipien (alter Titel → neuer Titel, falls umbenannt)
- Hinzugefügte Abschnitte
- Entfernte Abschnitte
- Folge-TODOs, falls Platzhalter absichtlich zurückgestellt wurden.
-
Validierung vor der endgültigen Ausgabe:
- Keine verbleibenden unerklärten Klammer-Tokens.
- Versionszeile stimmt mit dem Bericht überein.
- Daten im ISO-Format YYYY-MM-DD.
- Prinzipien sind deklarativ, testbar und frei von vager Sprache („sollte“ durch MUSS/SOLLTE-Begründung ersetzen, wo angemessen).
-
Schreiben Sie die abgeschlossene Verfassung zurück nach
.specify/memory/constitution.md(überschreiben). -
Geben Sie eine abschließende Zusammenfassung für den Benutzer aus mit:
- Neuer Version und Bump-Begründung.
- Allen TODO-Platzhaltern oder zurückgestellten Elementen, die manuelle Nachverfolgung erfordern.
- Vorgeschlagener Commit-Nachricht (z. B.
docs: Verfassung auf vX.Y.Z ändern (Prinzip-Ergänzungen + Governance-Update)). - Einem Abschnitt
Nächste Schrittefür alle zurückgestellten Nicht-Governance-Absichten.
Formatierungs- & Stil-Anforderungen:
- Verwenden Sie Markdown-Überschriften genau wie in der Vorlage (keine Herauf-/Herabstufung der Ebenen).
- Brechen Sie lange Begründungszeilen um, um die Lesbarkeit zu erhalten (idealerweise <100 Zeichen), erzwingen Sie dies aber nicht mit unbeholfenen Umbrüchen.
- Halten Sie eine einzelne Leerzeile zwischen Abschnitten ein.
- Vermeiden Sie nachgestellte Leerzeichen.
Wenn der Benutzer Teilaktualisierungen liefert (z. B. nur eine Prinzipienrevision), führen Sie trotzdem Validierungs- und Versionierungsentscheidungsschritte durch.
Wenn kritische Informationen fehlen (z. B. Ratifikationsdatum wirklich unbekannt), fügen Sie TODO(<FIELD_NAME>): Erklärung ein und nehmen Sie es in den Sync-Impact-Report unter zurückgestellte Elemente auf.
Schreiben Sie nur .specify/memory/constitution.md; erstellen oder ändern Sie keine Vorlagenquelldateien.
Nach Abschluss Prüfungen
Auf Erweiterungs-Hooks prüfen (nach Verfassungsaktualisierung):
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_constitution - Wenn das YAML nicht geparst werden kann oder ungültig ist, überspringen Sie dies nicht stillschweigend: Teilen Sie dem Benutzer mit, dass
.specify/extensions.ymlnicht gelesen werden konnte (geben Sie den Parser-Fehler an), dass keine Hooks geprüft wurden, einschließlich aller dort registrierten obligatorischen (optional: false) Hooks, und fahren Sie dann normal fort. - Filtern Sie Hooks heraus, bei denen
enabledexplizit auffalsegesetzt ist. Behandeln Sie Hooks ohneenabled-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 (-). Zum 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}` - Obligatorischer Hook (
optional: false):
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 genauso 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 (
- Wenn keine Hooks registriert sind oder
.specify/extensions.ymlnicht existiert, stillschweigend überspringen.