Spec Kit schreibt die Dokumente.In DotMD prüfst du sie.

Was GitHub Spec Kit ist

Spec Kit ist das Open-Source-Toolkit von GitHub für Spec-driven Development. Es ersetzt deinen Agenten nicht. Es bringt ein Kommandozeilenwerkzeug namens specify mit, das dein Projekt einrichtet, und eine Reihe von Befehlen, die du im Chat deines Agenten ausführst. Der Agent schreibt; Spec Kit gibt ihm die Schritte und die Struktur.

Es unterstützt viele Agenten, darunter Claude Code, Codex CLI und Cursor. Die vollständige Liste steht auf der Integrations-Seite von Spec Kit.

Installieren und initialisieren

Du brauchst Python 3.11 oder neuer und uv. Dann:

uv tool install specify-cli
specify init my-project --integration claude

Das Flag --integration nimmt den Schlüssel deines Agenten: claude für Claude Code, codex für Codex CLI, cursor-agent für Cursor. Auf der Seite von Spec Kit steht der Schlüssel jedes anderen Agenten.

Die Befehle, der Reihe nach

Du tippst sie im Chat des Agenten, nicht im Terminal:

1. /speckit-constitution
2. /speckit-specify: schreibt spec.md.
3. /speckit-plan: schreibt plan.md.
4. /speckit-tasks: schreibt tasks.md.
5. /speckit-implement: baut anhand der Aufgaben.
6. /speckit-converge

Die Schreibweise eines Befehls hängt vom Agenten ab: Manche nutzen /speckit.specify, andere einen Bindestrich oder ein $. Spec Kit erklärt die Formen für jeden Agenten in den Hinweisen zur Befehlsaufruf-Syntax.

Jeden Schritt in DotMD prüfen

Spec Kit bittet dich, jedes Ergebnis zu prüfen, bevor du weitermachst. DotMD macht daraus ein richtiges Review statt eines flüchtigen Blicks im Terminal.

1. Projekt öffnen

   Drücke ⌘O und wähle den Projektordner. Die Dateien, die Spec Kit schreibt, erscheinen in der Seitenleiste, sobald sie entstehen, gerendert mit Überschriften, Listen und Tabellen.

2. Die genaue Zeile kommentieren

   Lies spec.md, markiere eine falsche oder vage Anforderung und drücke ⌥⌘M. Schreibe, was sich ändern soll. Kommentare verwahrt DotMD, nicht die Datei.

3. Den Agenten korrigieren lassen

   Sag dem Agenten: „Geh meine Kommentare in DotMD durch.“ Er liest sie über MCP und bearbeitet die Datei. Jede Korrektur steht neben ihrem Kommentar, der alte Text rot, der neue grün. Übernimm oder öffne jede wieder.

4. Erst dann den nächsten Befehl ausführen

   Stimmt die Spec, führe /speckit-plan aus und wiederhole das für Plan und Aufgaben. Ein Fehler, der in der Spec auffällt, kostet einen Kommentar; im Code kostet er eine Überarbeitung.

tasks.md prüfen

Die Aufgabenliste ist eine Markdown-Checkliste, und DotMD zeigt Aufgabenlisten mit ihren Kästchen, sodass du auf einen Blick siehst, was erledigt ist und was noch fehlt. Lies die Aufgaben vor /speckit-implement so, wie der Agent sie liest: der Reihe nach, jede klein, keine fehlt. Hast du den Analyse-Schritt von Spec Kit ausgeführt, behandle seine Befunde genauso: Öffne sie in DotMD und kommentiere die, mit denen du nicht einverstanden bist.

Den Agenten mit DotMD zu verbinden braucht eine Zeile; die Anleitungen für Claude Code, Codex und Cursor zeigen sie.

Warum jede Datei prüfen

Spec Kit ist schnell: ein Befehl, und ein ganzes Dokument erscheint. Diese Geschwindigkeit ist das Risiko. Steckt in der Spec eine falsche Anforderung und du führst den nächsten Befehl aus, ohne zu lesen, bauen Plan und Aufgaben darauf auf, und der Code auch. spec.md einmal sorgfältig zu lesen ist die günstigste Prüfung im ganzen Ablauf.

Fragen zu Spec Kit

Weitere Fragen