Spezifikationsgesteuerter Workflow
Definiere Anforderungen, bevor du Code schreibst.
OpenSpecSpezifikationsgesteuerte Entwicklung für KI-Assistenten
Eine leichtgewichtige Spezifikation für die Erstellung und Verwaltung von KI-Assistenten-Projekten.
Eine leichtgewichtige Spezifikation für die Erstellung und Verwaltung von KI-Assistenten-Projekten.
Willkommen. Dies ist die zentrale Anlaufstelle für alles rund um OpenSpec.
OpenSpec hilft dir und deinem KI-Code-Assistenten, sich darauf zu einigen, was gebaut werden soll, bevor auch nur eine Zeile Code geschrieben wird. Du beschreibst die Änderung, die KI erstellt einen kurzen Standard und eine Aufgabenliste, ihr beide schaut euch denselben Plan an und dann wird die Arbeit erledigt. Keine bösen Überraschungen mehr, wenn ihr erst zur Hälfte fertig seid und feststellt, dass die KI das Falsche gebaut hat.
Wenn du sonst nichts liest, lies diese beiden Seiten:
/opsx:propose eingibst (Tipp: in deinem KI-Chat, nicht im Terminal). Das verwirrt fast jeden einmal.Die zweite Seite ist wichtiger, als es scheint. OpenSpec besteht aus zwei Teilen: einem Kommandozeilen-Tool, das du in deinem Terminal ausführst, und Schrägstrich-Befehlen, die du an deinen KI-Assistenten gibst. Wenn du weißt, was was ist, sparst du dir die häufigste Verwirrung.
Die beste Gewohnheit, die du dir zuerst aneignen solltest: Wenn du nicht weißt, was du bauen sollst, fange mit
/opsx:explorean. Es ist ein risikofreier Denkpartner, der deinen Code liest, Optionen abwägt und eine vage Idee zu einem konkreten Plan verfeinert, bevor irgendwelche Artefakte oder Code existieren. Der Leitfaden Zuerst erkunden erklärt die Vorteile.
Ich bin neu hier. Fang mit Erste Schritte an, lies dann kurz die Grundkonzepte auf einen Blick. Wenn etwas unklar ist, findest du in der FAQ und dem Glossar schnell Antworten.
Ich habe ein Problem, aber keinen Plan. Das ist der häufigste Fall, und dafür gibt es eine eigene Anleitung: Zuerst erkunden. Nutze /opsx:explore, um die Sache gemeinsam mit der KI durchzudenken, bevor du dich auf etwas festlegst.
Ich habe eine große bestehende Codebasis. Du musst nicht alles dokumentieren. OpenSpec in einem bestehenden Projekt verwenden zeigt, wie du mit echtem, gewachsenem Code anfängst, ohne das gesamte Projekt auf einmal umkrempeln zu müssen.
Ich möchte es nur zum Laufen bringen. Installieren, führe openspec init aus und lies dann Funktionsweise von Befehlen, damit dein erster Schrägstrich-Befehl an der richtigen Stelle ankommt.
Ich lerne anhand von Beispielen. Die Seite Beispiele & Rezepte führt dich durch echte Änderungen von Anfang bis Ende: eine kleine Funktion, ein Bugfix, ein Refactoring, eine Erkundung.
Die KI hat gerade einen Entwurf für einen Plan erstellt – was jetzt? Lies ihn durch. Eine Änderung prüfen zeigt die zweiminütige Prüfung, die eine Fehlentscheidung abfängt, solange sie noch kostengünstig zu beheben ist, und Gute Standards schreiben erklärt, woraus ein genehmigungswürdiger Plan besteht.
Ich arbeite in einem Team. OpenSpec im Team zeigt, wie eine Änderung einem Branch und einem Pull Request zugeordnet wird und wie Teammitglieder einen Plan prüfen, bevor der Code geschrieben wird.
Ich komme vom alten Workflow. Der Migrationsleitfaden erklärt, was sich geändert hat und warum, und versichert, dass deine bestehende Arbeit sicher ist.
Ich möchte es an den Prozess meines Teams anpassen. Anpassung behandelt Projektkonfiguration, benutzerdefinierte Schemata und gemeinsamen Kontext.
Etwas funktioniert nicht. Fehlerbehebung sammelt die Fehler, die tatsächlich auftreten, mit passenden Lösungen.
| Doc | Was du damit bekommst |
|---|---|
| Erste Schritte | Installieren, initialisieren und deine erste Änderung vollständig durchführen |
| Zuerst erkunden | Nutze /opsx:explore, um eine Idee durchzudenken, bevor du dich festlegst |
| Funktionsweise von Befehlen | Wo Schrägstrich-Befehle ausgeführt werden, was "interaktiver Modus" bedeutet, Terminal vs. Chat |
| Grundkonzepte auf einen Blick | Das gesamte mentale Modell auf einer Seite: Standards, Änderungen, Deltas, Archiv |
| Installation | npm, pnpm, yarn, bun, Nix und wie du überprüfst, ob die Installation funktioniert hat |
| Doc | Was du damit bekommst |
|---|---|
| Workflows | Häufige Muster und wann du welchen Befehl nutzen solltest |
| Beispiele & Rezepte | Vollständige Anleitungen für echte Änderungen, zum Kopieren und Einfügen |
| Gute Standards schreiben | Wie eine starke Anforderung und ein Szenario aussehen und wie du die Größe einer Änderung richtig wählst |
| Eine Änderung prüfen | Die zweiminütige Prüfung eines Entwurfsplans, bevor auch nur Code geschrieben wird |
| OpenSpec im Team | Wie Änderungen zu Branches, Pull Requests und Prüfungen passen |
| OpenSpec in einem bestehenden Projekt verwenden | Einführung von OpenSpec in einem großen, gewachsenen Codebasis |
| Eine Änderung bearbeiten und iterieren | Artefakte aktualisieren, zurückgehen, manuelle Bearbeitungen abgleichen |
| Befehle | Referenz für alle /opsx:* Schrägstrich-Befehle |
| CLI | Referenz für alle openspec Terminal-Befehle |
| Doc | Was du damit bekommst |
|---|---|
| Konzepte | Die ausführliche Erklärung von Standards, Änderungen, Artefakten, Schemata und Archiv |
| OPSX-Workflow | Warum der Workflow flüssig statt phasenfixiert ist, plus ein Architektur-Deep-Dive |
| Glossar | Alle Begriffe an einem Ort definiert |
| Doc | Was du damit bekommst |
|---|---|
| Anpassung | Projektkonfiguration, benutzerdefinierte Schemata, gemeinsamer Kontext |
| Mehrsprachigkeit | Artefakte in anderen Sprachen als Englisch generieren |
| Unterstützte Tools | Die über 25 KI-Tools, mit denen OpenSpec integriert, und wo Dateien abgelegt werden |
| Doc | Was du damit bekommst |
|---|---|
| FAQ | Schnelle Antworten auf die häufigsten Fragen |
| Fehlerbehebung | Konkrete Lösungen für konkrete Fehler |
| Migrationsleitfaden | Umstellung vom alten Workflow auf OPSX |
| Doc | Was du damit bekommst |
|---|---|
| Stores: Benutzerhandbuch | Plane in einem eigenen Repo, wenn deine Arbeit sich über mehrere Repos oder Teams erstreckt |
| Agentenvertrag | Die maschinenlesbaren CLI-Oberflächen, die Agenten steuern |
1. Installieren npm install -g @fission-ai/openspec@latest
2. Initialisieren cd your-project && openspec init
3. Erkunden (in deinem KI-Chat) /opsx:explore ← optional, aber eine sehr gute Gewohnheit
4. Vorschlagen (in deinem KI-Chat) /opsx:propose add-dark-mode
5. Anwenden (in deinem KI-Chat) /opsx:apply
6. Archivieren (in deinem KI-Chat) /opsx:archiveDie Schritte 1 und 2 erfolgen in deinem Terminal. Der Rest läuft im Chat deines KI-Assistenten ab. Diese Aufteilung ist die einzige Sache, die es sich zu merken lohnt, und Funktionsweise von Befehlen erklärt genau, warum das so ist. Schritt 3 ist optional, aber wenn du unsicher bist, mit /opsx:explore anzufangen, ist die Gewohnheit, die sich am meisten lohnt.
openspec feedback "your message" sendet Feedback direkt von deinem Terminal aus (es öffnet ein GitHub-Issue).Hast du in dieser Dokumentation etwas gefunden, das falsch, veraltet oder verwirrend ist? Das ist ein Fehler. Öffne ein Issue oder einen PR. Verbesserungen an der Dokumentation gehören zu den wertvollsten Beiträgen, die du leisten kannst.