OpenSpecSpezifikationsgetriebene Entwicklung für KI-Assistenten

Unsere Philosophie:

→ fließend, nicht starr
→ iterativ, nicht Wasserfall
→ einfach, nicht komplex
→ für Brownfield-Projekte, nicht nur Greenfield
→ skalierbar von persönlichen Projekten bis zu Unternehmen

Folgen Sie @0xTab auf X für Updates · Treten Sie dem OpenSpec Discord bei für Hilfe und Fragen.

Sehen Sie es in Aktion ​

Sie: /opsx:propose add-dark-mode
KI:  Erstellt openspec/changes/add-dark-mode/
     ✓ proposal.md — warum wir das tun, was sich ändert
     ✓ specs/       — Anforderungen und Szenarien
     ✓ design.md    — technischer Ansatz
     ✓ tasks.md     — Implementierungs-Checkliste
     Bereit zur Implementierung!

Sie: /opsx:apply
KI:  Implementiere Aufgaben...
     ✓ 1.1 Theme-Kontextanbieter hinzufügen
     ✓ 1.2 Umschaltkomponente erstellen
     ✓ 2.1 CSS-Variablen hinzufügen
     ✓ 2.2 localStorage verbinden
     Alle Aufgaben abgeschlossen!

Sie: /opsx:archive
KI:  Archiviert nach openspec/changes/archive/2025-01-23-add-dark-mode/
     Spezifikationen aktualisiert. Bereit für die nächste Funktion.

Schnellstart ​

Erfordert Node.js 20.19.0 oder höher.

Installieren Sie OpenSpec global:

npm install -g @fission-ai/openspec@latest

Navigieren Sie dann zu Ihrem Projektverzeichnis und initialisieren Sie:

cd your-project
openspec init

Sagen Sie nun Ihrem KI-Assistenten: /opsx:propose <was-sie-bauen-wollen>

Wenn Sie den erweiterten Workflow (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard) möchten, wählen Sie ihn mit openspec config profile aus und wenden Sie ihn mit openspec update an.

Dokumentation ​

→ Erste Schritte: erste Schritte
→ Workflows: Kombinationen und Muster
→ Befehle: Slash-Befehle & Skills
→ CLI: Terminal-Referenz
→ Unterstützte Tools: Tool-Integrationen & Installationspfade
→ Konzepte: wie alles zusammenpasst
→ Mehrsprachig: Mehrsprachige Unterstützung
→ Anpassung: Machen Sie es zu Ihrem

Warum OpenSpec? ​

KI-Coding-Assistenten sind leistungsstark, aber unvorhersehbar, wenn Anforderungen nur im Chatverlauf existieren. OpenSpec fügt eine leichte Spezifikationsebene hinzu, damit Sie sich darauf einigen, was gebaut werden soll, bevor Code geschrieben wird.

• Einigen Sie sich vor dem Bauen — Mensch und KI stimmen Spezifikationen ab, bevor Code geschrieben wird
• Bleiben Sie organisiert — jede Änderung erhält eigenen Ordner mit Vorschlag, Spezifikationen, Design und Aufgaben
• Arbeiten Sie fließend — aktualisieren Sie jedes Artefakt jederzeit, keine starren Phasen-Tore
• Nutzen Sie Ihre Tools — funktioniert mit 20+ KI-Assistenten über Slash-Befehle

Wie wir uns vergleichen ​

vs. Spec Kit (GitHub) — Gründlich, aber schwerfällig. Starre Phasen-Tore, viel Markdown, Python-Setup. OpenSpec ist leichter und lässt Sie frei iterieren.

vs. Kiro (AWS) — Leistungsstark, aber Sie sind an deren IDE gebunden und auf Claude-Modelle beschränkt. OpenSpec funktioniert mit den Tools, die Sie bereits verwenden.

vs. nichts — KI-Coding ohne Spezifikationen bedeutet vage Prompts und unvorhersehbare Ergebnisse. OpenSpec bringt Vorhersagbarkeit ohne den Aufwand.

OpenSpec aktualisieren ​

Paket aktualisieren

npm install -g @fission-ai/openspec@latest

Agenten-Anweisungen aktualisieren

Führen Sie dies in jedem Projekt aus, um die KI-Anleitung neu zu generieren und sicherzustellen, dass die neuesten Slash-Befehle aktiv sind:

openspec update

Verwendungshinweise ​

Modellauswahl: OpenSpec funktioniert am besten mit Modellen hoher Reasoning-Fähigkeit. Wir empfehlen Opus 4.5 und GPT 5.2 sowohl für Planung als auch Implementierung.

Kontexthygiene: OpenSpec profitiert von einem sauberen Kontextfenster. Leeren Sie Ihren Kontext vor Beginn der Implementierung und pflegen Sie eine gute Kontexthygiene während Ihrer gesamten Sitzung.

Mitwirken ​

Kleine Korrekturen — Bugfixes, Tippfehlerkorrekturen und kleinere Verbesserungen können direkt als PRs eingereicht werden.

Größere Änderungen — Für neue Funktionen, signifikante Refactorings oder architektonische Änderungen reichen Sie bitte zuerst einen OpenSpec-Änderungsvorschlag ein, damit wir uns über Absicht und Ziele einigen können, bevor die Implementierung beginnt.

Beim Schreiben von Vorschlägen beachten Sie bitte die OpenSpec-Philosophie: Wir dienen einer Vielzahl von Nutzern über verschiedene Coding-Agenten, Modelle und Anwendungsfälle hinweg. Änderungen sollten für alle gut funktionieren.

KI-generierter Code ist willkommen — solange er getestet und verifiziert wurde. PRs mit KI-generiertem Code sollten den verwendeten Coding-Agenten und das Modell erwähnen (z.B. „Generiert mit Claude Code unter Verwendung von claude-opus-4-5-20251101").

Entwicklung ​

• Abhängigkeiten installieren: pnpm install
• Bauen: pnpm run build
• Testen: pnpm test
• Lokal entwickeln: pnpm run dev oder pnpm run dev:cli
• Konventionelle Commits (einzeilig): type(scope): subject

Sonstiges ​

Lizenz ​

MIT