Communitygithub.com

tangjuyo/reels-blocker

Erstellen oder Aktualisieren einer Funktionsspezifikation aus einer natürlichsprachlichen Funktionsbeschreibung.

Was ist reels-blocker?

Diese Fähigkeit ermöglicht es, aus einer einfachen natürlichsprachlichen Beschreibung eine vollständige Funktionsspezifikation zu generieren oder zu aktualisieren. Sie ist besonders nützlich für Entwickler und Produktteams, die schnell und konsistent Spezifikationen für neue Funktionen erstellen möchten. Sie unterstützt die Plattformen Claude Code, Cursor und andere KI-Agenten, die mit dem Speckit-Workflow arbeiten. Der Prozess umfasst die Analyse der Benutzereingabe, die Erstellung eines Kurznamens, eine optionale Branch-Erstellung über Hooks, die Erstellung eines Spezifikationsverzeichnisses und einer Datei, das Befüllen der Spezifikation mit Anforderungen, Szenarien und Erfolgskriterien sowie eine optionale Qualitätsprüfung mit Checklisten. Die Fähigkeit kann auch Erweiterungs-Hooks vor und nach der Ausführung integrieren, um benutzerdefinierte Aktionen wie Git-Commits auszuführen. Die Spezifikation wird in einem standardisierten Markdown-Format gespeichert, das die weitere Planung und Umsetzung erleichtert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangjuyo/reels-blocker/tree/HEAD/.claude/skills/speckit-specify

In Ihrer bevorzugten KI fragen

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

Dokumentation

Benutzereingabe

$ARGUMENTS

Sie MÜSSEN die Benutzereingabe vor dem Fortfahren berücksichtigen (falls nicht leer).

Vorausführungsprüfungen

Prüfung auf Erweiterungs-Hooks (vor der Spezifikation):

  • Prüfen Sie, ob .specify/extensions.yml im Projektstammverzeichnis existiert.
  • Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel hooks.before_specify.
  • Wenn das YAML nicht analysiert werden kann oder ungültig ist, überspringen Sie es nicht stillschweigend: Teilen Sie dem Benutzer mit, dass .specify/extensions.yml nicht gelesen werden konnte (geben Sie den Parser-Fehler an) und dass keine Hooks überprüft wurden, einschließlich aller dort registrierten obligatorischen (optional: false) Hooks, und fahren Sie dann normal fort.
  • Filtern Sie Hooks heraus, bei denen enabled explizit false ist. Behandeln Sie Hooks ohne ein enabled-Feld als standardmäßig aktiviert.
  • Versuchen Sie für jeden verbleibenden Hook nicht, Hook-condition-Ausdrücke zu interpretieren oder auszuwerten:
    • Wenn der Hook kein condition-Feld hat oder dieses null/leer ist, behandeln Sie den Hook als ausführbar.
    • Wenn der Hook eine nicht leere condition definiert, überspringen Sie den Hook und überlassen Sie die Bedingungsauswertung der HookExecutor-Implementierung.
  • Ersetzen Sie bei der Erstellung von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (.) durch Bindestriche (-). Beispiel: speckit.git.commit → /speckit-git-commit.
  • Geben Sie für jeden ausführbaren Hook Folgendes basierend auf seinem optional-Flag aus:
    • Optionaler Hook (optional: true):
      ## Erweiterungs-Hooks
      
      **Optionaler Pre-Hook**: {extension}
      Befehl: `/{command}`
      Beschreibung: {description}
      
      Prompt: {prompt}
      Zur Ausführung: `/{command}`
      
    • Obligatorischer Hook (optional: false):
      ## Erweiterungs-Hooks
      
      **Automatischer Pre-Hook**: {extension}
      Ausführung: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Warten Sie auf das Ergebnis des Hook-Befehls, bevor Sie mit der Gliederung fortfahren.
      
      Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf sein Ende warten, bevor Sie fortfahren. Führen Sie ihn so aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten wörtlichen {command}-ID abweichen, z.B. führt ein Skills-Mode-Agent ihn als /skill:speckit-... oder $speckit-... aus). Das bloße Ausgeben des Blocks führt den Hook nicht aus.
  • Wenn keine Hooks registriert sind oder .specify/extensions.yml nicht existiert, überspringen Sie dies stillschweigend.

Gliederung

Der Text, den der Benutzer nach /speckit-specify in der auslösenden Nachricht eingegeben hat, ist die Funktionsbeschreibung. Gehen Sie davon aus, dass Sie ihn in dieser Konversation immer verfügbar haben, auch wenn $ARGUMENTS unten wörtlich erscheint. Fordern Sie den Benutzer nicht auf, ihn zu wiederholen, es sei denn, er hat einen leeren Befehl angegeben.

Gegeben diese Funktionsbeschreibung, führen Sie Folgendes durch:

  1. Generieren Sie einen prägnanten Kurznamen (2-4 Wörter) für die Funktion:

    • Analysieren Sie die Funktionsbeschreibung und extrahieren Sie die aussagekräftigsten Schlüsselwörter.
    • Erstellen Sie einen 2-4 Wörter langen Kurznamen, der das Wesen der Funktion erfasst.
    • Verwenden Sie nach Möglichkeit das Format Aktion-Nomen (z.B. "add-user-auth", "fix-payment-bug").
    • Behalten Sie technische Begriffe und Akronyme bei (OAuth2, API, JWT usw.).
    • Halten Sie ihn prägnant, aber beschreibend genug, um die Funktion auf einen Blick zu verstehen.
    • Beispiele:
      • "Ich möchte Benutzerauthentifizierung hinzufügen" → "benutzer-auth"
      • "OAuth2-Integration für die API implementieren" → "oauth2-api-integration"
      • "Ein Dashboard für Analysen erstellen" → "analysen-dashboard"
      • "Fehler bei Zahlungsverarbeitungs-Timeout beheben" → "behebe-zahlungs-timeout"
  2. Branch-Erstellung (optional, über Hook):

    Wenn in den Vorausführungsprüfungen oben ein before_specify-Hook erfolgreich ausgeführt wurde, hat er einen Git-Branch erstellt/gewechselt und JSON mit BRANCH_NAME und FEATURE_NUM ausgegeben. Notieren Sie sich diese Werte als Referenz, aber der Branch-Name bestimmt nicht den Verzeichnisnamen der Spezifikation.

    Wenn der Benutzer explizit GIT_BRANCH_NAME angegeben hat, übergeben Sie es an den Hook, damit das Branch-Skript den genauen Wert als Branchnamen verwendet (unter Umgehung aller Präfix-/Suffix-Generierung).

  3. Erstellen Sie das Funktionsspezifikationsverzeichnis:

    Spezifikationen befinden sich standardmäßig im Verzeichnis specs/, es sei denn, der Benutzer gibt explizit SPECIFY_FEATURE_DIRECTORY an.

    Auflösungsreihenfolge für SPECIFY_FEATURE_DIRECTORY:

    1. Wenn der Benutzer explizit SPECIFY_FEATURE_DIRECTORY angegeben hat (z.B. über Umgebungsvariable, Argument oder Konfiguration), verwenden Sie es unverändert.
    2. Andernfalls generieren Sie es automatisch unter specs/:
      • Überprüfen Sie .specify/init-options.json auf feature_numbering (bevorzugt) oder branch_numbering (veraltet, nur Migration – wird in einer zukünftigen Version entfernt).
      • Wenn "timestamp": Präfix ist YYYYMMDD-HHMMSS (aktueller Zeitstempel).
      • Wenn "sequential" oder nicht vorhanden: Präfix ist NNN (nächste verfügbare 3-stellige Nummer nach Scannen vorhandener Verzeichnisse in specs/).
      • Konstruieren Sie den Verzeichnisnamen: <präfix>-<kurzname> (z.B. 003-benutzer-auth oder 20260319-143022-benutzer-auth).
      • Setzen Sie SPECIFY_FEATURE_DIRECTORY auf specs/<verzeichnisname>.
      • Wenn branch_numbering verwendet wurde (und feature_numbering nicht vorhanden war), geben Sie eine einzeilige Warnung aus: "⚠️ branch_numbering in init-options.json ist veraltet. Benennen Sie es in feature_numbering um."

    Erstellen Sie das Verzeichnis und die Spezifikationsdatei:

    • mkdir -p SPECIFY_FEATURE_DIRECTORY
    • Lösen Sie die aktive spec-template über den SpecKit-Präset-/Vorlagenauflösungsstapel auf (entspricht specify preset resolve spec-template).
    • Kopieren Sie die aufgelöste spec-template-Datei als Ausgangspunkt nach SPECIFY_FEATURE_DIRECTORY/spec.md.
    • Setzen Sie SPEC_FILE auf SPECIFY_FEATURE_DIRECTORY/spec.md.
    • Persistieren Sie den aufgelösten Pfad in .specify/feature.json:
      {
        "feature_directory": "<aufgelöstes funkionsverzeichnis>"
      }
      
      Schreiben Sie den tatsächlichen aufgelösten Verzeichnispfadwert (z.B. specs/003-benutzer-auth), nicht den wörtlichen String SPECIFY_FEATURE_DIRECTORY. Dies ermöglicht es nachgelagerten Befehlen (/speckit-plan, /speckit-tasks usw.), das Funktionsverzeichnis zu finden, ohne sich auf Git-Branch-Namenskonventionen stützen zu müssen.

    WICHTIG:

    • Sie dürfen nur eine Funktion pro /speckit-specify-Aufruf erstellen.
    • Der Spezifikationsverzeichnisname und der Git-Branch-Name sind unabhängig – sie können gleich sein, aber dies ist die Wahl des Benutzers.
    • Das Spezifikationsverzeichnis und die Datei werden immer von diesem Befehl erstellt, niemals vom Hook.
  4. Laden Sie die aktive aufgelöste spec-template-Datei, um die erforderlichen Abschnitte zu verstehen.

  5. WENN VORHANDEN: Laden Sie .specify/memory/constitution.md für Projektprinzipien und Governance-Einschränkungen.

  6. Befolgen Sie diesen Ausführungsablauf:

    1. Parsen Sie die Benutzerbeschreibung aus den Argumenten. Wenn leer: FEHLER "Keine Funktionsbeschreibung bereitgestellt".
    2. Extrahieren Sie Schlüsselkonzepte aus der Beschreibung. Identifizieren Sie: Akteure, Aktionen, Daten, Einschränkungen.
    3. Bei unklaren Aspekten:
      • Treffen Sie fundierte Annahmen basierend auf Kontext und Branchenstandards.
      • Markieren Sie nur mit [NEEDS CLARIFICATION: spezifische Frage], wenn:
        • Die Wahl den Umfang oder die Benutzererfahrung der Funktion erheblich beeinflusst.
        • Mehrere vernünftige Interpretationen mit unterschiedlichen Auswirkungen existieren.
        • Kein vernünftiger Standardwert existiert.
      • BEGRENZUNG: Maximal 3 [NEEDS CLARIFICATION]-Marker insgesamt.
      • Priorisieren Sie Klarstellungen nach Auswirkung: Umfang > Sicherheit/Datenschutz > Benutzererfahrung > technische Details.
    4. Füllen Sie den Abschnitt "Benutzerszenarien und Tests" aus. Wenn kein klarer Benutzerablauf: FEHLER "Benutzerszenarien können nicht bestimmt werden".
    5. Generieren Sie funktionale Anforderungen. Jede Anforderung muss testbar sein. Verwenden Sie vernünftige Standardwerte für nicht spezifizierte Details (dokumentieren Sie Annahmen im Abschnitt "Annahmen").
    6. Definieren Sie Erfolgskriterien. Erstellen Sie messbare, technologieunabhängige Ergebnisse. Enthalten Sie sowohl quantitative Metriken (Zeit, Leistung, Volumen) als auch qualitative Maße (Benutzerzufriedenheit, Aufgabenerfüllung). Jedes Kriterium muss ohne Implementierungsdetails überprüfbar sein.
    7. Identifizieren Sie Schlüsselentitäten (falls Daten betroffen sind).
    8. Rückgabe: ERFOLG (Spezifikation bereit zur Planung).
  7. Schreiben Sie die Spezifikation in die Datei SPEC_FILE unter Verwendung der Vorlagenstruktur, ersetzen Sie Platzhalter mit konkreten Details aus der Funktionsbeschreibung (Argumenten), während Sie die Abschnittsreihenfolge und Überschriften beibehalten.

  8. Qualitätsvalidierung der Spezifikation: Nach dem Schreiben der ersten Spezifikation validieren Sie sie anhand von Qualitätskriterien:

    a. Erstellen Sie eine Spezifikations-Qualitätscheckliste: Generieren Sie eine Checklistendatei unter SPECIFY_FEATURE_DIRECTORY/checklists/requirements.md unter Verwendung der Checklistenvorlagenstruktur mit diesen Validierungselementen:

    # Spezifikations-Qualitätscheckliste: [FUNKTIONSNAME]
    
    **Zweck**: Validierung der Spezifikationsvollständigkeit und -qualität vor dem Fortfahren mit der Planung
    **Erstellt**: [DATUM]
    **Funktion**: [Link zu spec.md]
    
    ## Inhaltsqualität
    
    - [ ] Keine Implementierungsdetails (Sprachen, Frameworks, APIs)
    - [ ] Fokussiert auf Benutzerwert und Geschäftsanforderungen
    - [ ] Für nicht-technische Stakeholder geschrieben
    - [ ] Alle obligatorischen Abschnitte abgeschlossen
    
    ## Vollständigkeit der Anforderungen
    
    - [ ] Keine [NEEDS CLARIFICATION]-Marker mehr vorhanden
    - [ ] Anforderungen sind testbar und eindeutig
    - [ ] Erfolgskriterien sind messbar
    - [ ] Erfolgskriterien sind technologieunabhängig (keine Implementierungsdetails)
    - [ ] Alle Akzeptanzszenarien sind definiert
    - [ ] Grenzfälle sind identifiziert
    - [ ] Umfang ist klar abgegrenzt
    - [ ] Abhängigkeiten und Annahmen identifiziert
    
    ## Funktionsbereitschaft
    
    - [ ] Alle funktionalen Anforderungen haben klare Akzeptanzkriterien
    - [ ] Benutzerszenarien decken primäre Abläufe ab
    - [ ] Funktion erfüllt messbare Ergebnisse, die in den Erfolgskriterien definiert sind
    - [ ] Keine Implementierungsdetails in die Spezifikation eingeflossen
    
    ## Hinweise
    
    - Als unvollständig markierte Elemente erfordern Spezifikationsaktualisierungen vor `/speckit-clarify` oder `/speckit-plan`
    

    b. Führen Sie einen Validierungscheck durch: Überprüfen Sie die Spezifikation anhand jedes Checklistenelements:

    • Bestimmen Sie für jedes Element, ob es bestanden oder nicht bestanden wird.
    • Dokumentieren Sie spezifische gefundene Probleme (zitieren Sie relevante Spezifikationsabschnitte).

    c. Behandlung der Validierungsergebnisse:

    • Wenn alle Elemente bestanden sind: Markieren Sie die Checkliste als abgeschlossen und fahren Sie mit dem Abschnitt "Obligatorische Post-Execution-Hooks" fort.

    • Wenn Elemente nicht bestanden werden (außer [NEEDS CLARIFICATION]):

      1. Listen Sie die nicht bestandenen Elemente und spezifischen Probleme auf.
      2. Aktualisieren Sie die Spezifikation, um jedes Problem zu beheben.
      3. Führen Sie die Validierung erneut durch, bis alle Elemente bestanden sind (maximal 3 Iterationen).
      4. Wenn nach 3 Iterationen immer noch nicht bestanden, dokumentieren Sie die verbleibenden Probleme in den Checklistenhinweisen und warnen Sie den Benutzer.
    • Wenn [NEEDS CLARIFICATION]-Marker verbleiben:

      1. Extrahieren Sie alle [NEEDS CLARIFICATION: ...]-Marker aus der Spezifikation.

      2. BEGRENZUNGSPRÜFUNG: Wenn mehr als 3 Marker vorhanden sind, behalten Sie nur die 3 kritischsten (nach Umfang/Sicherheit/Benutzererfahrungsauswirkung) und treffen Sie fundierte Annahmen für die restlichen.

      3. Präsentieren Sie für jede benötigte Klarstellung (maximal 3) dem Benutzer Optionen in diesem Format:

        ## Frage [N]: [Thema]
        
        **Kontext**: [Zitieren Sie den relevanten Spezifikationsabschnitt]
        
        **Was wir wissen müssen**: [Spezifische Frage aus dem NEEDS CLARIFICATION-Marker]
        
        **Vorgeschlagene Antworten**:
        
        | Option | Antwort | Auswirkungen |
        |--------|---------|------------|
        | A      | [Erste vorgeschlagene Antwort] | [Was dies für die Funktion bedeutet] |
        | B      | [Zweite vorgeschlagene Antwort] | [Was dies für die Funktion bedeutet] |
        | C      | [Dritte vorgeschlagene Antwort] | [Was dies für die Funktion bedeutet] |
        | Eigen  | Geben Sie Ihre eigene Antwort an | [Erklären Sie, wie benutzerdefinierte Eingaben bereitgestellt werden] |
        
        **Ihre Wahl**: _[Warten auf Benutzerantwort]_
        
      4. KRITISCH - Tabellenformatierung: Stellen Sie sicher, dass Markdown-Tabellen korrekt formatiert sind:

        • Verwenden Sie konsistente Leerzeichen mit ausgerichteten Rohren.
        • Jede Zelle sollte Leerzeichen um den Inhalt haben: | Inhalt | nicht |Inhalt|.
        • Der Kopfzeilentrenner muss mindestens 3 Bindestriche haben: |--------|.
        • Testen Sie, ob die Tabelle in der Markdown-Vorschau korrekt gerendert wird.
      5. Nummerieren Sie die Fragen fortlaufend (F1, F2, F3 - maximal 3 insgesamt).

      6. Präsentieren Sie alle Fragen zusammen, bevor Sie auf Antworten warten.

      7. Warten Sie, bis der Benutzer mit seinen Entscheidungen für alle Fragen antwortet (z.B. "F1: A, F2: Eigen - [Details], F3: B").

      8. Aktualisieren Sie die Spezifikation, indem Sie jeden [NEEDS CLARIFICATION]-Marker durch die vom Benutzer ausgewählte oder bereitgestellte Antwort ersetzen.

      9. Führen Sie die Validierung erneut durch, nachdem alle Klarstellungen gelöst sind.

    d. Aktualisieren Sie die Checkliste: Aktualisieren Sie nach jeder Validierungsiteration die Checklistendatei mit dem aktuellen Bestanden/Nicht-Bestanden-Status.

Obligatorische Post-Execution-Hooks

Sie MÜSSEN diesen Abschnitt abschließen, bevor Sie dem Benutzer den Abschluss melden.

Prüfen Sie, ob .specify/extensions.yml im Projektstammverzeichnis existiert.

  • Wenn es nicht existiert oder keine Hooks unter hooks.after_specify registriert sind, fahren Sie mit dem Abschlussbericht fort.
  • Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel hooks.after_specify.
  • Wenn das YAML nicht analysiert werden kann oder ungültig ist, überspringen Sie es nicht stillschweigend: Teilen Sie dem Benutzer mit, dass .specify/extensions.yml nicht gelesen werden konnte (geben Sie den Parser-Fehler an) und dass keine Hooks überprüft wurden, einschließlich aller dort registrierten obligatorischen (optional: false) Hooks, und fahren Sie dann mit dem Abschlussbericht fort.
  • Filtern Sie Hooks heraus, bei denen enabled explizit false ist. Behandeln Sie Hooks ohne ein enabled-Feld als standardmäßig aktiviert.
  • Versuchen Sie für jeden verbleibenden Hook nicht, Hook-condition-Ausdrücke zu interpretieren oder auszuwerten:
    • Wenn der Hook kein condition-Feld hat oder dieses null/leer ist, behandeln Sie den Hook als ausführbar.
    • Wenn der Hook eine nicht leere condition definiert, überspringen Sie den Hook und überlassen Sie die Bedingungsauswertung der HookExecutor-Implementierung.
  • Ersetzen Sie bei der Erstellung von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (.) durch Bindestriche (-). Beispiel: speckit.git.commit → /speckit-git-commit.
  • Geben Sie für jeden ausführbaren Hook Folgendes basierend auf seinem optional-Flag aus:
    • Obligatorischer Hook (optional: false) — Sie MÜSSEN EXECUTE_COMMAND: für jeden obligatorischen Hook ausgeben:
      ## Erweiterungs-Hooks
      
      **Automatischer Hook**: {extension}
      Ausführung: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Warten Sie auf das Ergebnis des Hook-Befehls, bevor Sie mit dem Abschlussbericht fortfahren.
      
      Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf sein Ende warten, bevor Sie fortfahren. Führen Sie ihn so aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten wörtlichen {command}-ID abweichen, z.B. führt ein Skills-Mode-Agent ihn als /skill:speckit-... oder $speckit-... aus). Das bloße Ausgeben des Blocks führt den Hook nicht aus.
    • Optionaler Hook (optional: true):
      ## Erweiterungs-Hooks
      
      **Optionaler Post-Hook**: {extension}
      Befehl: `/{command}`
      Beschreibung: {description}
      
      Prompt: {prompt}
      Zur Ausführung: `/{command}`
      

Abschlussbericht

Wenn Sie die Ausführung abgeschlossen haben, fassen Sie dem Benutzer die Ergebnisse mit dem folgenden strukturierten Format zusammen:

## Spezifikation: [FUNKTIONSNAME]

**Spezifikationsdatei**: `SPEC_FILE`
**Feature-Verzeichnis**: `SPECIFY_FEATURE_DIRECTORY`

**Erfolgskriterien**:
- [Zusammenfassung der wichtigsten Erfolgskriterien]

**Ausstehende Klarstellungen**:
- [Anzahl] Fragen zur Klärung (maximal 3)

**Nächste Schritte**:
1. Überprüfen Sie die Spezifikation in `SPEC_FILE`
2. Führen Sie `/speckit-plan` aus, um die Planung zu starten
3. Bei ausstehenden Klarstellungen: Beantworten Sie die Fragen oben

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Verwandte Skills