Befehle

Dies ist die Referenz für die Slash-Befehle von OpenSpec. Diese Befehle werden in der Chat-Oberfläche Ihres KI-Programmierassistenten aufgerufen (z. B. Claude Code, Cursor, Devin Desktop).

Informationen zu Workflow-Mustern und wann Sie welche Befehle verwenden sollten, finden Sie unter Workflows. Informationen zu CLI-Befehlen finden Sie unter CLI.

Diese Seiten verwenden /opsx:<command> als kanonischen Namen. Einige Tools schreiben es anders – Cursor und GitHub Copilot registrieren /opsx-propose, Codex verwendet $openspec-propose – prüfen Sie daher Aufrufen für Ihr Tool. Die von OpenSpec generierten Dateien verwenden bereits die richtige Form.

Schnellreferenz

Standard-Schnellpfad (`core`-Profil)

Befehl	Zweck
`/opsx:propose`	Eine Änderung erstellen und Planungsartefakte in einem Schritt generieren
`/opsx:explore`	Ideen durchdenken, bevor man sich auf eine Änderung festlegt
`/opsx:apply`	Aufgaben aus der Änderung implementieren
`/opsx:update`	Planungsartefakte einer Änderung überarbeiten und kohärent halten
`/opsx:sync`	Delta-Spezifikationen in Hauptspezifikationen zusammenführen
`/opsx:archive`	Eine abgeschlossene Änderung archivieren

Erweiterte Workflow-Befehle (benutzerdefinierte Workflow-Auswahl)

Befehl	Zweck
`/opsx:new`	Ein neues Änderungsgerüst starten
`/opsx:continue`	Das nächste Artefakt basierend auf Abhängigkeiten erstellen
`/opsx:ff`	Schnellvorlauf: alle Planungsartefakte auf einmal erstellen
`/opsx:verify`	Validieren, dass die Implementierung mit den Artefakten übereinstimmt
`/opsx:bulk-archive`	Mehrere Änderungen auf einmal archivieren
`/opsx:onboard`	Geführter Leitfaden durch den vollständigen Workflow

Das standardmäßige globale Profil ist core. Um erweiterte Workflow-Befehle zu aktivieren, führen Sie openspec config profile aus, wählen Sie Workflows aus und führen Sie dann openspec update in Ihrem Projekt aus.

Befehlsreferenz

`/opsx:propose`

Erstellen Sie eine neue Änderung und generieren Sie in einem Schritt die Planungsartefakte. Dies ist der Standardstartbefehl im core-Profil.

Syntax:

text

/opsx:propose [change-name-or-description]

Argumente:

Argument	Erforderlich	Beschreibung
`change-name-or-description`	Nein	Kebab-case-Name oder Beschreibung der Änderung in natürlicher Sprache

Was es tut:

Erzeugt openspec/changes/<change-name>/
Generiert die Artefakte, die vor der Implementierung benötigt werden (für spec-driven: Vorschlag, Spezifikationen, Design, Aufgaben)
Stoppt, wenn die Änderung bereit für /opsx:apply ist

Beispiel:

text

You: /opsx:propose add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md
     ✓ specs/ui/spec.md
     ✓ design.md
     ✓ tasks.md
     Ready for implementation. Run /opsx:apply.

Tipps:

Verwenden Sie dies für den schnellsten End-to-End-Weg
Wenn Sie die schrittweise Kontrolle über Artefakte wünschen, aktivieren Sie erweiterte Workflows und verwenden Sie /opsx:new + /opsx:continue

`/opsx:explore`

Starten Sie hier, wenn Sie unsicher sind. Explore ist ein risikofreier Denkpartner: Er liest Ihren Code, vergleicht Optionen und verfeinert eine vage Idee zu einem konkreten Plan, bevor eine Änderung existiert. Er ist im Standardprofil enthalten. Für den vollständigen Anwendungsfall und weitere Beispiele siehe den Explore First-Leitfaden.

Durchdenken Sie Ideen, untersuchen Sie Probleme und klären Sie Anforderungen, bevor Sie sich für eine Änderung entscheiden.

Syntax:

/opsx:explore [topic]

Argumente:

Argument	Erforderlich	Beschreibung
`topic`	Nein	Was Sie erkunden oder untersuchen möchten

Was es tut:

Öffnet ein exploratives Gespräch ohne vorgeschriebene Struktur
Untersucht den Code, um Fragen zu beantworten
Vergleicht Optionen und Ansätze
Erstellt visuelle Diagramme zur Verdeutlichung des Denkprozesses
Kann bei klaren Erkenntnissen zu /opsx:propose (Standard) oder /opsx:new (erweiterter Workflow) wechseln

Beispiel:

text

You: /opsx:explore

AI:  What would you like to explore?

You: How should we handle authentication for the mobile app?

AI:  Let me investigate your current auth setup...
     [Analyzes codebase]

     I see you're using session-based auth for the web app.
     For mobile, we have three main options:

     1. JWT tokens (stateless, works offline)
     2. OAuth2 (if you need third-party login)
     3. Extend current sessions (simpler, but requires connectivity)

     Your API already has CORS configured. Which direction interests you?

You: Let's go with JWT. Can we start a change for that?

AI:  Ready when you are. Run /opsx:propose add-jwt-auth to begin.

Tipps:

Verwenden Sie, wenn Anforderungen unklar sind oder Sie etwas untersuchen müssen
Es werden während der Exploration keine Artefakte erstellt
Gut zum Vergleich mehrerer Ansätze vor einer Entscheidung
Kann Dateien lesen und im Code suchen

`/opsx:new`

Startet ein neues Änderungsscaffold. Erzeugt den Änderungsordner und wartet darauf, dass Sie mit /opsx:continue oder /opsx:ff Artefakte generieren.

Dieser Befehl ist Teil des erweiterten Workflow-Sets (nicht im Standard-core-Profil enthalten).

Syntax:

/opsx:new [change-name] [--schema <schema-name>]

Argumente:

Argument	Erforderlich	Beschreibung
`change-name`	Nein	Name für den Änderungsordner (wird abgefragt, wenn nicht angegeben)
`--schema`	Nein	Zu verwendendes Workflow-Schema (Standard: aus Konfiguration oder `spec-driven`)

Was es tut:

Erzeugt das Verzeichnis openspec/changes/<change-name>/
Erzeugt die Metadaten-Datei .openspec.yaml im Änderungsordner
Zeigt die erste Artefaktvorlage zur Erstellung an
Fragt nach Änderungsname und Schema, wenn diese nicht angegeben wurden

Was es erstellt:

openspec/changes/<change-name>/
└── .openspec.yaml    # Change metadata (schema, created date)

Beispiel:

You: /opsx:new add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     Schema: spec-driven

     Ready to create: proposal
     Use /opsx:continue to create it, or /opsx:ff to create all artifacts.

Tipps:

Verwenden Sie beschreibende Namen: add-feature, fix-bug, refactor-module
Vermeiden Sie generische Namen wie update, changes, wip
Das Schema kann auch in der Projektkonfiguration (openspec/config.yaml) festgelegt werden

`/opsx:continue`

Erzeugt das nächste Artefakt in der Abhängigkeitskette. Erstellt ein Artefakt nach dem anderen für inkrementellen Fortschritt.

Syntax:

/opsx:continue [change-name]

Argumente:

Argument	Erforderlich	Beschreibung
`change-name`	Nein	Welche Änderung fortgesetzt werden soll (wird aus dem Kontext abgeleitet, wenn nicht angegeben)

Was es tut:

Abfragt den Artefakt-Abhängigkeitsgraphen
Zeigt an, welche Artefakte bereit und welche blockiert sind
Erzeugt das erste bereite Artefakt
Liest Abhängigkeitsdateien für Kontext
Zeigt an, was nach der Erstellung verfügbar wird

Beispiel:

You: /opsx:continue

AI:  Change: add-dark-mode

     Artifact status:
     ✓ proposal    (done)
     ◆ specs       (ready)
     ◆ design      (ready)
     ○ tasks       (blocked - needs: specs, design)

     Creating specs...

     [Reads proposal.md, creates specs based on requirements]

     ✓ Created openspec/changes/add-dark-mode/specs/ui/spec.md

     Now available: design
     Run /opsx:continue to create the next artifact.

Tipps:

Verwenden Sie, wenn Sie jedes Artefakt vor dem Fortfahren überprüfen möchten
Gut für komplexe Änderungen, bei denen Sie Kontrolle wünschen
Mehrere Artefakte können gleichzeitig bereit werden
Sie können erstellte Artefakte vor dem Fortfahren bearbeiten

`/opsx:ff`

Schnellvorlauf durch die Artefakterstellung. Erstellt alle Planungsartefakte auf einmal.

Syntax:

/opsx:ff [change-name]

Argumente:

Argument	Erforderlich	Beschreibung
`change-name`	Nein	Welche Änderung vorverfolgt werden soll (wird aus dem Kontext abgeleitet, wenn nicht angegeben)

Was es tut:

Erzeugt alle Artefakte in Abhängigkeitsreihenfolge
Verfolgt den Fortschritt über eine Todo-Liste
Stoppt, wenn alle apply-required-Artefakte abgeschlossen sind
Liest jede Abhängigkeit, bevor das nächste Artefakt erstellt wird

Beispiel:

You: /opsx:ff add-dark-mode

AI:  Fast-forwarding add-dark-mode...

     ✓ Creating proposal.md
     ✓ Creating specs/ui/spec.md
     ✓ Creating design.md
     ✓ Creating tasks.md

     All planning artifacts complete!
     Ready for implementation. Run /opsx:apply to begin.

Tipps:

Verwenden Sie, wenn Sie ein klares Bild davon haben, was Sie bauen
Schneller als /opsx:continue für unkomplizierte Änderungen
Sie können Artefakte danach noch bearbeiten
Gut für kleine bis mittlere Funktionen

`/opsx:apply`

Implementiert Aufgaben aus der Änderung. Arbeitet durch die Aufgabenliste, schreibt Code und hakt Punkte ab.

Syntax:

/opsx:apply [change-name]

Argumente:

Argument	Erforderlich	Beschreibung
`change-name`	Nein	Welche Änderung implementiert werden soll (wird aus dem Kontext abgeleitet, wenn nicht angegeben)

Was es tut:

Liest tasks.md und identifiziert unvollständige Aufgaben
Arbeitet Aufgabe für Aufgabe durch
Schreibt Code, erstellt Dateien, führt Tests aus wie benötigt
Markiert Aufgaben als abgeschlossen mit Checkboxen [x]

Beispiel:

You: /opsx:apply

AI:  Implementing add-dark-mode...

     Reading tasks.md:
     - [ ] 1.1 Create ThemeContext
     - [ ] 1.2 Add CSS custom properties
     - [ ] 1.3 Implement localStorage persistence

     Working on 1.1: Create ThemeContext...
     [Creates src/context/ThemeContext.tsx]

     ✓ 1.1 Complete

     Working on 1.2: Add CSS custom properties...
     [Updates src/styles/globals.css]

     ✓ 1.2 Complete
     ...

Tipps:

Kann dort weitermachen, wo Sie aufgehört haben, wenn unterbrochen
Verwenden Sie für parallele Änderungen, indem Sie den Änderungsname angeben
Der Abschlussstatus wird in den tasks.md-Checkboxen verfolgt

`/opsx:update`

Überarbeitet die vorhandenen Planungsartefakte einer Änderung und hält sie untereinander konsistent. Nur Planungsartefakte – es wird niemals Code bearbeitet.

Syntax:

text

/opsx:update [change-name]

Argumente:

Argument	Erforderlich	Beschreibung
`change-name`	Nein	Welche Änderung aktualisiert werden soll (wird aus dem Kontext abgeleitet, wenn nicht angegeben)

Was es tut:

Liest die Artefakte der Änderung über openspec status --change <name> --json
Wendet Ihre gewünschte Überarbeitung an oder prüft die Artefakte auf Widersprüche, wenn Sie keine angeben
Harmonisiert die anderen vorhandenen Artefakte in jede Richtung (eine Designänderung kann sich auf den Vorschlag auswirken)
Bestätigt jede Änderung mit Ihnen, bevor sie geschrieben wird, ein Artefakt nach dem anderen
Beendet sich mit einer Empfehlung für den nächsten Schritt: /opsx:continue (fehlende Artefakte), /opsx:apply (überarbeiteten Plan in Code umsetzen) oder /opsx:archive (alles erledigt)

Beispiel:

text

You: /opsx:update add-dark-mode - we're storing the theme in a cookie now, not localStorage

AI:  Reading add-dark-mode artifacts...

     The design references localStorage in two places; tasks 1.3 covers
     localStorage persistence; the proposal doesn't mention storage.

     Proposed revisions:
     1. design.md - swap localStorage decision for cookie storage
     2. tasks.md - reword task 1.3 to cookie persistence

     Apply revision 1? (design.md)

Tipps:

Es werden keine fehlenden Artefakte erstellt – dafür ist /opsx:continue
Wenn die Änderung bereits implementiert wurde, folgen Sie mit /opsx:apply, damit der Code zum überarbeiteten Plan passt
Wenn Ihre Überarbeitung die Absicht der Änderung ändert, starten Sie stattdessen mit einer neuen Änderung von vorn (siehe Wann aktualisieren vs. von vorn beginnen)

`/opsx:verify`

Validiert, dass die Implementierung mit Ihren Änderungsartefakten übereinstimmt. Prüft Vollständigkeit, Korrektheit und Kohärenz.

Syntax:

/opsx:verify [change-name]

Argumente:

Argument	Erforderlich	Beschreibung
`change-name`	Nein	Welche Änderung verifiziert werden soll (wird aus dem Kontext abgeleitet, wenn nicht angegeben)

Was es tut:

Prüft drei Dimensionen der Implementierungsqualität
Durchsucht den Code nach Implementierungsnachweisen
Berichtet Probleme, kategorisiert als CRITICAL, WARNING oder SUGGESTION
Blockiert das Archivieren nicht, aber macht Probleme sichtbar

Verifikationsdimensionen:

Dimension	Was validiert wird
Vollständigkeit	Alle Aufgaben erledigt, alle Anforderungen implementiert, Szenarien abgedeckt
Korrektheit	Implementierung entspricht der Spezifikationsabsicht, Grenzfälle behandelt
Kohärenz	Designentscheidungen im Code widergespiegelt, Muster konsistent

Beispiel:

You: /opsx:verify

AI:  Verifying add-dark-mode...

     COMPLETENESS
     ✓ All 8 tasks in tasks.md are checked
     ✓ All requirements in specs have corresponding code
     ⚠ Scenario "System preference detection" has no test coverage

     CORRECTNESS
     ✓ Implementation matches spec intent
     ✓ Edge cases from scenarios are handled
     ✓ Error states match spec definitions

     COHERENCE
     ✓ Design decisions reflected in code structure
     ✓ Naming conventions consistent with design.md
     ⚠ Design mentions "CSS variables" but implementation uses Tailwind classes

     SUMMARY
     ─────────────────────────────
     Critical issues: 0
     Warnings: 2
     Ready to archive: Yes (with warnings)

     Recommendations:
     1. Add test for system preference detection
     2. Update design.md to reflect Tailwind usage, or refactor to use CSS variables

Tipps:

Führen Sie vor dem Archivieren aus, um Abweichungen früh zu erkennen
Warnungen blockieren das Archivieren nicht, deuten aber auf potenzielle Probleme hin
Gut zur Überprüfung der KI-Arbeit vor dem Commit
Kann Drift zwischen Artefakten und Implementierung aufdecken

`/opsx:sync`

Optionaler Befehl. Führt Delta-Spezifikationen aus einer Änderung in die Hauptspezifikationen zusammen. Beim Archivieren wird nach dem Synchronisieren gefragt, falls erforderlich, daher müssen Sie diesen Befehl in der Regel nicht manuell ausführen.

Syntax:

/opsx:sync [change-name]

Argumente:

Argument	Erforderlich	Beschreibung
`change-name`	Nein	Welche Änderung synchronisiert werden soll (wird aus dem Kontext abgeleitet, wenn nicht angegeben)

Was es tut:

Liest Delta-Spezifikationen aus dem Änderungsordner
Analysiert ADDED/MODIFIED/REMOVED/RENAMED-Abschnitte
Führt die Änderungen in das Hauptverzeichnis openspec/specs/ zusammen
Bewahrt vorhandenen Inhalt, der im Delta nicht erwähnt wird
Archiviert die Änderung nicht (bleibt aktiv)

Beispiel:

text

You: /opsx:sync

AI:  Syncing add-dark-mode delta specs...

     Reading: openspec/changes/add-dark-mode/specs/ui/spec.md
     Target:  openspec/specs/ui/spec.md

     Changes to apply:
     ✓ ADDED: Theme Selection requirement (2 scenarios)
     ✓ ADDED: Accessibility requirement (1 scenario)

     Merging...
     ✓ openspec/specs/ui/spec.md updated

     Change remains active. Run /opsx:archive when ready to complete.

Wann manuell verwenden:

Szenario	Synchronisieren?
Langlaufende Änderung, Spezifikationen vor dem Archivieren in der Hauptversion wünschen	Ja
Mehrere parallele Änderungen benötigen die aktualisierten Basisspezifikationen	Ja
Zusammenführung separat vorab prüfen/wollen	Ja
Schnelle Änderung, direkt zum Archivieren	Nein (Archivieren übernimmt es)

Tipps:

Synchronisieren ist intelligent, kein Copy-Paste
Kann Szenarien zu vorhandenen Anforderungen hinzufügen, ohne zu duplizieren
Die Änderung bleibt nach dem Synchronisieren aktiv (nicht archiviert)
Die meisten Benutzer werden diesen Befehl nie direkt aufrufen müssen – das Archivieren fragt bei Bedarf

`/opsx:archive`

Archiviert eine abgeschlossene Änderung. Finalisiert die Änderung und verschiebt sie in den Archivordner.

Syntax:

/opsx:archive [change-name]

Argumente:

Argument	Erforderlich	Beschreibung
`change-name`	Nein	Welche Änderung archiviert werden soll (wird aus dem Kontext abgeleitet, wenn nicht angegeben)

Was es tut:

Prüft den Abschlussstatus der Artefakte
Prüft den Aufgabenabschluss (warnt bei Unvollständigkeit)
Bietet das Synchronisieren von Delta-Spezifikationen an, falls noch nicht synchronisiert
Verschiebt den Änderungsordner nach openspec/changes/archive/YYYY-MM-DD-<name>/
Bewahrt alle Artefakte für die Prüfspur

Beispiel:

text

You: /opsx:archive

AI:  Archiving add-dark-mode...

     Artifact status:
     ✓ proposal.md exists
     ✓ specs/ exists
     ✓ design.md exists
     ✓ tasks.md exists (8/8 tasks complete)

     Delta specs: Not yet synced
     → Sync now? (recommended)

You: Yes

AI:  ✓ Synced specs to openspec/specs/ui/spec.md
     ✓ Moved to openspec/changes/archive/2025-01-24-add-dark-mode/

     Change archived successfully.

Tipps:

Das Archivieren blockiert nicht bei unvollständigen Aufgaben, warnt aber
Delta-Spezifikationen können beim Archivieren oder vorher synchronisiert werden
Archivierte Änderungen werden für die Historie aufbewahrt
Verwenden Sie zuerst /opsx:verify, um Probleme zu erkennen

`/opsx:bulk-archive`

Archiviert mehrere abgeschlossene Änderungen auf einmal. Behandelt Spezifikationskonflikte zwischen Änderungen.

Syntax:

/opsx:bulk-archive [change-names...]

Argumente:

Argument	Erforderlich	Beschreibung
`change-names`	Nein	Spezifische Änderungen zum Archivieren (wird zur Auswahl abgefragt, wenn nicht angegeben)

Was es tut:

Listet alle abgeschlossenen Änderungen auf
Validiert jede Änderung vor dem Archivieren
Erkennt Spezifikationskonflikte zwischen Änderungen
Löst Konflikte, indem es prüft, was tatsächlich implementiert wurde
Archiviert in chronologischer Reihenfolge

Beispiel:

You: /opsx:bulk-archive

AI:  Found 3 completed changes:
     - add-dark-mode (8/8 tasks complete)
     - fix-login-bug (3/3 tasks complete)
     - update-footer (2/2 tasks complete)

     Checking for spec conflicts...
     ⚠ add-dark-mode and update-footer both touch specs/ui/

     Inspecting codebase to resolve...
     Both changes are implemented. Will merge in chronological order:
     1. add-dark-mode (created Jan 20)
     2. update-footer (created Jan 22)

     Archive all 3 changes?

You: Yes

AI:  ✓ Archived add-dark-mode
     ✓ Archived fix-login-bug
     ✓ Archived update-footer
     Specs merged: add-dark-mode → update-footer

Tipps:

Gut für parallele Arbeitsströme
Konfliktlösung ist agentisch (prüft den Code)
Änderungen werden in Erstellungsreihenfolge archiviert
Fragt vor dem Überschreiben von Spezifikationsinhalten

`/opsx:onboard`

Geführtes Onboarding durch den vollständigen OpenSpec-Workflow. Ein interaktives Tutorial mit Ihrem tatsächlichen Code.

Syntax:

/opsx:onboard

Was es tut:

Geht einen vollständigen Workflow-Zyklus mit Erläuterungen durch
Scannt Ihren Code nach echten Verbesserungsmöglichkeiten
Erstellt eine tatsächliche Änderung mit echten Artefakten
Implementiert tatsächliche Arbeit (kleine, sichere Änderungen)
Archiviert die abgeschlossene Änderung
Erklärt jeden Schritt, während er stattfindet

Phasen:

Begrüßung und Code-Analyse
Finden einer Verbesserungsmöglichkeit
Erstellen einer Änderung (/opsx:new)
Verfassen des Vorschlags
Erstellen der Spezifikationen
Verfassen des Designs
Erstellen der Aufgaben
Implementieren der Aufgaben (/opsx:apply)
Verifizieren der Implementierung
Archivieren der Änderung
Zusammenfassung und nächste Schritte

Beispiel:

You: /opsx:onboard

AI:  Welcome to OpenSpec!

     I'll walk you through the complete workflow using your actual codebase.
     We'll find something small to improve, create a proper change for it,
     implement it, and archive it.

     Let me scan your codebase for opportunities...

     [Analyzes codebase]

     I found a few things we could work on:
     1. Add input validation to the contact form
     2. Improve error messages in the auth flow
     3. Add loading states to async buttons

     Which interests you? (or suggest something else)

Tipps:

Am besten für neue Benutzer, die den Workflow lernen
Verwendet echten Code, keine Spielzeugbeispiele
Erstellt eine echte Änderung, die Sie behalten oder verwerfen können
Dauert 15–30 Minuten bis zur Fertigstellung

Befehlssyntax nach KI-Tool

Verschiedene KI-Tools verwenden eine leicht unterschiedliche Befehlssyntax. Verwenden Sie das Format, das zu Ihrem Tool passt:

Befehlsdatei Ihres Tools	Syntaxbeispiel	Beispiel-Tools
`.../commands/opsx/<id>.*`	`/opsx:propose`, `/opsx:apply`	Claude Code, Gemini CLI, Crush
`.../opsx-<id>.*`	`/opsx-propose`, `/opsx-apply`	Cursor, Devin Desktop, Copilot (IDE), Trae, Oh My Pi
keine — nur Skills	`/openspec-propose`, `/openspec-apply-change`	CodeArts, ForgeCode, Hermes, MiniMax Code, Mistral Vibe, Zed Agent, gemeinsam genutzte `.agents`
keine — Kimi Code	`/skill:openspec-propose`	Kimi Code
keine — Codex CLI	`$openspec-propose`	Codex

Devin Desktop vs. Devin Local: Die Dateien .devin/workflows/opsx-*.md geben Devin Desktop /opsx-propose. Devin Local hat keine Workflows — verwenden Sie die Skills, die OpenSpec in .devin/skills/ schreibt, z. B. /openspec-propose, die auf beiden Agents funktionieren.

Die Absicht ist bei allen Tools dieselbe, aber die Darstellung der Befehle kann je nach Integration variieren. Aufrufmethode listet jedes unterstützte Tool auf; diese Tabelle zeigt nur Beispiele für jede Form.

Hinweis: GitHub-Copilot-Befehle (.github/prompts/*.prompt.md) sind nur in IDE-Erweiterungen verfügbar (VS Code, JetBrains, Visual Studio). GitHub Copilot CLI unterstützt derzeit keine benutzerdefinierten Prompt-Dateien — siehe Unterstützte Tools für Details und Workarounds.

Legacy-Befehle

Diese Befehle verwenden den älteren "Alles-auf-einmal"-Workflow. Sie funktionieren weiterhin, aber OPSX-Befehle werden empfohlen.

Befehl	Funktion
`/openspec:proposal`	Alle Artefakte auf einmal erstellen (Proposal, Spezifikationen, Design, Aufgaben)
`/openspec:apply`	Die Änderung implementieren
`/openspec:archive`	Die Änderung archivieren

Wann Legacy-Befehle verwenden:

Bestehende Projekte, die den alten Workflow verwenden
Einfache Änderungen, bei denen keine inkrementelle Artefakterstellung erforderlich ist
Bevorzugung des Alles-oder-Nichts-Ansatzes

Migration zu OPSX: Legacy-Änderungen können mit OPSX-Befehlen fortgesetzt werden. Die Artefaktstruktur ist kompatibel.

Fehlerbehebung

"Änderung nicht gefunden"

Der Befehl konnte nicht ermitteln, an welcher Änderung gearbeitet werden soll.

Lösungen:

Geben Sie den Änderungsnamen explizit an: /opsx:apply add-dark-mode
Überprüfen Sie, ob der Änderungsordner existiert: openspec list
Stellen Sie sicher, dass Sie sich im richtigen Projektverzeichnis befinden

"Keine Artefakte bereit"

Alle Artefakte sind entweder vollständig oder durch fehlende Abhängigkeiten blockiert.

Lösungen:

Führen Sie openspec status --change <name> aus, um zu sehen, was blockiert
Überprüfen Sie, ob erforderliche Artefakte existieren
Erstellen Sie zuerst fehlende Abhängigkeitsartefakte

"Schema nicht gefunden"

Das angegebene Schema existiert nicht.

Lösungen:

Verfügbare Schemas auflisten: openspec schemas
Rechtschreibung des Schemanamens überprüfen
Wenn es ein benutzerdefiniertes Schema ist: openspec schema init <name>

Befehle nicht erkannt

Das KI-Tool erkennt OpenSpec-Befehle nicht.

Lösungen:

Stellen Sie sicher, dass OpenSpec initialisiert ist: openspec init
Skills neu generieren: openspec update
Überprüfen Sie, ob das Verzeichnis .claude/skills/ existiert (für Claude Code)
Starten Sie Ihr KI-Tool neu, um neue Skills zu übernehmen

Artefakte werden nicht korrekt generiert

Die KI erstellt unvollständige oder falsche Artefakte.

Lösungen:

Projektkontext in openspec/config.yaml hinzufügen
Artefakt-spezifische Regeln für gezielte Anweisungen hinzufügen
Mehr Details in Ihrer Änderungsbeschreibung angeben
Verwenden Sie /opsx:continue anstelle von /opsx:ff für mehr Kontrolle

Nächste Schritte

Workflows - Häufige Muster und wann welcher Befehl verwendet werden sollte
CLI - Terminalbefehle für Verwaltung und Validierung
Anpassung - Benutzerdefinierte Schemas und Workflows erstellen

Befehle ​

Schnellreferenz ​

Standard-Schnellpfad (core-Profil) ​

Erweiterte Workflow-Befehle (benutzerdefinierte Workflow-Auswahl) ​

Befehlsreferenz ​

/opsx:propose ​

/opsx:explore ​

/opsx:new ​

/opsx:continue ​

/opsx:ff ​

/opsx:apply ​

/opsx:update ​

/opsx:verify ​

/opsx:sync ​

/opsx:archive ​

/opsx:bulk-archive ​

/opsx:onboard ​

Befehlssyntax nach KI-Tool ​

Legacy-Befehle ​

Fehlerbehebung ​

"Änderung nicht gefunden" ​

"Keine Artefakte bereit" ​

"Schema nicht gefunden" ​

Befehle nicht erkannt ​

Artefakte werden nicht korrekt generiert ​

Nächste Schritte ​

Befehle

Schnellreferenz

Standard-Schnellpfad (`core`-Profil)

Erweiterte Workflow-Befehle (benutzerdefinierte Workflow-Auswahl)

Befehlsreferenz

`/opsx:propose`

`/opsx:explore`

`/opsx:new`

`/opsx:continue`

`/opsx:ff`

`/opsx:apply`

`/opsx:update`

`/opsx:verify`

`/opsx:sync`

`/opsx:archive`

`/opsx:bulk-archive`

`/opsx:onboard`

Befehlssyntax nach KI-Tool

Legacy-Befehle

Fehlerbehebung

"Änderung nicht gefunden"

"Keine Artefakte bereit"

"Schema nicht gefunden"

Befehle nicht erkannt

Artefakte werden nicht korrekt generiert

Nächste Schritte