Communitygithub.com

tangjuyo/reels-blocker

Führt eine nicht-destruktive, artefaktübergreifende Konsistenz- und Qualitätsanalyse von spec.md, plan.md und tasks.md nach der Aufgabengenerierung durch.

Was ist reels-blocker?

Diese Fähigkeit fungiert als automatisierter Qualitätsprüfer für Specifikations-Workflows, die durch Docker-basierte Developer-Tools orchestriert werden. Nachdem /speckit-tasks eine vollständige tasks.md generiert hat, analysiert /speckit-analyze die drei Kernartefakte (spec.md, plan.md, tasks.md) auf Inkonsistenzen, Duplikate, Ambiguitäten, Unter- oder Überspezifikationen sowie Verfassungsverstöße. Dabei lädt es nur die minimal nötigen Kontexte schrittweise, erstellt semantische Modelle und führt bis zu sieben strukturierte Erkennungsdurchläufe durch. Das Ergebnis ist ein kompakter Analysebericht mit Schweregraden, Abdeckungstabellen und konkreten Handlungsempfehlungen; Änderungen an Dateien sind strikt untersagt. Die Fähigkeit unterstützt Erweiterungshooks vor und nach der Analyse und läuft auf CLI-basierten Agenten wie Claude Code oder Cursor.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Benutzereingabe

$ARGUMENTS

Du MUSST die Benutzereingabe berücksichtigen, bevor du fortfährst (falls nicht leer).

Ausführungsvorprüfungen

Erweiterungshooks prüfen (vor der Analyse):

  • Prüfe, ob .specify/extensions.yml im Projektstammverzeichnis existiert.
  • Falls ja, lies es und suche nach Einträgen unter dem Schlüssel hooks.before_analyze.
  • Falls das YAML nicht geparst werden kann oder ungültig ist, überspringe es nicht stillschweigend: teile dem Benutzer mit, dass .specify/extensions.yml nicht gelesen werden konnte (füge den Parser-Fehler hinzu) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten zwingend erforderlichen (optional: false) Hooks. Fahre dann normal fort.
  • Filtere Hooks heraus, bei denen enabled explizit false ist. Behandle Hooks ohne enabled-Feld als standardmäßig aktiviert.
  • Versuche für jeden verbleibenden Hook nicht, condition-Ausdrücke zu interpretieren oder auszuwerten:
    • Wenn der Hook kein condition-Feld hat oder dieses null/leer ist, behandle den Hook als ausführbar.
    • Wenn der Hook eine nicht-leere condition definiert, überspringe den Hook und überlasse die Bedingungsauswertung der HookExecutor-Implementierung.
  • Ersetze beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (.) durch Bindestriche (-). Beispiel: speckit.git.commit → /speckit-git-commit.
  • Gib für jeden ausführbaren Hook basierend auf seinem optional-Flag Folgendes aus:
    • Optionaler Hook (optional: true):
      ## Erweiterungshooks
      
      **Optionaler Vor-Hook**: {extension}
      Befehl: `/{command}`
      Beschreibung: {description}
      
      Aufforderung: {prompt}
      Ausführung: `/{command}`
      
    • Zwingend erforderlicher Hook (optional: false):
      ## Erweiterungshooks
      
      **Automatischer Vor-Hook**: {extension}
      Ausführung: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Warte auf das Ergebnis des Hook-Befehls, bevor du mit dem Ziel fortfährst.
      
      Nach dem Ausgeben des obigen Blocks MUSST du den Hook tatsächlich aufrufen und auf sein Ende warten, bevor du fortfährst. Führe ihn so aus, wie du den Befehl selbst in diesem Agenten/Session ausführen würdest (der Aufruf kann von der obigen literarischen {command}-ID abweichen, z.B. führt ein Skills-Modus-Agent ihn als /skill:speckit-... oder $speckit-... aus). Allein das Ausgeben des Blocks führt den Hook nicht aus.
  • Wenn keine Hooks registriert sind oder .specify/extensions.yml nicht existiert, überspringe stillschweigend.

Ziel

Identifiziere Inkonsistenzen, Duplikate, Ambiguitäten und unter-/nicht spezifizierte Punkte in den drei Kernartefakten (spec.md, plan.md, tasks.md) vor der Implementierung. Dieser Befehl darf NUR ausgeführt werden, nachdem /speckit-tasks erfolgreich eine vollständige tasks.md erstellt hat.

Betriebliche Einschränkungen

STRENG SCHREIBGESCHÜTZT: Ändere keine Dateien. Gib einen strukturierten Analysebericht aus. Biete optional einen Korrekturplan an (der Benutzer muss explizit zustimmen, bevor manuell Nachbearbeitungsbefehle ausgeführt werden).

Verfassungsautorität: Die Projektverfassung (.specify/memory/constitution.md) ist nicht verhandelbar innerhalb dieses Analyseumfangs. Verfassungskonflikte sind automatisch KRITISCH und erfordern eine Anpassung der Spezifikation, des Plans oder der Aufgaben – nicht die Verwässerung, Neuinterpretation oder stillschweigende Ignorierung des Prinzips. Wenn ein Prinzip selbst geändert werden muss, muss dies in einer separaten, expliziten Verfassungsaktualisierung außerhalb von /speckit-analyze erfolgen.

Ausführungsschritte

1. Analysekontext initialisieren

Führe .specify/scripts/bash/check-prerequisites.sh --json --require-spec --require-tasks --include-tasks einmal vom Repository-Stammverzeichnis aus und parse das JSON für FEATURE_DIR und AVAILABLE_DOCS. Leite absolute Pfade ab:

  • SPEC = FEATURE_DIR/spec.md
  • PLAN = FEATURE_DIR/plan.md
  • TASKS = FEATURE_DIR/tasks.md

Breche mit einer Fehlermeldung ab, wenn eine erforderliche Datei fehlt (weise den Benutzer an, den fehlenden Voraussetzungsbefehl auszuführen). Für einfache Anführungszeichen in Argumenten wie „I'm Groot“ verwende die Escape-Syntax: z.B. 'I'\''m Groot' (oder doppelte Anführungszeichen, wenn möglich: "I'm Groot").

2. Artefakte laden (schrittweise Offenlegung)

Lade nur den minimal notwendigen Kontext aus jedem Artefakt:

Aus spec.md:

  • Überblick/Kontext
  • Funktionale Anforderungen
  • Erfolgskriterien (messbare Ergebnisse – z.B. Leistung, Sicherheit, Verfügbarkeit, Benutzererfolg, geschäftliche Auswirkungen)
  • User Stories
  • Randfälle (falls vorhanden)

Aus plan.md:

  • Architektur-/Technologieentscheidungen
  • Datenmodellverweise
  • Phasen
  • Technische Einschränkungen

Aus tasks.md:

  • Aufgaben-IDs
  • Beschreibungen
  • Phasenzuordnung
  • Parallelitätsmarkierungen [P]
  • Referenzierte Dateipfade

Aus der Verfassung:

  • Lade .specify/memory/constitution.md zur Prinzipienvalidierung

3. Semantische Modelle erstellen

Erstelle interne Repräsentationen (füge rohe Artefakte nicht in die Ausgabe ein):

  • Anforderungsinventar: Für jede funktionale Anforderung (FR-###) und jedes Erfolgskriterium (SC-###) einen stabilen Schlüssel notieren. Verwende die explizite FR-/SC-Kennung als Primärschlüssel, sofern vorhanden, und leite optional einen imperativ-phrasierten Slug für die Lesbarkeit ab (z.B. „Benutzer kann Datei hochladen“ → benutzer-kann-datei-hochladen). Nimm nur Erfolgskriterien auf, die baubare Arbeit erfordern (z.B. Auslastungstest-Infrastruktur, Sicherheitsaudit-Tooling), und schließe Metriken nach dem Start und Geschäfts-KPIs aus (z.B. „Support-Tickets um 50 % reduzieren“).
  • User-Story-/Aktionsinventar: Diskrete Benutzeraktionen mit Abnahmekriterien.
  • Aufgabenabdeckungszuordnung: Ordne jede Aufgabe einer oder mehreren Anforderungen oder Stories zu (Schlussfolgerung durch Schlüsselwörter / explizite Referenzmuster wie IDs oder Schlüsselphrasen).
  • Verfassungsregelsatz: Extrahiere Prinzipiennamen und normative MUST/SHOULD-Aussagen.

4. Erkennungsdurchläufe (token-effiziente Analyse)

Konzentriere dich auf signifikante Erkenntnisse. Begrenze die Gesamtzahl auf 50 Erkenntnisse; fasse den Rest in einer Überlaufzusammenfassung zusammen.

A. Duplikaterkennung

  • Identifiziere nahezu identische Anforderungen.
  • Markiere minderwertigere Formulierungen zur Konsolidierung.

B. Ambiguitätserkennung

  • Markiere vage Adjektive (schnell, skalierbar, sicher, intuitiv, robust) ohne messbare Kriterien.
  • Markiere ungelöste Platzhalter (TODO, TKTK, ???, <placeholder> usw.).

C. Unterspezifikation

  • Anforderungen mit Verben, aber fehlendem Objekt oder messbarem Ergebnis.
  • User Stories ohne Abnahmekriterien.
  • Aufgaben, die auf Dateien oder Komponenten verweisen, die in der Spezifikation/im Plan nicht definiert sind.

D. Verfassungskonformität

  • Jede Anforderung oder jedes Planelement, das mit einem MUST-Prinzip in Konflikt steht.
  • Fehlende vorgeschriebene Abschnitte oder Qualitätstore aus der Verfassung.

E. Abdeckungslücken

  • Anforderungen ohne zugeordnete Aufgaben.
  • Aufgaben ohne zugeordnete Anforderung/Story.
  • Erfolgskriterien, die baubare Arbeit erfordern (Leistung, Sicherheit, Verfügbarkeit), die nicht in Aufgaben widergespiegelt werden.

F. Inkonsistenz

  • Terminologieabweichung (gleiches Konzept in verschiedenen Dateien unterschiedlich benannt).
  • Datenentitäten, die im Plan referenziert, aber in der Spezifikation nicht vorhanden sind (oder umgekehrt).
  • Widersprüche in der Aufgabenreihenfolge (z.B. Integrationsaufgaben vor grundlegenden Setup-Aufgaben ohne Abhängigkeitshinweis).
  • Sich widersprechende Anforderungen (z.B. eine erfordert Next.js, während eine andere Vue spezifiziert).

5. Schweregradzuweisung

Verwende diese Heuristik, um Erkenntnisse zu priorisieren:

  • KRITISCH: Verstößt gegen Verfassungs-MUST, fehlendes Kern-Spezifikationsartefakt oder Anforderung ohne Abdeckung, die die Basisfunktionalität blockiert.
  • HOCH: Doppelte oder widersprüchliche Anforderung, mehrdeutiges Sicherheits-/Leistungsattribut, nicht testbares Abnahmekriterium.
  • MITTEL: Terminologieabweichung, fehlende nicht-funktionale Aufgabenabdeckung, unterspezifizierter Randfall.
  • NIEDRIG: Stil-/Wortverbesserungen, geringfügige Redundanz ohne Auswirkung auf die Ausführungsreihenfolge.

6. Kompakten Analysebericht erstellen

Gib einen Markdown-Bericht aus (keine Dateischreibvorgänge) mit folgender Struktur:

Spezifikationsanalysebericht

IDKategorieSchweregradOrt(e)ZusammenfassungEmpfehlung
A1DuplikationHOCHspec.md:L120-134Zwei ähnliche Anforderungen ...Formulierung zusammenführen; klarere Version behalten

(Füge eine Zeile pro Erkenntnis hinzu; generiere stabile IDs mit dem Kategorie-Initial als Präfix.)

Abdeckungszusammenfassungstabelle:

AnforderungsschlüsselHat Aufgabe?Aufgaben-IDsAnmerkungen

Verfassungskonformitätsprobleme: (falls vorhanden)

Nicht zugeordnete Aufgaben: (falls vorhanden)

Metriken:

  • Gesamtanforderungen
  • Gesamtaufgaben
  • Abdeckung % (Anforderungen mit >=1 Aufgabe)
  • Ambiguitätsanzahl
  • Duplikatanzahl
  • Anzahl kritischer Probleme

7. Nächste Schritte angeben

Am Ende des Berichts gib einen prägnanten Block „Nächste Schritte“ aus:

  • Wenn kritische Probleme vorhanden sind: Empfehle die Behebung vor /speckit-implement.
  • Wenn nur NIEDRIG/MITTEL: Benutzer kann fortfahren, aber Verbesserungsvorschläge geben.
  • Gib explizite Befehlsvorschläge: z.B. „Führe /speckit-specify mit Verfeinerung aus“, „Führe /speckit-plan aus, um die Architektur anzupassen“, „Bearbeite manuell tasks.md, um Abdeckung für 'performance-metrics' hinzuzufügen“.

8. Korrektur anbieten

Frage den Benutzer: „Möchtest du, dass ich konkrete Korrekturvorschläge für die Top-N-Probleme mache?“ (Wende sie NICHT automatisch an.)

9. Erweiterungshooks prüfen

Prüfe nach dem Bericht, ob .specify/extensions.yml im Projektstammverzeichnis existiert.

  • Falls ja, lies es und suche nach Einträgen unter dem Schlüssel hooks.after_analyze.
  • Falls das YAML nicht geparst werden kann oder ungültig ist, überspringe es nicht stillschweigend: teile dem Benutzer mit, dass .specify/extensions.yml nicht gelesen werden konnte (füge den Parser-Fehler hinzu) und dass keine Hooks geprüft wurden, einschließlich aller dort registrierten zwingend erforderlichen (optional: false) Hooks. Fahre dann normal fort.
  • Filtere Hooks heraus, bei denen enabled explizit false ist. Behandle Hooks ohne enabled-Feld als standardmäßig aktiviert.
  • Versuche für jeden verbleibenden Hook nicht, condition-Ausdrücke zu interpretieren oder auszuwerten:
    • Wenn der Hook kein condition-Feld hat oder dieses null/leer ist, behandle den Hook als ausführbar.
    • Wenn der Hook eine nicht-leere condition definiert, überspringe den Hook und überlasse die Bedingungsauswertung der HookExecutor-Implementierung.
  • Ersetze beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen Punkte (.) durch Bindestriche (-). Beispiel: speckit.git.commit → /speckit-git-commit.
  • Gib für jeden ausführbaren Hook basierend auf seinem optional-Flag Folgendes aus:
    • Optionaler Hook (optional: true):
      ## Erweiterungshooks
      
      **Optionaler Hook**: {extension}
      Befehl: `/{command}`
      Beschreibung: {description}
      
      Aufforderung: {prompt}
      Ausführung: `/{command}`
      
    • Zwingend erforderlicher Hook (optional: false):
      ## Erweiterungshooks
      
      **Automatischer Hook**: {extension}
      Ausführung: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Nach dem Ausgeben des obigen Blocks MUSST du den Hook tatsächlich aufrufen und auf sein Ende warten, bevor du fortfährst. Führe ihn so aus, wie du den Befehl selbst in diesem Agenten/Session ausführen würdest (der Aufruf kann von der obigen literarischen {command}-ID abweichen, z.B. führt ein Skills-Modus-Agent ihn als /skill:speckit-... oder $speckit-... aus). Allein das Ausgeben des Blocks führt den Hook nicht aus.
  • Wenn keine Hooks registriert sind oder .specify/extensions.yml nicht existiert, überspringe stillschweigend.

Betriebsprinzipien

Kontexteffizienz

  • Minimale signifikante Token: Konzentriere dich auf umsetzbare Erkenntnisse, nicht auf erschöpfende Dokumentation.
  • Schrittweise Offenlegung: Lade Artefakte inkrementell; lade nicht den gesamten Inhalt in die Analyse.
  • Token-effiziente Ausgabe: Begrenze die Erkenntnistabelle auf 50 Zeilen; fasse Überlauf zusammen.
  • Deterministische Ergebnisse: Wiederholte Ausführung ohne Änderungen sollte konsistente IDs und Anzahlen erzeugen.

Analyserichtlinien

  • Ändere NIE Dateien (dies ist eine schreibgeschützte Analyse).
  • Halluziniere NIE fehlende Abschnitte (wenn fehlend, melde sie genau).
  • Priorisiere Verfassungsverstöße (diese sind immer KRITISCH).
  • Verwende Beispiele statt erschöpfender Regeln (zitiere spezifische Instanzen, keine generischen Muster).
  • Melde null Probleme ordnungsgemäß (gib einen Erfolgsbericht mit Abdeckungsstatistiken aus).

Kontext

$ARGUMENTS

Individual skills in this repo

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

Verwandte Skills