Wie Befehle funktionieren

Die eine Sache, die man wissen muss: OpenSpec hat zwei Arten von Befehlen, und sie werden an zwei verschiedenen Orten ausgeführt.

• openspec ... Befehle werden in Ihrem Terminal ausgeführt. (Beispiel: openspec init.)
• /opsx:... Befehle werden im Chat Ihres KI-Assistenten ausgeführt. (Beispiel: /opsx:propose.)

Wenn Sie jemals /opsx:propose in Ihr Terminal eingeben und nichts passiert, ist dies der Grund. Sie sprechen mit der falschen Hälfte von OpenSpec. Slash-Befehle sind keine Terminalbefehle. Sie sind Anweisungen, die Sie Ihrem KI-Coding-Assistenten geben, in derselben Chatbox, in der Sie normalerweise „add a login form“ tippen würden.

Diese einzelne Unterscheidung ist die häufigste Stolperfalle für neue Benutzer, also machen wir das ganz deutlich.

Die beiden Hälften

OpenSpec ist ein Projekt, das zwei Hüte trägt.

Die CLI (Terminal-Hälfte). Ein Programm namens openspec, das Sie installieren und von Ihrer Shell aus ausführen. Es richtet Ihr Projekt ein, listet und validiert Änderungen, zeigt ein Dashboard an und archiviert abgeschlossene Arbeiten. Diese geben Sie in iTerm, das VS Code-Terminal, PowerShell oder überall dort ein, wo Sie auch git oder npm ausführen würden.

openspec init        # Richten Sie OpenSpec in diesem Projekt ein
openspec list        # Sehen Sie aktive Änderungen
openspec view        # Öffnen Sie das interaktive Dashboard

Die Slash-Befehle (Chat-Hälfte). Kurze Befehle wie /opsx:propose und /opsx:apply, die Sie in Ihren KI-Assistenten eingeben. Diese weisen die KI an, den OpenSpec-Arbeitsablauf zu befolgen: einen Vorschlag entwerfen, Spezifikationen schreiben, basierend auf der Aufgabenliste erstellen und bei Fertigstellung archivieren. Diese geben Sie in Claude Code, Cursor, Devin Desktop, Copilot oder whichever assistant you use ein.

/opsx:propose add-dark-mode    (in Ihrem KI-Chat eingegeben)
/opsx:apply                    (in Ihrem KI-Chat eingegeben)
/opsx:archive                  (in Ihrem KI-Chat eingegeben)

Hier ist das mentale Modell in einem Bild:

        IHR TERMINAL                          CHAT IHRES KI-ASSISTENTEN
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   installiert │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   Befehle     │  /opsx:archive                │
   └──────────────────────┘    & Fähigkeiten│                              │
        Führen Sie openspec hier aus           Führen Sie /opsx:* hier aus

Bemerken Sie den Pfeil. Das Ausführen von openspec init in Ihrem Terminal ist das, was die Slash-Befehle in Ihr KI-Tool installiert. Die Terminalhälfte richtet die Chat-Hälfte ein. Danach findet die tägliche Steuerung hauptsächlich im Chat statt.

„Wie starte ich den interaktiven Modus?“

Es gibt keinen separaten interaktiven Modus, den man starten müsste. Diese Frage taucht häufig auf, daher verdient sie eine klare Antwort.

Sie betreten keinen speziellen OpenSpec-Modus. Sie öffnen einfach Ihren KI-Coding-Assistenten wie immer und geben einen Slash-Befehl in den Chat ein. Der Slash-Befehl ist die Art und Weise, wie Sie „OpenSpec betreten“. Ihr Assistent erkennt ihn, lädt die passende OpenSpec-Fähigkeit und beginnt, den Arbeitsablauf zu befolgen.

Die eigentlichen Anweisungen lauten also:

1. Öffnen Sie Ihren KI-Coding-Assistenten (Claude Code, Cursor, Devin Desktop usw.) in Ihrem Projekt.
2. Geben Sie /opsx:propose in dessen Chat ein, genau an der Stelle, an der Sie jede andere Anfrage eingeben.
3. Beobachten Sie die Autovervollständigung: Wenn OpenSpec installiert ist, sehen Sie /opsx:propose, /opsx:apply und weitere Vorschläge erscheinen, während Sie den Slash eingeben.

Das war's. Kein Modus zum Umschalten, kein Daemon zum Starten, kein separates Fenster.

Eines ist jedoch wirklich interaktiv und lebt im Terminal: openspec view. Es öffnet ein Dashboard zum Durchsuchen Ihrer Spezifikationen und Änderungen. Aber das ist nur ein Viewer, nicht das Werkzeug, mit dem Sie vorschlagen und bauen. Das Erbauen geschieht durch Slash-Befehle im Chat.

Warum diese Aufteilung existiert

Es lohnt sich, dies zu verstehen, da es erklärt, warum OpenSpec mit über 30 verschiedenen KI-Tools funktioniert.

Die CLI ist der Motor. Sie kennt die Regeln: Wie ein Änderungsordner aussieht, welche Artefakte von welchen abhängen, wie man ein Delta-Spec in Ihre Quelle der Wahrheit zusammenführt. Sie ist überall gleich.

Die Slash-Befehle sind das Lenkrad, und jedes KI-Tool hat ein leicht anderes. Claude Code nennt sie Befehle. Cursor und Devin Desktop haben ihre eigenen Formate. Einige Tools nennen sie Fähigkeiten (Skills). Wenn Sie openspec init ausführen, generiert OpenSpec die richtige Art von Datei für jedes von Ihnen ausgewählte Tool, sodass dieselbe Absicht von /opsx:propose unabhängig davon funktioniert, welchen Assistenten Sie bevorzugen.

Die Stärke dieses Designs: Sie lernen den Arbeitsablauf einmal kennen und tragen ihn über Tools hinweg. Der Nachteil: Die genaue Syntax eines Befehls kann zwischen den Tools leicht abweichen, was der nächste Abschnitt behandelt.

Slash-Befehlssyntax nach Tool

Die Absicht ist überall identisch. Die Schreibweise folgt der Datei, die Ihr Tool lädt.

Befehlsdatei Ihres Tools	So geben Sie es ein	Beispieltools
.../commands/opsx/<id>.*	/opsx:propose	Claude Code, Gemini CLI, Crush
.../opsx-<id>.*	/opsx-propose	Cursor, GitHub Copilot (IDE), Devin Desktop, Trae, Oh My Pi
.amazonq/prompts/opsx-<id>.md	@opsx-propose	Amazon Q Developer
keine — nur Fähigkeiten	/openspec-propose	CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, gemeinsame .agents
keine — Kimi Code	/skill:openspec-propose	Kimi Code
keine — Codex CLI	$openspec-propose	Codex

Devin ist das einzige Tool, das zwei Zeilen abdeckt. Devin Desktop liest .devin/workflows/, daher funktioniert dort /opsx-propose; Devin Local tut dies nicht, also verwenden Sie auf diesem Agent stattdessen die Fähigkeit /openspec-propose. Die Fähigkeiten, die OpenSpec in .devin/skills/ schreibt, funktionieren auf beiden, weshalb sie sich gegenseitig über den Fähigkeitsnamen referenzieren.

Jedes Tool ist in So rufen Sie auf aufgelistet — diese Tabelle ist die maßgebliche. Zwei Zeilen sind überhaupt keine Slash-Befehle: Amazon Q lädt seine Dateien in eine Prompt-Bibliothek, die mit @ aufgerufen wird, und die letzten drei Zeilen verwenden den Fähigkeitsnamen, was nicht die Befehls-ID ist (/opsx:apply ist die Fähigkeit openspec-apply-change).

Im Zweifelsfall lesen Sie die Zeile „Getting started“, die openspec init ausgegeben hat: Sie verwendet bereits die Form, die Ihre Tools registriert haben. Das Eingeben eines Slashes und Beobachten der Autovervollständigung funktioniert ebenfalls für die Tools, die überhaupt Slash-Befehle anzeigen.

Wie die Befehle dorthin gelangten: Fähigkeiten und Befehle

Wenn Sie openspec init (oder openspec update) ausführen, schreibt OpenSpec kleine Dateien in Ihr Projekt, damit Ihr KI-Tool den Arbeitsablauf finden kann. Abhängig von Ihrem Tool und den Einstellungen sind dies Fähigkeiten (Skills), Befehle oder beides.

• Fähigkeiten befinden sich an Orten wie .claude/skills/openspec-*/SKILL.md. Sie sind der entstehende toolübergreifende Standard: Ein Ordner mit Anweisungen, den Ihr Assistent automatisch erkennt.
• Befehle befinden sich an Orten wie .cursor/commands/opsx-<id>.md oder .claude/commands/opsx/<id>.md — das Layout entspricht dem des Tools, und es entscheidet, wie Sie den Befehl eingeben. Sie sind die älteren pro-Tool-Slash-Befehlsdateien. Codex erhält keine generierten Befehlsdateien; verwenden Sie .agents/skills/openspec-*.

Sie müssen sich nicht darum kümmern, welches Ihr Tool verwendet. Sie geben einfach den Slash-Befehl ein, und er funktioniert. Aber zu wissen, dass diese Dateien existieren, hilft, wenn etwas schiefgeht: Wenn Ihre Befehle verschwinden, bedeutet dies meist, dass diese Dateien fehlen oder veraltet sind, und openspec update regeneriert sie.

Sehen Sie Unterstützte Tools für die genauen Pfade pro Tool und Migrationsleitfaden für die Art und Weise, wie Fähigkeiten den älteren, nur auf Befehlen basierenden Ansatz ersetzt haben.

Bestätigen, dass es installiert ist

Schnelle Checks, schnellste zuerst:

1. Geben Sie einen Slash in Ihren KI-Chat ein. Beginnen Sie mit der Eingabe von /opsx und achten Sie auf Autovervollständigungsvorschläge. Wenn diese erscheinen, sind Sie bereit. Bei einem Tool, das nur Fähigkeiten unterstützt (Codex, Kimi Code, CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent oder das gemeinsame .agents-Ziel), wird /opsx selbst bei einer gesunden Installation nie vervollständigt — versuchen Sie stattdessen den Fähigkeitsnamen aus der obigen Tabelle.
2. Suchen Sie nach den Dateien. Für Claude Code prüfen Sie, ob .claude/skills/ Ordner mit dem Muster openspec-* enthält. Andere Tools verwenden ihre eigenen Verzeichnisse (Unterstützte Tools listet diese auf).
3. Führen Sie die Einrichtung erneut aus. Führen Sie vom Stammverzeichnis Ihres Projekts aus openspec update aus. Dies regeneriert die Fähigkeit- und Befehlsdateien für alle konfigurierten Tools.
4. Starten Sie Ihren Assistenten neu. Viele Tools scannen beim Start nach Fähigkeiten und Befehlen, daher kann ein frisches Fenster der fehlende Schritt sein.

Welche Befehle habe ich überhaupt?

Standardmäßig installiert OpenSpec den Satz von Core-Slash-Befehlen:

• /opsx:explore: Überlegen Sie sich eine Idee mit der KI, bevor Sie sich für eine Änderung entscheiden (ein guter erster Schritt, wenn Sie unsicher sind)
• /opsx:propose: Erstellen Sie eine Änderung und entwerfen Sie alle Planungsartefakte in einem Schritt
• /opsx:apply: Bauen Sie die Änderung, indem Sie die Aufgabenliste durchgehen
• /opsx:update: Überarbeiten Sie die Planungsartefakte einer Änderung und halten Sie sie kohärent
• /opsx:sync: Zusammenführen der Spec-Updates einer Änderung in Ihre Hauptspecs (meist automatisch)
• /opsx:archive: Beenden Sie eine Änderung und archivieren Sie sie

Ein guter Standardrhythmus: explore, wenn Sie herausfinden, was zu tun ist, dann propose, apply, archive. Der Leitfaden Erst erkunden erklärt, warum dieser erste Schritt sich auszahlt.

Es gibt auch einen erweiterten Satz für Personen, die mehr Kontrolle wünschen (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:bulk-archive, /opsx:onboard). Sie aktivieren ihn mit openspec config profile und wenden ihn mit openspec update an.

Neu in all dem? /opsx:onboard (im erweiterten Satz) führt Sie durch eine vollständige Änderung an Ihrem eigenen Codebase und kommentiert jeden Schritt. Es ist die freundlichstmögliche Einführung.

Dafür, was jeder Befehl im Detail tut, siehe Befehle. Dafür, wann Sie welchen Befehl verwenden sollten, siehe Workflows.

Eine saubere Erstinstallation

Zusammengesetzt ist hier die gesamte Sequenz, wobei jeder Schritt mit der Kennzeichnung versehen ist, wo er stattfindet.

TERMINAL   $ npm install -g @fission-ai/openspec@latest
TERMINAL   $ cd your-project
TERMINAL   $ openspec init
              (installiert Slash-Befehle in Ihr KI-Tool)

KI-CHAT      /opsx:explore
              (optional: denken Sie die Idee zuerst mit der KI durch)

KI-CHAT      /opsx:propose add-dark-mode
              (KI entwirft Vorschlag, Specs, Design, Aufgaben)

KI-CHAT      /opsx:apply
              (KI baut es, abhaken der Aufgaben)

KI-CHAT      /opsx:archive
              (Änderung wird in Ihre Specs zusammengeführt und archiviert)

Zwei Terminal-Schritte zur Einrichtung. Dann leben Sie im Chat. Das ist der Rhythmus.

Verwandt

• Erste Schritte: Der vollständige Durchlauf der ersten Änderung
• Befehle: Jeder Slash-Befehl im Detail
• CLI: Jeder Terminalbefehl im Detail
• Unterstützte Tools: Pro-Tool-Syntax und Dateispeicherorte
• FAQ: Weitere schnelle Antworten
• Fehlerbehebung: Lösungen, wenn Befehle nicht angezeigt werden