spec-gatekeeper

Führt ein fokussiertes 4-Fragen-Entwicklerinterview durch und erstellt eine deterministische 4-Abschnitts-SPEC.md (Umfang & Sicherheit, Datenverträge, Grenzfälle, Abnahmekriterien), bevor Quellcode geschrieben wird.

Was ist spec-gatekeeper?

Diese Fertigkeit implementiert einen spezifikationsgetriebenen Entwicklungs-Workflow (Spec-Driven Development, SDD), der die Klarheit sicherstellt und Drift eliminiert, indem ein strukturierter, vereinbarter Architekturvertrag vor der Implementierung erforderlich ist. Sie führt ein strukturiertes 4-Fragen-Interview durch, das die Bereiche Umfang & Sicherheit, Datenverträge, Grenzfälle und Abnahmekriterien abdeckt. Basierend auf den Antworten wird eine SPEC.md-Datei erstellt oder aktualisiert, die mindestens 300 UTF-8-Byte umfassen und kanonische Abschnittsüberschriften für die vier genannten Bereiche enthalten muss. Diese Fertigkeit ist ideal für Plattformen wie Claude Code, Cursor und Codex und schafft einen deterministischen Gatekeeper-Mechanismus, der die Code-Erstellung erst nach der Validierung der Spezifikation zulässt. Nach der Überprüfung und Freigabe durch den Entwickler wird die Implementierung freigegeben.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dansierrasam79/spec-gatekeeper/tree/main/skills/spec-gatekeeper

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Spec-Gatekeeper: Spezifikationsgetriebener Entwicklungs-Workflow

Verwenden Sie diese Fertigkeit immer dann, wenn ein Quellcode-Schreibvorgang durch spec-gatekeeper blockiert wird, oder wenn Sie ein neues Feature, einen neuen Dienst oder eine größere Refaktorisierung beginnen.

Spezifikationsgetriebene Entwicklung (SDD) stellt Klarheit sicher und eliminiert Drift, indem ein vereinbarter, strukturierter Architekturvertrag vor der Implementierung erforderlich ist.


Arbeitsschritte

Schritt 1: Durchführung des 4-Fragen-Entwicklerinterviews

Bevor Sie Code schreiben oder Dateien anlegen, stellen Sie dem Entwickler die folgenden 4 fokussierten Fragen (oder extrahieren Sie Antworten aus vorhandenen Anforderungen und bitten Sie um Bestätigung):

  1. Umfang & Sicherheit:

    • Was sind die Kernziele und expliziten Nicht-Ziele dieser Aufgabe?
    • Welche Architekturkomponenten oder Systemgrenzen sind betroffen?
    • Welche Sicherheits-, Berechtigungs-, Authentifizierungs- oder Sandbox-Einschränkungen gibt es?
  2. Datenverträge:

    • Was sind die genauen Schemata, API-Schnittstellen, Typen und Protokollformen?
    • Was sind die präzisen Eingabeparameter und erwarteten Ausgabe-Payloads?
  3. Grenzfälle & Resilienz:

    • Was sind die wichtigsten Fehlermodi, Netzwerk-/IO-Unterbrechungen und fehlerhaften Eingaben?
    • Welche Fehlerbehandlungs-, Validierungs- und Fallback-Mechanismen müssen vorhanden sein?
  4. Abnahmekriterien:

    • Welche deterministische Verifikationsmatrix und Testfälle definieren „Fertig“?
    • Wie wird jedes Abnahmekriterium validiert?

Schritt 2: SPEC.md erstellen

Erstellen oder aktualisieren Sie SPEC.md im aufgelösten Projektstammverzeichnis (<repo_root>/SPEC.md).

Erforderliche Struktur

Die Spezifikationsdatei muss folgende Anforderungen erfüllen:

  1. Größenanforderung: Mindestens 300 UTF-8 Bytes an substanziellem Inhalt.
  2. Kanonische Abschnittsüberschriften: Markdown-Überschriften der Ebene 1 bis 3 außerhalb von Codeblöcken, die jedem der 4 erforderlichen Abschnitte entsprechen:
    • Umfang & Sicherheit: Überschriften, die Scope, Security, Architecture, Overview, Boundaries, Threat Model oder Permissions enthalten.
    • Datenverträge: Überschriften, die Data Contract, Data Contracts, Schema, Schemas, Interface, Interfaces, API, Types, Payload oder Protocol enthalten.
    • Grenzfälle: Überschriften, die Edge Case, Edge Cases, Error Handling, Failure Mode, Failure Modes, Resilience, Constraints oder Fallbacks enthalten.
    • Abnahmekriterien: Überschriften, die Acceptance Criteria, Acceptance Test, Test Matrix, Verification, Testing, Definition of Done oder Validation enthalten.

Vorlage

# Spezifikation: <Feature- oder Dienstname>

## 1. Umfang & Sicherheit
### Ziele & Architekturgrenzen
- Detaillierte Beschreibung des Umfangs...
### Sicherheit & Bedrohungsmodell
- Berechtigungsprüfungen und Sicherheitsgrenzen...

## 2. Datenverträge
### Schemata & Schnittstellen
- Typen, API-Signaturen, Anfrage-/Antwortformate...

## 3. Grenzfälle & Resilienz
### Fehlerbehandlung & Fallbacks
- Randbedingungen, Eingabevalidierung, Fehlermodi...

## 4. Abnahmekriterien
### Verifikation & Testmatrix
- AT-01: ...
- AT-02: ...

Schritt 3: Entwickler-Freigabe & Implementierung

  1. Legen Sie den Entwurf der SPEC.md dem Entwickler zur Überprüfung und expliziten Freigabe vor.
  2. Sobald SPEC.md committet und gültig ist (>= 300 Bytes mit allen 4 Abschnitten), erlaubt der spec-gatekeeper-Hook automatisch das Schreiben von Implementierungsquelldateien.

Verwandte Skills