Benutzereingabe
$ARGUMENTS
Sie MÜSSEN die Benutzereingabe berücksichtigen, bevor Sie fortfahren (falls nicht leer).
Pre-Execution-Checks
Prüfung auf Erweiterungs-Hooks (vor der Aufgaben-zu-Issues-Konvertierung):
- 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_taskstoissues. - Wenn das YAML nicht geparst werden kann oder ungültig ist: 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 zwingenden (optional: false) Hooks, und fahren Sie dann normal fort. - Filtern Sie Hooks heraus, bei denen
enabledexplizitfalseist. Behandeln Sie Hooks ohneenabled-Feld als standardmäßig aktiviert. - Versuchen Sie nicht, für jeden verbleibenden 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 Auswertung der Bedingung der HookExecutor-Implementierung.
- Wenn der Hook kein
- Beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen ersetzen Sie 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):
Nachdem Sie den obigen Block ausgegeben haben, 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 literalen## Erweiterungs-Hooks **Automatischer Pre-Hook**: {extension} Führe aus: `/{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, fahren Sie still fort.
Gliederung
- Führen Sie
.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasksaus dem Repository-Stammverzeichnis aus und parsen Sie die Liste FEATURE_DIR und AVAILABLE_DOCS. Alle Pfade müssen absolut sein. 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"). - FALLS VORHANDEN: Laden Sie
.specify/memory/constitution.mdfür Projektprinzipien und Governance-Einschränkungen. - Extrahieren Sie aus dem ausgeführten Skript den Pfad zu den Aufgaben.
- Holen Sie den Git-Remote durch Ausführen von:
git config --get remote.origin.url
[!CAUTION] FAHREN SIE NUR MIT DEN NÄCHSTEN SCHRITTEN FORT, WENN DER REMOTE EINE GITHUB-URL IST
- Vorhandene Issues für die Deduplizierung abrufen: Bevor Sie etwas erstellen, erstellen Sie den Satz von Aufgaben-IDs, die Sie verarbeiten möchten, aus
tasks.md(jede ist einTgefolgt von mindestens drei Ziffern, z. B.T001—/speckit-convergeweist neue IDs mitT{M+1:03d}zu, was eher eine Untergrenze als eine Obergrenze darstellt, sodass IDs ab einer Datei mit mehr als 999 Aufgaben vierstellig oder länger sind). Verwenden Sie dann daslist_issues-Tool des GitHub MCP-Servers, um nach Issues zu suchen, die diese IDs bereits abdecken. Übergeben Sie keinenstate-Wert, da das Weglassen dazu führt, dass das Tool sowohl offene als auch geschlossene Issues zurückgibt. Fordern SieperPage: 100an, um die Anzahl der Aufrufe gering zu halten, und da das Tool cursor-basierte Paginierung verwendet, fordern Sie Seiten mit dem Parameterafter(unter Verwendung desendCursoraus der vorherigen Antwort) an. Überprüfen Sie für jeden Issue-Titel die Übereinstimmung mit dem Aufgaben-ID-Muster\bT\d{3,}\b(das{3,}akzeptiert vierstellige und längere IDs – mit\d{3}würde ein Titel, derT1000enthält, überhaupt nicht übereinstimmen, da das abschließende\bnicht zwischen zwei Ziffern fallen kann, sodass diese Aufgabe weder dedupliziert noch erstellt würde; Wortgrenzen verhindern immer noch, dass ein Token wieST001übereinstimmt, und erzwingen, dass die gesamte Ziffernsequenz konsumiert wird, sodassT100niemals innerhalb vonT1000übereinstimmen kann; dies erkennt auch Titel, die alsT001 ...,T001: ...oder[T001] ...geschrieben sind) und markieren Sie, wenn es mit einer Ihrer Aufgaben-IDs übereinstimmt, diese ID als bereits vorhandenes Issue. Beenden Sie die Paginierung, sobald jede Aufgaben-ID gefunden wurde, oder wenn es keine weiteren Seiten mehr gibt, damit Sie nicht die gesamte Issue-Historie des Repositorys abrufen, sobald alle Aufgaben-IDs berücksichtigt sind. Dies begrenzt die Anzahl der Aufrufe bei Repositorys mit großen Issue-Historien und verhindert dennoch Duplikate, wenn der Befehl erneut ausgeführt wird, nachdemtasks.mdneu generiert oder die Skill erneut aufgerufen wurde. - Erstellen Sie für jede Aufgabe in der Liste mit dem GitHub MCP-Server ein neues Issue in dem Repository, das für den Git-Remote repräsentativ ist. Aufgabenzeilen in
tasks.mdbeginnen mit einer Markdown-Checkbox, entfernen Sie daher zunächst das führende- [ ](und alle Marker[P]/[US#]), um die Aufgaben-ID und ihre Beschreibung wiederherzustellen. Erstellen Sie das Issue mit einem einzigen kanonischen Titel der FormT001: <description>, wobei die ID einmal gefolgt von der Aufgabenbeschreibung geschrieben wird (z. B. wird die Zeile- [ ] T001 Create project structurezum TitelT001: Erstelle Projektstruktur).- Überspringen Sie jede Aufgabe, deren ID bereits im Satz vorhandener Issues aus dem vorherigen Schritt vorhanden ist, und melden Sie dies (z. B.
T001 hat bereits ein Issue, überspringe). - Erstellen Sie nur Issues für Aufgaben, die noch kein passendes Issue haben.
- Überspringen Sie jede Aufgabe, deren ID bereits im Satz vorhandener Issues aus dem vorherigen Schritt vorhanden ist, und melden Sie dies (z. B.
[!CAUTION] ERSTELLEN SIE UNTER KEINEN UMSTÄNDEN ISSUES IN REPOSITORIES, DIE NICHT MIT DER REMOTE-URL ÜBEREINSTIMMEN
Post-Execution-Checks
Prüfung auf Erweiterungs-Hooks (nach der Aufgaben-zu-Issues-Konvertierung):
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_taskstoissues. - Wenn das YAML nicht geparst werden kann oder ungültig ist: 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 zwingenden (optional: false) Hooks, und fahren Sie dann normal fort. - Filtern Sie Hooks heraus, bei denen
enabledexplizitfalseist. Behandeln Sie Hooks ohneenabled-Feld als standardmäßig aktiviert. - Versuchen Sie nicht, für jeden verbleibenden 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 Auswertung der Bedingung der HookExecutor-Implementierung.
- Wenn der Hook kein
- Beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen ersetzen Sie 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):
Nachdem Sie den obigen Block ausgegeben haben, 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 literalen## Erweiterungs-Hooks **Automatischer Hook**: {extension} Führe aus: `/{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 (
- Wenn keine Hooks registriert sind oder
.specify/extensions.ymlnicht existiert, fahren Sie still fort.