Benutzereingabe
$ARGUMENTS
Du MUSST die Benutzereingabe berücksichtigen, bevor du fortfährst (falls nicht leer).
Ausführungsvorprüfungen
Erweiterungshooks prüfen (vor der Analyse):
- Prüfe, ob
.specify/extensions.ymlim Projektstammverzeichnis existiert. - Falls ja, lies es und suche nach Einträgen unter dem Schlüssel
hooks.before_analyze. - Falls das YAML nicht geparst werden kann oder ungültig ist, überspringe es nicht stillschweigend: teile dem Benutzer mit, dass
.specify/extensions.ymlnicht gelesen werden konnte (füge den Parser-Fehler hinzu) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten zwingend erforderlichen (optional: false) Hooks. Fahre dann normal fort. - Filtere Hooks heraus, bei denen
enabledexplizitfalseist. Behandle Hooks ohneenabled-Feld als standardmäßig aktiviert. - Versuche für jeden verbleibenden Hook nicht,
condition-Ausdrücke zu interpretieren oder auszuwerten:- Wenn der Hook kein
condition-Feld hat oder dieses null/leer ist, behandle den Hook als ausführbar. - Wenn der Hook eine nicht-leere
conditiondefiniert, überspringe den Hook und überlasse die Bedingungsauswertung der HookExecutor-Implementierung.
- Wenn der Hook kein
- Ersetze beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (
.) durch Bindestriche (-). Beispiel:speckit.git.commit→/speckit-git-commit. - Gib für jeden ausführbaren Hook basierend auf seinem
optional-Flag Folgendes aus:- Optionaler Hook (
optional: true):## Erweiterungshooks **Optionaler Vor-Hook**: {extension} Befehl: `/{command}` Beschreibung: {description} Aufforderung: {prompt} Ausführung: `/{command}` - Zwingend erforderlicher Hook (
optional: false):
Nach dem Ausgeben des obigen Blocks MUSST du den Hook tatsächlich aufrufen und auf sein Ende warten, bevor du fortfährst. Führe ihn so aus, wie du den Befehl selbst in diesem Agenten/Session ausführen würdest (der Aufruf kann von der obigen literarischen## Erweiterungshooks **Automatischer Vor-Hook**: {extension} Ausführung: `/{command}` EXECUTE_COMMAND: {command} Warte auf das Ergebnis des Hook-Befehls, bevor du mit dem Ziel fortfährst.{command}-ID abweichen, z.B. führt ein Skills-Modus-Agent ihn als/skill:speckit-...oder$speckit-...aus). Allein das Ausgeben des Blocks führt den Hook nicht aus.
- Optionaler Hook (
- Wenn keine Hooks registriert sind oder
.specify/extensions.ymlnicht existiert, überspringe stillschweigend.
Ziel
Identifiziere Inkonsistenzen, Duplikate, Ambiguitäten und unter-/nicht spezifizierte Punkte in den drei Kernartefakten (spec.md, plan.md, tasks.md) vor der Implementierung. Dieser Befehl darf NUR ausgeführt werden, nachdem /speckit-tasks erfolgreich eine vollständige tasks.md erstellt hat.
Betriebliche Einschränkungen
STRENG SCHREIBGESCHÜTZT: Ändere keine Dateien. Gib einen strukturierten Analysebericht aus. Biete optional einen Korrekturplan an (der Benutzer muss explizit zustimmen, bevor manuell Nachbearbeitungsbefehle ausgeführt werden).
Verfassungsautorität: Die Projektverfassung (.specify/memory/constitution.md) ist nicht verhandelbar innerhalb dieses Analyseumfangs. Verfassungskonflikte sind automatisch KRITISCH und erfordern eine Anpassung der Spezifikation, des Plans oder der Aufgaben – nicht die Verwässerung, Neuinterpretation oder stillschweigende Ignorierung des Prinzips. Wenn ein Prinzip selbst geändert werden muss, muss dies in einer separaten, expliziten Verfassungsaktualisierung außerhalb von /speckit-analyze erfolgen.
Ausführungsschritte
1. Analysekontext initialisieren
Führe .specify/scripts/bash/check-prerequisites.sh --json --require-spec --require-tasks --include-tasks einmal vom Repository-Stammverzeichnis aus und parse das JSON für FEATURE_DIR und AVAILABLE_DOCS. Leite absolute Pfade ab:
- SPEC = FEATURE_DIR/spec.md
- PLAN = FEATURE_DIR/plan.md
- TASKS = FEATURE_DIR/tasks.md
Breche mit einer Fehlermeldung ab, wenn eine erforderliche Datei fehlt (weise den Benutzer an, den fehlenden Voraussetzungsbefehl auszuführen).
Für einfache Anführungszeichen in Argumenten wie „I'm Groot“ verwende die Escape-Syntax: z.B. 'I'\''m Groot' (oder doppelte Anführungszeichen, wenn möglich: "I'm Groot").
2. Artefakte laden (schrittweise Offenlegung)
Lade nur den minimal notwendigen Kontext aus jedem Artefakt:
Aus spec.md:
- Überblick/Kontext
- Funktionale Anforderungen
- Erfolgskriterien (messbare Ergebnisse – z.B. Leistung, Sicherheit, Verfügbarkeit, Benutzererfolg, geschäftliche Auswirkungen)
- User Stories
- Randfälle (falls vorhanden)
Aus plan.md:
- Architektur-/Technologieentscheidungen
- Datenmodellverweise
- Phasen
- Technische Einschränkungen
Aus tasks.md:
- Aufgaben-IDs
- Beschreibungen
- Phasenzuordnung
- Parallelitätsmarkierungen [P]
- Referenzierte Dateipfade
Aus der Verfassung:
- Lade
.specify/memory/constitution.mdzur Prinzipienvalidierung
3. Semantische Modelle erstellen
Erstelle interne Repräsentationen (füge rohe Artefakte nicht in die Ausgabe ein):
- Anforderungsinventar: Für jede funktionale Anforderung (FR-###) und jedes Erfolgskriterium (SC-###) einen stabilen Schlüssel notieren. Verwende die explizite FR-/SC-Kennung als Primärschlüssel, sofern vorhanden, und leite optional einen imperativ-phrasierten Slug für die Lesbarkeit ab (z.B. „Benutzer kann Datei hochladen“ →
benutzer-kann-datei-hochladen). Nimm nur Erfolgskriterien auf, die baubare Arbeit erfordern (z.B. Auslastungstest-Infrastruktur, Sicherheitsaudit-Tooling), und schließe Metriken nach dem Start und Geschäfts-KPIs aus (z.B. „Support-Tickets um 50 % reduzieren“). - User-Story-/Aktionsinventar: Diskrete Benutzeraktionen mit Abnahmekriterien.
- Aufgabenabdeckungszuordnung: Ordne jede Aufgabe einer oder mehreren Anforderungen oder Stories zu (Schlussfolgerung durch Schlüsselwörter / explizite Referenzmuster wie IDs oder Schlüsselphrasen).
- Verfassungsregelsatz: Extrahiere Prinzipiennamen und normative MUST/SHOULD-Aussagen.
4. Erkennungsdurchläufe (token-effiziente Analyse)
Konzentriere dich auf signifikante Erkenntnisse. Begrenze die Gesamtzahl auf 50 Erkenntnisse; fasse den Rest in einer Überlaufzusammenfassung zusammen.
A. Duplikaterkennung
- Identifiziere nahezu identische Anforderungen.
- Markiere minderwertigere Formulierungen zur Konsolidierung.
B. Ambiguitätserkennung
- Markiere vage Adjektive (schnell, skalierbar, sicher, intuitiv, robust) ohne messbare Kriterien.
- Markiere ungelöste Platzhalter (TODO, TKTK, ???,
<placeholder>usw.).
C. Unterspezifikation
- Anforderungen mit Verben, aber fehlendem Objekt oder messbarem Ergebnis.
- User Stories ohne Abnahmekriterien.
- Aufgaben, die auf Dateien oder Komponenten verweisen, die in der Spezifikation/im Plan nicht definiert sind.
D. Verfassungskonformität
- Jede Anforderung oder jedes Planelement, das mit einem MUST-Prinzip in Konflikt steht.
- Fehlende vorgeschriebene Abschnitte oder Qualitätstore aus der Verfassung.
E. Abdeckungslücken
- Anforderungen ohne zugeordnete Aufgaben.
- Aufgaben ohne zugeordnete Anforderung/Story.
- Erfolgskriterien, die baubare Arbeit erfordern (Leistung, Sicherheit, Verfügbarkeit), die nicht in Aufgaben widergespiegelt werden.
F. Inkonsistenz
- Terminologieabweichung (gleiches Konzept in verschiedenen Dateien unterschiedlich benannt).
- Datenentitäten, die im Plan referenziert, aber in der Spezifikation nicht vorhanden sind (oder umgekehrt).
- Widersprüche in der Aufgabenreihenfolge (z.B. Integrationsaufgaben vor grundlegenden Setup-Aufgaben ohne Abhängigkeitshinweis).
- Sich widersprechende Anforderungen (z.B. eine erfordert Next.js, während eine andere Vue spezifiziert).
5. Schweregradzuweisung
Verwende diese Heuristik, um Erkenntnisse zu priorisieren:
- KRITISCH: Verstößt gegen Verfassungs-MUST, fehlendes Kern-Spezifikationsartefakt oder Anforderung ohne Abdeckung, die die Basisfunktionalität blockiert.
- HOCH: Doppelte oder widersprüchliche Anforderung, mehrdeutiges Sicherheits-/Leistungsattribut, nicht testbares Abnahmekriterium.
- MITTEL: Terminologieabweichung, fehlende nicht-funktionale Aufgabenabdeckung, unterspezifizierter Randfall.
- NIEDRIG: Stil-/Wortverbesserungen, geringfügige Redundanz ohne Auswirkung auf die Ausführungsreihenfolge.
6. Kompakten Analysebericht erstellen
Gib einen Markdown-Bericht aus (keine Dateischreibvorgänge) mit folgender Struktur:
Spezifikationsanalysebericht
| ID | Kategorie | Schweregrad | Ort(e) | Zusammenfassung | Empfehlung |
|---|---|---|---|---|---|
| A1 | Duplikation | HOCH | spec.md:L120-134 | Zwei ähnliche Anforderungen ... | Formulierung zusammenführen; klarere Version behalten |
(Füge eine Zeile pro Erkenntnis hinzu; generiere stabile IDs mit dem Kategorie-Initial als Präfix.)
Abdeckungszusammenfassungstabelle:
| Anforderungsschlüssel | Hat Aufgabe? | Aufgaben-IDs | Anmerkungen |
|---|
Verfassungskonformitätsprobleme: (falls vorhanden)
Nicht zugeordnete Aufgaben: (falls vorhanden)
Metriken:
- Gesamtanforderungen
- Gesamtaufgaben
- Abdeckung % (Anforderungen mit >=1 Aufgabe)
- Ambiguitätsanzahl
- Duplikatanzahl
- Anzahl kritischer Probleme
7. Nächste Schritte angeben
Am Ende des Berichts gib einen prägnanten Block „Nächste Schritte“ aus:
- Wenn kritische Probleme vorhanden sind: Empfehle die Behebung vor
/speckit-implement. - Wenn nur NIEDRIG/MITTEL: Benutzer kann fortfahren, aber Verbesserungsvorschläge geben.
- Gib explizite Befehlsvorschläge: z.B. „Führe /speckit-specify mit Verfeinerung aus“, „Führe /speckit-plan aus, um die Architektur anzupassen“, „Bearbeite manuell tasks.md, um Abdeckung für 'performance-metrics' hinzuzufügen“.
8. Korrektur anbieten
Frage den Benutzer: „Möchtest du, dass ich konkrete Korrekturvorschläge für die Top-N-Probleme mache?“ (Wende sie NICHT automatisch an.)
9. Erweiterungshooks prüfen
Prüfe nach dem Bericht, ob .specify/extensions.yml im Projektstammverzeichnis existiert.
- Falls ja, lies es und suche nach Einträgen unter dem Schlüssel
hooks.after_analyze. - Falls das YAML nicht geparst werden kann oder ungültig ist, überspringe es nicht stillschweigend: teile dem Benutzer mit, dass
.specify/extensions.ymlnicht gelesen werden konnte (füge den Parser-Fehler hinzu) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten zwingend erforderlichen (optional: false) Hooks. Fahre dann normal fort. - Filtere Hooks heraus, bei denen
enabledexplizitfalseist. Behandle Hooks ohneenabled-Feld als standardmäßig aktiviert. - Versuche für jeden verbleibenden Hook nicht,
condition-Ausdrücke zu interpretieren oder auszuwerten:- Wenn der Hook kein
condition-Feld hat oder dieses null/leer ist, behandle den Hook als ausführbar. - Wenn der Hook eine nicht-leere
conditiondefiniert, überspringe den Hook und überlasse die Bedingungsauswertung der HookExecutor-Implementierung.
- Wenn der Hook kein
- Ersetze beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (
.) durch Bindestriche (-). Beispiel:speckit.git.commit→/speckit-git-commit. - Gib für jeden ausführbaren Hook basierend auf seinem
optional-Flag Folgendes aus:- Optionaler Hook (
optional: true):## Erweiterungshooks **Optionaler Hook**: {extension} Befehl: `/{command}` Beschreibung: {description} Aufforderung: {prompt} Ausführung: `/{command}` - Zwingend erforderlicher Hook (
optional: false):
Nach dem Ausgeben des obigen Blocks MUSST du den Hook tatsächlich aufrufen und auf sein Ende warten, bevor du fortfährst. Führe ihn so aus, wie du den Befehl selbst in diesem Agenten/Session ausführen würdest (der Aufruf kann von der obigen literarischen## Erweiterungshooks **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). Allein das Ausgeben des Blocks führt den Hook nicht aus.
- Optionaler Hook (
- Wenn keine Hooks registriert sind oder
.specify/extensions.ymlnicht existiert, überspringe stillschweigend.
Betriebsprinzipien
Kontexteffizienz
- Minimale signifikante Token: Konzentriere dich auf umsetzbare Erkenntnisse, nicht auf erschöpfende Dokumentation.
- Schrittweise Offenlegung: Lade Artefakte inkrementell; lade nicht den gesamten Inhalt in die Analyse.
- Token-effiziente Ausgabe: Begrenze die Erkenntnistabelle auf 50 Zeilen; fasse Überlauf zusammen.
- Deterministische Ergebnisse: Wiederholte Ausführung ohne Änderungen sollte konsistente IDs und Anzahlen erzeugen.
Analyserichtlinien
- Ändere NIE Dateien (dies ist eine schreibgeschützte Analyse).
- Halluziniere NIE fehlende Abschnitte (wenn fehlend, melde sie genau).
- Priorisiere Verfassungsverstöße (diese sind immer KRITISCH).
- Verwende Beispiele statt erschöpfender Regeln (zitiere spezifische Instanzen, keine generischen Muster).
- Melde null Probleme ordnungsgemäß (gib einen Erfolgsbericht mit Abdeckungsstatistiken aus).
Kontext
$ARGUMENTS