Communitygithub.com

tangjuyo/reels-blocker

Bewertet den aktuellen Codebestand anhand der Spezifikation, des Plans und der Aufgaben eines Features und hängt verbleibende, nicht umgesetzte Arbeiten als neue Aufgaben an tasks.md an, damit die Implementierung abgeschlossen werden kann.

Was ist reels-blocker?

Dieser Skill dient der Konvergenzprüfung: Er stellt sicher, dass die tatsächliche Codebasis vollständig mit den Vorgaben aus `spec.md`, `plan.md` und `tasks.md` übereinstimmt. Nachdem `/speckit-implement` die aktuellen Aufgaben abgearbeitet und `/speckit-tasks` eine vollständige Aufgabenliste erstellt hat, analysiert dieser Skill den Code auf Lücken und hängt fehlende oder unvollständige Arbeiten als neue Aufgaben an `tasks.md` an. Der Skill arbeitet append-only – er überschreibt keine bestehenden Dateien oder Aufgaben. Er erzeugt einen detaillierten Befundbericht mit Prioritäten (CRITICAL, HIGH, MEDIUM, LOW) und klassifiziert Lücken als fehlend, teilweise, widersprechend oder nicht angefordert. Optional können vor und nach der Konvergenzprüfung Erweiterungs-Hooks aus `.specify/extensions.yml` ausgeführt werden. Der Skill ist Teil des Specify-Ökosystems für strukturierte Feature-Entwicklung und wird über agentenspezifische Mechanismen (z. B. als Skill oder Befehl) gestartet. Er ist besonders nützlich, um nach einer ersten Implementierung systematisch die vollständige Abdeckung der Anforderungen sicherzustellen.

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

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 berücksichtigen, bevor Sie fortfahren (falls nicht leer).

Prüfungen vor der Ausführung

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

  • 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_converge.

  • Wenn das YAML nicht geparst werden kann oder ungültig ist, überspringen Sie es nicht stillschweigend: Teilen Sie dem Benutzer mit, dass .specify/extensions.yml nicht gelesen werden konnte (fügen Sie den Parser-Fehler hinzu) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten, verpflichtenden (optional: false) Hooks. 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 beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (.) durch Bindestriche (-). Beispiel: speckit.git.commit → /speckit-git-commit.

  • Geben Sie für jeden ausführbaren Hook basierend auf seinem optional-Flag Folgendes aus:

    • Optionaler Hook (optional: true):

      ## Erweiterungs-Hooks
      
      **Optionaler Pre-Hook**: {extension}
      Befehl: `/{command}`
      Beschreibung: {description}
      
      Prompt: {prompt}
      Zur Ausführung: `/{command}`
      
    • Verpflichtender 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 dem Ziel fortfahren.
      

      Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Abschluss warten, bevor Sie fortfahren. Führen Sie ihn auf die gleiche Weise aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten literarischen {command}-ID abweichen, z. B. führt ein Skill-Modus-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.

Ziel

Schließen Sie die Lücke zwischen dem, was die Spezifikation, der Plan und die Aufgaben eines Features vorgeben, und dem, was der Codebestand derzeit implementiert. Lesen Sie spec.md, plan.md und tasks.md als die einzige Quelle der Absicht (mit der Verfassung als übergeordneten Richtlinien), bewerten Sie den aktuellen Zustand des Codes, bestimmen Sie, welche Anforderungen, Akzeptanzkriterien, Planentscheidungen und vorhandenen Aufgaben nicht erfüllt, unvollständig oder nur teilweise erfüllt sind, und hängen Sie jedes verbleibende Arbeitspaket als neue, nachvollziehbare Aufgabe am Ende von tasks.md an, damit /speckit-implement es abschließen kann. Dieser Befehl MUSS nur ausgeführt werden, nachdem /speckit-implement auf der aktuellen tasks.md ausgeführt wurde und nachdem /speckit-tasks eine vollständige tasks.md erstellt hat.

Dies ist kein Diff-Tool und verfolgt keine Änderungen. Es bewertet den aktuellen Zustand des Codes in Bezug auf die Artefakte des Features – kein Git, kein Branch-Vergleich, keine Historie.

Betriebsbeschränkungen

NUR ANHÄNGEN, NIEMALS ÜBERSCHREIBEN: Der einzige Schreibvorgang des Befehls ist das Anhängen eines neuen Abschnitts ## Phase N: Konvergenz an tasks.md. Er MUSS NICHT:

  • spec.md oder plan.md in irgendeiner Weise ändern;
  • vorhandene Aufgaben (einschließlich Aufgaben aus einer vorherigen Konvergenzphase) umschreiben, umnummerieren, neu anordnen oder löschen;
  • Anwendungscode ändern, erstellen oder löschen – das Vervollständigen der angehängten Aufgaben ist die Aufgabe von /speckit-implement.

Wenn der Codebestand bereits alles erfüllt, MUSS der Befehl tasks.md byteweise unverändert lassen (keinen leeren Konvergenz-Header) und ein sauberes Ergebnis melden.

Autorität der Verfassung: Die Projektverfassung (.specify/memory/constitution.md) ist nicht verhandelbar. Code, der gegen ein MUSS-Prinzip verstößt, ist der schwerwiegendste Befund und erzeugt eine entsprechende Behebungsaufgabe. Wenn die Verfassung eine unausgefüllte Vorlage ist, überspringen Sie die Verfassungsprüfungen elegant, anstatt zu scheitern.

Ausführungsschritte

1. Konvergenzkontext initialisieren

Führen Sie .specify/scripts/bash/check-prerequisites.sh --json --require-spec --require-tasks --include-tasks einmal vom Repository-Stamm aus und parsen Sie JSON nach FEATURE_DIR und AVAILABLE_DOCS. Leiten Sie absolute Pfade ab:

  • SPEC = FEATURE_DIR/spec.md
  • PLAN = FEATURE_DIR/plan.md
  • TASKS = FEATURE_DIR/tasks.md
  • CONSTITUTION = .specify/memory/constitution.md (falls vorhanden) Wenn spec.md, plan.md oder tasks.md fehlt, STOPPEN Sie mit einer klaren, umsetzbaren Nachricht, die den auszuführenden erforderlichen Befehl nennt (/speckit-specify für eine fehlende Spezifikation, /speckit-plan für einen fehlenden Plan, /speckit-tasks für fehlende Aufgaben). Erzeugen Sie keine partielle Ausgabe. Verwenden Sie für einfache Anführungszeichen in Argumenten wie „I'm Groot“ die Escape-Syntax: z. B. 'I'''m Groot' (oder doppelte Anführungszeichen, wenn möglich: "I'm Groot").

2. Artefakte laden (Progressive Offenlegung)

Laden Sie nur den minimal notwendigen Kontext aus jedem Artefakt:

Aus spec.md:

  • Funktionale Anforderungen (FR-###)
  • Erfolgskriterien (SC-###) – nur Elemente einschließen, die baubare Arbeit erfordern; Post-Launch-Ergebnis-Metriken und Geschäfts-KPIs ausschließen
  • User Stories und deren Akzeptanzszenarien
  • Randfälle (falls vorhanden)

Aus plan.md:

  • Architektur-/Stack-Entscheidungen und technische Entscheidungen
  • Referenzen auf Datenmodelle
  • Phasen und benannte Berührungspunkte (Dateien/Komponenten, die der Plan erstellt oder bearbeitet)
  • Technische Einschränkungen

Aus tasks.md:

  • Aufgaben-IDs (um die nächste ID und nächste Phasennummer zu berechnen)
  • Beschreibungen, Phasengruppierung und referenzierte Dateipfade

Aus der Verfassung (falls keine unausgefüllte Vorlage):

  • Prinzipnamen und MUSS/SOLLTE normative Aussagen

3. Das Absichtsinventar erstellen

Erstellen Sie ein internes Modell (geben Sie keine Roh-Artefakte aus):

  • Anforderungsinventar: ein stabiler Schlüssel pro FR-### / SC-### / Akzeptanzszenario einer User Story (z. B. US1/AC2), plus die Planentscheidungen und Verfassungsprinzipien, die baubare Verpflichtungen auferlegen.
  • Code-Umfangskarte: Leiten Sie aus den in plan.md und tasks.md genannten Dateipfaden sowie einer Schlüsselwortsuche nach den Konzepten, die jede Anforderung beschreibt, die Menge der zu bewertenden Quelldateien und Komponenten ab. Begrenzen Sie die Bewertung auf diese – schließen Sie nicht auf einen Umfang, der über die von den Artefakten definierten hinausgeht.

4. Den Codebestand bewerten und Befunde klassifizieren

Beziehen Sie jede vorhandene Aufgabe in das Absichtsinventar ein, unabhängig vom Kontrollkästchenstatus oder der Konvergenzphase: Abschlussbehauptungen sind keine Nachweise. Überprüfen Sie das aktuelle Verhalten anhand von Spezifikation, Plan, Aufgaben und Verfassung; bewerten Sie bei korrigierenden Aufgabenketten das resultierende Verhalten, nicht die ersetzten Implementierungsdetails. Prüfen Sie sowohl nicht erfüllte Verpflichtungen als auch Implementierungen, die der erklärten Absicht widersprechen, über sie hinausgehen oder außerhalb von ihr liegen.

Erzeugen Sie für jedes Element im Absichtsinventar einen Befund nur dort, wo eine Lücke besteht. Klassifizieren Sie jeden Befund nach Lückentyp:

  • fehlend: Die erforderliche Arbeit fehlt vollständig im Code.
  • teilweise: Die Arbeit existiert, erfüllt aber die Anforderung / das Akzeptanzkriterium / die Planentscheidung noch nicht vollständig.
  • widerspricht: Der Code tut etwas, das der erklärten Absicht oder einem MUSS-Prinzip der Verfassung widerspricht.
  • nicht angefordert: Der Code enthält Arbeit, die nicht in Spezifikation, Plan oder Aufgaben gefordert wird (zur Kenntnisnahme – Konvergenz löscht keinen Code, sie hängt nur eine Aufgabe an, um dies zu überprüfen/zu rechtfertigen oder zu entfernen).

Jeder Befund enthält: eine stabile ID, den source-ref, auf den er zurückgeht, den gap-type, einen Schweregrad und eine kurze, menschenlesbare Beschreibung mit dem Nachweis (die beobachtete Datei/der beobachtete Bereich).

Randfälle:

  • Wenig oder noch kein Code: Behandeln Sie den gesamten spezifizierten Umfang als fehlende verbleibende Arbeit, anstatt zu scheitern.
  • Nichts bleibt übrig: Erzeugen Sie null Befunde und folgen Sie dem konvergierten Zweig in Schritt 7.

5. Schweregrad zuweisen

  • KRITISCH: Verstößt gegen ein MUSS-Prinzip der Verfassung, oder eine fehlende/widersprechende Lücke, die die Basisfunktionalität einer P1-User-Story blockiert.
  • HOCH: Eine fehlende oder teilweise Lücke bei einer Kernfunktionsanforderung oder einem Akzeptanzkriterium.
  • MITTEL: Eine teilweise Lücke bei einer sekundären Anforderung, oder eine nicht angeforderte Ergänzung ohne klare Rechtfertigung.
  • NIEDRIG: Geringfügige partielle Lücken, Verbesserungen oder nicht angeforderte Ergänzungen mit geringem Risiko.

6. Die Sitzungszusammenfassung der Befunde präsentieren

Geben Sie vor dem Anhängen von etwas eine kompakte, nach Schweregrad gestaffelte Zusammenfassung aus (noch keine Dateischreibvorgänge):

Konvergenzbefunde

IDLückentypSchweregradQuelleNachweisVerbleibende Arbeit
F1fehlendHOCHFR-008Beispiel: Kein Append-Only-Schutz in path/to/module.py beim Schreiben von tasks.md erkanntAppend-Only-Durchsetzung hinzufügen

Zusammenfassungsmetriken:

  • Geprüfte Anforderungen / Akzeptanzkriterien
  • Geprüfte Planentscheidungen
  • Geprüfte Verfassungsprinzipien (oder „übersprungen – Vorlage“)
  • Befunde nach Lückentyp (fehlend / teilweise / widerspricht / nicht angefordert)
  • Befunde nach Schweregrad

7. Konvergenzaufgaben anhängen (oder Konvergenz melden)

Wenn ein oder mehrere umsetzbare Befunde vorliegen (tasks_appended-Ergebnis):

Hängen Sie gemäß dem Anhängevertrag an das Ende von tasks.md an:

  1. Scannen Sie alle vorhandenen Aufgaben-IDs; sei M das Maximum. Bestimmen Sie die nächste Phasennummer N (höchste vorhandene Phase + 1).

  2. Schreiben Sie einen einzelnen neuen Abschnitts-Header ## Phase N: Konvergenz.

  3. Geben Sie ein Kontrollkästchen-Element pro umsetzbarem Befund aus, geordnet nach KRITISCH/HOCH zuerst, mit nullaufgefüllten IDs T{M+1:03d}, T{M+2:03d}, …:

    - [ ] T042 <imperative Beschreibung> gemäß <source-ref> (<Lückentyp>)
    

    <source-ref> führt die Aufgabe auf ihren Ursprung zurück: z. B. FR-003, SC-002, US1/AC2, plan: storage decision, Verfassung II.

    <Lückentyp> ist einer von fehlend, teilweise, widerspricht, nicht angefordert.

    Aufgaben, die gegen die Verfassung verstoßen, MÜSSEN zuerst ausgegeben und als KRITISCH beschrieben werden.

  4. Verwenden Sie niemals vorhandene IDs wieder oder nummerieren Sie sie um. Wenn eine vorherige Konvergenzphase existiert, fügen Sie eine neue, separat nummerierte darunter ein – berühren Sie nicht die alte.

Wenn keine umsetzbaren Befunde vorliegen (konvergiert-Ergebnis):

  • Ändern Sie tasks.md überhaupt nicht – keinen leeren Phasen-Header.
  • Melden Sie: „✅ Konvergiert – die Implementierung erfüllt Spezifikation, Plan und Aufgaben.“
  • Fügen Sie die zusammenfassenden Zählungen dessen hinzu, was geprüft wurde.

8. Nächste Schritte bereitstellen (Übergabe)

  • Bei tasks_appended: Geben Sie an, wie viele Aufgaben unter welcher Phase angehängt wurden, und empfehlen Sie, /speckit-implement auszuführen, um sie zu vervollständigen; weisen Sie darauf hin, dass ein nachfolgender Konvergenzlauf weniger oder keine verbleibenden Elemente finden wird.
  • Bei konvergiert: Empfehlen Sie, zur Überprüfung / zum Öffnen eines PR überzugehen. Für den spezifizierten Umfang dieses Features ist kein weiterer Implementierungsdurchlauf erforderlich.

9. Prüfung auf Erweiterungs-Hooks

Nachdem Sie das Ergebnis erstellt haben, 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.after_converge.

  • Wenn das YAML nicht geparst werden kann oder ungültig ist, überspringen Sie es nicht stillschweigend: Teilen Sie dem Benutzer mit, dass .specify/extensions.yml nicht gelesen werden konnte (fügen Sie den Parser-Fehler hinzu) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten, verpflichtenden (optional: false) Hooks. 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.
  • Melden Sie das Konvergenzergebnis (konvergiert oder tasks_appended) in der Sitzung, bevor Sie Hooks auflisten, damit Benutzer entscheiden können, ob sie optionale Folgebefehle ausführen möchten.

  • Ersetzen Sie beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (.) durch Bindestriche (-). Beispiel: speckit.git.commit → /speckit-git-commit.

  • Geben Sie für jeden ausführbaren Hook basierend auf seinem optional-Flag Folgendes aus:

    • Optionaler Hook (optional: true):

      ## Erweiterungs-Hooks
      
      **Optionaler Hook**: {extension}
      Befehl: `/{command}`
      Beschreibung: {description}
      
      Prompt: {prompt}
      Zur Ausführung: `/{command}`
      
    • Verpflichtender Hook (optional: false):

      ## Erweiterungs-Hooks
      
      **Automatischer Hook**: {extension}
      Ausführung: `/{command}`
      EXECUTE_COMMAND: {command}
      

      Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Abschluss warten, bevor Sie fortfahren. Führen Sie ihn auf die gleiche Weise aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten literarischen {command}-ID abweichen, z. B. führt ein Skill-Modus-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.

Individual skills in this repo

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

Verwandte Skills