spec-driven-development
von addyosmanispec-driven-development ist ein Workflow-Skill zum Schreiben von Spezifikationen vor dem Code. Anschließend geht es in klar getrennten Phasen durch Planung, Aufgaben und Implementierung, jeweils mit menschlicher Prüfung an jedem Schritt.
Dieser Skill erreicht 74/100 und ist damit ein solides, aber nicht erstklassiges Listing. Für Nutzer des Verzeichnisses heißt das: Er ist für Agents mit Spec-First-Workflow tatsächlich nützlich und bietet genug Struktur, um Rätselraten zu reduzieren. Allerdings fehlen begleitende Dateien und gebündelte Anleitungen, die die Einführung reibungsloser machen würden.
- Klare Einsatzlogik: geeignet, wenn ein neues Projekt, eine neue Funktion oder eine unklare Änderung beginnt, und ausdrücklich nicht für triviale Fixes.
- Starker operativer Ablauf: vier abgesicherte Phasen (Specify → Plan → Tasks → Implement) mit menschlicher Prüfung nach jedem Schritt.
- Gute praktische Tiefe: umfangreicher SKILL.md-Inhalt mit mehreren Überschriften, Einschränkungen und Codebeispielen, wodurch der Prozess für einen Agenten leichter nachvollziehbar wird.
- Keine Begleitdateien und kein Installationsbefehl: Die Einführung hängt fast vollständig von den Anweisungen in SKILL.md ab.
- Auslieferung als Einzeldatei: keine Skripte, Referenzen oder Ressourcen, die den Workflow absichern oder Sonderfälle abdecken.
Überblick über das spec-driven-development-Skill
spec-driven-development ist ein Workflow-Skill, mit dem Sie zuerst eine klare Spezifikation schreiben und diese Spezifikation dann für Planung, Aufgaben und Implementierung nutzen. Das spec-driven-development-Skill eignet sich besonders gut, wenn Sie eine neue Funktion starten, die Architektur ändern oder mit vagen Anforderungen arbeiten und im späteren Build möglichst wenige Annahmen zulassen möchten.
Wofür dieses Skill gedacht ist
Nutzen Sie diesen spec-driven-development-Leitfaden, wenn das Hauptrisiko darin besteht, das Falsche zu bauen — nicht nur etwas schlecht zu bauen. Er hilft dabei, aus einer groben Idee eine gemeinsame verlässliche Grundlage zu machen, die Umfang, Verhalten, Einschränkungen und Akzeptanzkriterien festlegt, bevor Sie sich an die Implementierung binden.
Wann sich der Einsatz besonders lohnt
Dieses Skill passt zu Teams und Einzelentwicklern, die enger mit einem menschlichen Reviewer abgestimmt arbeiten möchten, vor allem wenn sich eine Aufgabe über mehrere Dateien erstreckt, von Produktentscheidungen abhängt oder groß genug ist, dass „einfach coden“ später Nacharbeit erzeugt. Es ist auch nützlich für spec-driven-development für Skill Authoring, wenn das Skill selbst disziplinierte, überprüfbare Ergebnisse erzeugen soll.
Was es unterscheidet
Der eigentliche Wert liegt im abgestuften Workflow: spezifizieren, dann planen, dann Aufgaben ableiten, dann implementieren — mit menschlicher Prüfung an jeder Stufe. Das macht es stärker als einen generischen Prompt, weil versteckte Annahmen reduziert und Entscheidungspunkte nach vorn verlagert werden, wenn Änderungen noch günstiger sind.
So nutzen Sie das spec-driven-development-Skill
Installation und Kontext laden
Für die spec-driven-development-Installation fügen Sie das Skill zu Ihrem Agent-Setup hinzu und öffnen dann zuerst die Skill-Datei:
npx skills add addyosmani/agent-skills --skill spec-driven-development
Lesen Sie anschließend zuerst SKILL.md. Dieses Repository enthält keine unterstützenden Ordner wie rules/, references/ oder scripts/, daher liegt der Kontext des Skills fast vollständig in der zentralen Skill-Datei.
Geben Sie dem Skill einen konkreten Ausgangspunkt
Das spec-driven-development-Nutzungsmuster funktioniert am besten, wenn Sie ein Ziel, Einschränkungen und bekannte Unbekannte mitgeben. Schwache Eingaben klingen wie „erstelle ein Dashboard“. Starke Eingaben klingen eher so:
„Erstelle eine Spezifikation für ein Dashboard, das den Zustand von Abonnements anzeigt, rollenbasierten Zugriff unterstützt und mit unserer bestehenden REST API funktionieren muss. Stelle vor dem Entwurf der Spezifikation klärende Fragen. Schlage noch keine Implementierungsdetails vor.“
Damit hat das Skill genug Kontext, um Annahmen sichtbar zu machen und vorschnelle Designentscheidungen zu vermeiden.
Folgen Sie dem abgestuften Workflow
Das Skill ist so angelegt, dass es in jeder Phase stoppt, bis die Ergebnisse validiert sind. Praktisch heißt das:
- Problem und Annahmen spezifizieren.
- Den Ansatz erst nach Freigabe der Spezifikation planen.
- Den Plan in Aufgaben zerlegen.
- Erst nach Prüfung der Aufgaben implementieren.
Wenn Sie Prüfschleifen überspringen, verlieren Sie den Hauptvorteil des Skills: weniger Nacharbeit durch nicht getestete Annahmen.
Erst lesen, dann anwenden
Beginnen Sie mit SKILL.md und nutzen Sie dann die Abschnitte zu Überblick, Einsatzszenarien und abgestuftem Workflow als Arbeitsregeln. Wenn Sie das für Ihren eigenen Agentenfluss anpassen, bewahren Sie die Review-Punkte und das Prinzip „so lange nachfragen, bis es konkret ist“, denn genau diese Teile verbessern die Ausgabequalität am ehesten.
FAQ zum spec-driven-development-Skill
Ist spec-driven-development besser als ein normaler Prompt?
Meistens ja, wenn die Aufgabe unklar, querschnittlich oder teuer in der Nacharbeit ist. Ein normaler Prompt kann schneller Code erzeugen, aber spec-driven-development ist besser, wenn Sie erst Einigkeit darüber brauchen, was gebaut werden soll, bevor jemand mit dem Coden beginnt.
Wann sollte ich es nicht verwenden?
Nutzen Sie das spec-driven-development-Skill nicht für triviale Änderungen, offensichtliche Bugfixes oder in sich geschlossene Anpassungen ohne echte Produktunschärfe. In solchen Fällen kann der Overhead eines vollständigen Spezifikationszyklus langsamer sein als die eigentliche Arbeit.
Ist das anfängerfreundlich?
Ja, wenn Sie bereit sind, klärende Fragen zu beantworten und Entwürfe zu prüfen. Das Skill ist einfacher zu verwenden, als einen eigenen Prozess zu erfinden, weil es den Agenten anweist, zu pausieren, Annahmen offenzulegen und die Phasen in der richtigen Reihenfolge zu durchlaufen.
Passt das zu Skill-Authoring-Workflows?
Ja, besonders für spec-driven-development für Skill Authoring, wenn Sie einen wiederholbaren Prozess zum Schreiben eines neuen Skills oder zum Weiterentwickeln eines bestehenden Skills möchten. Es ist vor allem dann nützlich, wenn die Autorungsaufgabe einen klaren Umfang, Review-Gates und eine Spezifikation braucht, die vor der Implementierung validiert werden kann.
So verbessern Sie das spec-driven-development-Skill
Geben Sie von Anfang an präzisere Eingaben
Die besten Ergebnisse entstehen, wenn Sie Zielgruppe, gewünschtes Ergebnis, Einschränkungen und die noch offenen Punkte benennen. Zum Beispiel: „Migriere den Checkout-Flow, ohne die öffentliche API zu ändern, erhalte bestehende Analytics-Events und identifiziere vor der Planung eventuelle Abhängigkeitsrisiken.“
Zwingen Sie das Skill, Annahmen zu benennen
Ein häufiger Fehler sind vage Spezifikationen, die vollständig wirken, aber kritische Entscheidungen verschleiern. Bitten Sie das Modell, vor dem Entwurf der Spezifikation Annahmen aufzulisten, und prüfen Sie diese Annahmen anschließend mit dem menschlichen Engineer, bevor Sie zur Planung übergehen. Genau dort spart spec-driven-development meist am meisten Zeit.
Iterieren Sie an der Spezifikation, nicht am Code
Wenn der erste Durchlauf nicht passt, korrigieren Sie Umfang, Akzeptanzkriterien oder Einschränkungen, bevor Sie nach Implementierung fragen. Der Workflow funktioniert am besten, wenn jede Überarbeitung den Vertrag präzisiert, denn die späteren Phasen hängen direkt von der Genauigkeit der Spezifikation ab.
Setzen Sie es dort ein, wo Reviews teuer sind
Am wertvollsten ist das Skill, wenn falsche Annahmen teuer würden: Änderungen über mehrere Dateien, Architekturwechsel oder Funktionen mit Auswirkungen auf mehrere Stakeholder. Wenn der erste Entwurf Ihrer Spezifikation noch zu vage ist, bleiben Sie lieber länger in der Spezifikationsphase, statt zu früh Aufgaben oder Code zu erzwingen.