thanhtung2693/specgate

Verwenden von SpecGate

Nur-Bootstrap-Installation

Verwenden Sie diese, wenn specgate-project-setup nach einer reinen Skills.sh-Installation nicht verfügbar ist. Überprüfen Sie mit command -v specgate (PowerShell: Get-Command specgate). Wenn es fehlt, erklären Sie, dass skills.sh nur Anweisungen liefert. Unter macOS, Linux oder WSL2 zeigen Sie dies an und warten auf explizite Zustimmung:

curl -fsSL https://raw.githubusercontent.com/thanhtung2693/specgate/main/scripts/install-cli.sh | sh

Nativer Windows: Verwenden Sie https://github.com/thanhtung2693/specgate/releases/latest; erfinden Sie nie PowerShell. Notieren Sie anschließend specgate --version.

Vertrauen Sie nur einem Lock mit Quelle thanhtung2693/specgate und Pfad plugins/skills/specgate/SKILL.md, entweder in skills-lock.json des Projekts oder global in ~/.agents/.skill-lock.json. Zeigen Sie den passenden Befehl an und warten Sie auf Zustimmung:

npx skills remove specgate -y
npx skills remove specgate -g -y

Bearbeiten oder löschen Sie niemals direkt Dateien von skills.sh oder Locks. Fragen Sie nach IDE und Bereich, zeigen Sie dann eine Vorschau an, installieren Sie und überprüfen Sie:

specgate plugins install --agent <codex|claude|cursor> [--project-local] --dry-run --no-input
specgate plugins install --agent <codex|claude|cursor> [--project-local] --no-input
specgate plugins doctor --agent <codex|claude|cursor> [--project-local] --json

Bei nativem Plugin-Besitz stoppen Sie. Deinstallieren oder deaktivieren Sie es niemals ohne separate explizite Zustimmung.

Erfordert einen IDE-Neustart und Stopp vor der Initialisierung. Setzen Sie nach der Initialisierung über specgate-project-setup fort.

Abschluss: Ein CLI-verwaltetes Plugin, gesunder Doctor-Zustand, expliziter Neustart.

Route eine Phase

Wählen Sie für Lebenszyklusarbeiten genau eine Phase vor dem Handeln aus:

• specgate-project-setup — Initialisieren, Binden, Installieren, Aktualisieren oder Diagnostizieren von SpecGate für ein Repository.
• specgate-work-preparation — Eine Anfrage oder Quellspezifikation in genehmigte SpecGate-Arbeit umwandeln.
• specgate-work-delivery — Genehmigte SpecGate-Arbeit implementieren, fortsetzen, überprüfen oder überarbeiten.

Bei einer reinen Lese- oder Lebenszyklusstatus-Frage mit einem Arbeitsverweis beginnen Sie mit der autoritativen Lektüre:

specgate change status "$WORK_REF" --json

Bei anderen Konzept- oder Fehlerbehebungsfragen verwenden Sie die kleinste relevante CLI-Leseoperation. Erzwingen Sie keine Phase oder mutieren Sie keine Datensätze.

Vor einem modusabhängigen Schreib- oder Übergabevorgang führen Sie specgate doctor --json aus. Lesen Sie data.mode; leiten Sie den Modus niemals aus Docker, URLs oder Browserverfügbarkeit ab. Melden Sie ein erfolgloses Doctor-Ergebnis, anstatt zu raten.

Betriebsvertrag

• Die specgate CLI ist die einzige Lese- und Schreiboberfläche für den Produktzustand. Untersuchen oder bearbeiten Sie niemals direkt SpecGate SQLite, Postgres, Objektspeicher, Bereitstellungsvolumes oder .specgate/local. Lesezugriffe auf das Repository bleiben erlaubt.
• Entwürfe, Erklärungen, Zusammenfassungen und Repository-Lesungen bleiben flüchtig, bis ein expliziter CLI-Befehl sie persistiert.
• Das ursprüngliche Autorenframework besitzt die dauerhaften Quelldokumente: deren Pfade, Namen, Lebenszyklus und Git-Richtlinie. SpecGate macht Momentaufnahmen davon an Ort und Stelle. Es verschiebt, kopiert, benennt, löscht, committed oder ändert keine Ignorierregeln dafür.
• Ein Bereitschaftstest ist keine menschliche Genehmigung. Genehmigung, Annahme und angeforderte Änderungen bleiben menschliche Entscheidungen. Führen Sie einen Entscheidungsbefehl nur aus, nachdem der Mensch sich explizit für genau diese Entscheidung entschieden und sie autorisiert hat; leiten Sie niemals eine ab.
• Ein genehmigter Kontextpack hat Vorrang vor Chatverlauf, Tracker-Text und veralteten Repository-Dokumenten. Erweitern Sie niemals stillschweigend dessen Umfang.
• Befolgen Sie genaue Identifikatoren und Versionen. artifact coverage <artifact-id> ist versionsgenauer Beweis; fassen Sie niemals Versionen durch Feature-Namen zusammen.
• Befolgen Sie change status.data.next_actor und next_command. Wenn der nächste Akteur menschlich ist, stoppen Sie und übergeben Sie diesen Befehl wörtlich.
• Der lokale Modus hat keine UI-URL und ruft niemals specgate open auf. Im Voll-Modus verwenden Sie nur die URL, die von specgate open ... --print --json zurückgegeben wird; konstruieren Sie niemals eine.

Für die Befehlssyntax führen Sie specgate <command> --help aus, anstatt Flags aus dem Gedächtnis zu rekonstruieren.