OpenSpec: Anforderungen mit KI klären, bevor Code entsteht

Zweck

Bei der Entwicklung mit KI verteilen sich Anforderungen leicht auf mehrere Chats. Eine Verhaltensweise, die heute erhalten bleiben soll, kann bei der nächsten Änderung übersehen werden. OpenSpec hält Anforderungen, Entwurfsentscheidungen und Aufgaben in Projektdateien fest, damit du den Plan prüfen kannst, bevor die KI ihn umsetzt.

Das Werkzeug für spezifikationsgeleitete Entwicklung verbindet eine CLI mit mehreren Agent Skills. Du kannst es in deinem bisherigen KI-Entwicklungswerkzeug nutzen, ohne den Editor zu wechseln. Das offizielle Projekt stellt den Quellcode unter der MIT-Lizenz bereit.

Einsatzbereiche

Wir halten OpenSpec für einen Versuch wert, wenn eine Funktion mehrere Gespräche erfordert, sich über verschiedene Chats erstreckt oder klare Abnahmekriterien hat. Die Anforderungen bleiben im Projekt und stehen beim Fortsetzen der Arbeit zum Vergleich bereit.

Bei einer Änderung an nur einem Satz kann ein vollständiger Änderungsplan aufwendiger sein als die direkte Korrektur. Ob du diesen Ablauf nutzt, kannst du nach dem Umfang der Änderung entscheiden. Das ist eine redaktionelle Einschätzung auf Grundlage der offiziellen Dokumentation, kein Ergebnis eigener Tests oder eines Leistungsvergleichs.

Anwendungsbeispiel

Für ein Agent-Skills-Verzeichnis könntest du der KI zuerst sagen:

Hilf mir zu erkunden, wie wir ein Agent-Skills-Verzeichnis aufbauen. Ich möchte eigene und ausgewählte externe Skills aufnehmen, nach Kategorien filtern und nach Datum sortieren. Kläre zuerst die Anforderungen; schreibe noch keinen Code.

Der offizielle Schnelleinstieg beschreibt fünf Schritte für eine Änderung:

Erkunden: Anforderungen besprechen, vorhandenen Code lesen und Ansätze vergleichen, ohne Code zu schreiben.
Vorschlagen: Grund, Anforderungen und Aufgaben festhalten; bei technischen Entscheidungen einen Entwurf ergänzen.
Menschliche Prüfung: Umfang und Abnahmekriterien vor der Umsetzung überprüfen und den Plan korrigieren.
Umsetzen: Die KI die Aufgaben anhand der Dateien erledigen lassen.
Archivieren: Fertige Anforderungen in die Hauptspezifikationen übernehmen und die Änderung dokumentieren.

Für den direkten Aufruf der Erkundung verwendest du in Codex $openspec-explore und in Claude Code /opsx:explore. Die Aufrufsyntax unterscheidet sich je nach Werkzeug. Prüfe die Hinweise bei der Initialisierung und die Dokumentation der unterstützten Werkzeuge.

Einschränkungen

Spezifikationen brauchen weiterhin eine menschliche Prüfung. Eine falsche Anforderung wird durch das Speichern in einer Datei nicht richtig. OpenSpec garantiert keine korrekte KI-Ausgabe und ersetzt weder Softwaretests noch menschliche Reviews.

Unterstützte Plattformen, Installationswege und Befehle können sich mit neuen Versionen ändern. Codex, Claude Code, Cursor und GitHub Copilot sind hier Beispiele; die vollständige Liste steht in der offiziellen Dokumentation.

Installation

Für die Installation mit npm benötigst du Node.js 22.12.0 oder neuer. Führe danach aus:

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

Sobald eine Versionsnummer erscheint, wechsle in dein Projektverzeichnis und initialisiere OpenSpec:

cd your-project
openspec init

Ersetze your-project durch deinen Projektpfad und wähle nach Aufforderung die verwendeten KI-Werkzeuge aus. Anschließend kannst du die KI Anforderungen erkunden oder eine Änderung vorschlagen lassen. Die offizielle Anleitung bietet auch einen eigenständigen Installer und Homebrew; der eigenständige Installer benötigt kein Node.js. Weitere Wege und Aktualisierungsschritte stehen in der Installationsanleitung.