Communitygithub.com

Implementierungsplanungs-Workflow (tangjuyo/reels-blocker)

Führt den Implementierungsplanungs-Workflow unter Verwendung der Planvorlage aus, um Design-Artefakte zu generieren.

Was ist reels-blocker)?

Dieser Skill (tangjuyo/reels-blocker) automatisiert den Implementierungsplanungsprozess für Softwareentwicklungsprojekte. Er führt einen strukturierten Workflow aus, der auf einer Planvorlage basiert, um Design-Artefakte wie `research.md`, `data-model.md`, Verträge und einen Quickstart-Leitfaden zu generieren. Der Skill unterstützt die Integration von Erweiterungs-Hooks (vor und nach der Planung) über eine `.specify/extensions.yml`-Konfiguration, die optionale oder obligatorische Pre-/Post-Hooks auslösen kann. Er führt zunächst Pre-Execution-Checks durch, um Erweiterungen zu erkennen und optional auszuführen, lädt dann den Kontext aus einer Feature-Spezifikation und einer Verfassungsdatei und durchläuft Phasen 0 (Forschung) und 1 (Design & Verträge). Der Skill ist für agentenbasierte Entwicklungsumgebungen (wie Cursor, Codex, Claude Code) konzipiert, die Skills/Plugins unterstützen. Er stellt sicher, dass alle Unklarheiten in der technischen Analyse aufgelöst, Design-Entscheidungen dokumentiert und Validierungsszenarien definiert werden. Am Ende wird ein Abschlussbericht mit dem Branch, dem Planpfad und allen generierten Artefakten erstellt.

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

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).

Pre-Execution Checks

Auf Erweiterungs-Hooks prüfen (vor der Planung):

  • Prüfen, 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_plan.
  • 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 (geben Sie den Parser-Fehler an) und dass keine Hooks überprüft wurden, einschließlich aller dort registrierten obligatorischen (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 nicht, condition-Ausdrücke von Hooks zu interpretieren oder auszuwerten:
    • Wenn der Hook kein condition-Feld hat oder es 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 Auswertung der Bedingung 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}`
      
    • 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.
      
      Nachdem Sie den obigen Block ausgegeben haben, MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Abschluss warten, bevor Sie fortfahren. Führen Sie ihn so aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (die Aufrufmethode kann von der oben gezeigten literal {command}-ID abweichen, z.B. führt ein Skills-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 stillschweigend.

Gliederung

  1. Setup: Führen Sie .specify/scripts/bash/setup-plan.sh --json vom Repository-Stammverzeichnis aus und parsen Sie JSON für FEATURE_SPEC, IMPL_PLAN, FEATURE_DIR, BRANCH. Verwenden Sie für einfache Anführungszeichen in Argumenten wie „I'm Groot“ Escape-Syntax: z.B. 'I'''m Groot' (oder falls möglich doppelte Anführungszeichen: "I'm Groot").

  2. Kontext laden: Lesen Sie FEATURE_SPEC und .specify/memory/constitution.md. Laden Sie die IMPL_PLAN-Vorlage (bereits kopiert).

  3. Plan-Workflow ausführen: Folgen Sie der Struktur in der IMPL_PLAN-Vorlage:

    • Technischen Kontext ausfüllen (Unbekannte als „NEEDS CLARIFICATION“ markieren)
    • Verfassungscheck-Abschnitt aus der Verfassung ausfüllen
    • Tore bewerten (FEHLER bei ungerechtfertigten Verstößen)
    • Phase 0: research.md generieren (alle NEEDS CLARIFICATION auflösen)
    • Phase 1: data-model.md, contracts/, quickstart.md generieren
    • Verfassungscheck nach dem Design erneut bewerten

Obligatorische Post-Execution Hooks

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

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

  • Wenn es nicht existiert oder keine Hooks unter hooks.after_plan registriert sind, überspringen Sie zum Abschlussbericht.
  • Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel hooks.after_plan.
  • 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 (geben Sie den Parser-Fehler an) und dass keine Hooks überprüft wurden, einschließlich aller dort registrierten obligatorischen (optional: false) Hooks. 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 nicht, condition-Ausdrücke von Hooks zu interpretieren oder auszuwerten:
    • Wenn der Hook kein condition-Feld hat oder es 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 Auswertung der Bedingung 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:
    • Obligatorischer Hook (optional: false) — Sie MÜSSEN für jeden obligatorischen Hook EXECUTE_COMMAND: ausgeben:
      ## Erweiterungs-Hooks
      
      **Automatischer Hook**: {extension}
      Ausführung: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Nachdem Sie den obigen Block ausgegeben haben, MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Abschluss warten, bevor Sie fortfahren. Führen Sie ihn so aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (die Aufrufmethode kann von der oben gezeigten literal {command}-ID abweichen, z.B. führt ein Skills-Modus-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 Hook**: {extension}
      Befehl: `/{command}`
      Beschreibung: {description}
      
      Prompt: {prompt}
      Zur Ausführung: `/{command}`
      

Abschlussbericht

Der Befehl endet nach dem Phase-1-Design. Berichten Sie den Branch, den IMPL_PLAN-Pfad und die generierten Artefakte.

Phasen

Phase 0: Gliederung & Recherche

  1. Unbekannte aus dem technischen Kontext extrahieren (oben):

    • Für jedes NEEDS CLARIFICATION → Rechercheaufgabe
    • Für jede Abhängigkeit → Best-Practices-Aufgabe
    • Für jede Integration → Musteraufgabe
  2. Recherche-Agenten generieren und einsetzen:

    Für jede Unbekannte im technischen Kontext:
      Aufgabe: „Recherchiere {unknown} für {feature Kontext}"
    Für jede Technologieentscheidung:
      Aufgabe: „Finde Best Practices für {tech} in {domain}"
    
  3. Ergebnisse konsolidieren in research.md mit folgendem Format:

    • Entscheidung: [was gewählt wurde]
    • Begründung: [warum gewählt]
    • Alternativen betrachtet: [was sonst noch bewertet wurde]

Ausgabe: research.md mit allen aufgelösten NEEDS CLARIFICATION

Phase 1: Design & Verträge

Voraussetzungen: research.md vollständig

  1. Entitäten aus der Feature-Spezifikation extrahieren → data-model.md:

    • Entitätsname, Felder, Beziehungen
    • Validierungsregeln aus den Anforderungen
    • Zustandsübergänge, falls zutreffend
  2. Schnittstellenverträge definieren (falls das Projekt externe Schnittstellen hat) → /contracts/:

    • Identifizieren Sie, welche Schnittstellen das Projekt Benutzern oder anderen Systemen bereitstellt
    • Dokumentieren Sie das Vertragsformat, das für den Projekttyp geeignet ist
    • Beispiele: öffentliche APIs für Bibliotheken, Befehls-Schemas für CLI-Tools, Endpunkte für Webdienste, Grammatiken für Parser, UI-Verträge für Anwendungen
    • Überspringen Sie, wenn das Projekt rein intern ist (Build-Skripte, Einmal-Tools usw.)
  3. Quickstart-Validierungsleitfaden erstellen → quickstart.md:

    • Dokumentieren Sie ausführbare Validierungsszenarien, die belegen, dass die Funktion vollständig funktioniert
    • Fügen Sie Voraussetzungen, Setup-Befehle, Test-/Ausführungsbefehle und erwartete Ergebnisse ein
    • Verwenden Sie Links oder Verweise auf Verträge und Datenmodelldetails, anstatt sie zu duplizieren
    • Fügen Sie keinen vollständigen Implementierungscode, keine Modell-/Service-/Controller-Körper, keine Migrationen oder vollständigen Testsuiten ein
    • Halten Sie dieses Artefakt als Validierungs-/Ausführungsleitfaden; Implementierungsdetails gehören in tasks.md und die Implementierungsphase

Ausgabe: data-model.md, /contracts/*, quickstart.md

Wichtige Regeln

  • Verwenden Sie absolute Pfade für Dateisystemoperationen; verwenden Sie projektrelative Pfade für Verweise in der Dokumentation
  • FEHLER bei Torverletzungen oder ungelösten Klarstellungen

Erledigt, wenn

  • Plan-Workflow ausgeführt und Design-Artefakte generiert
  • Erweiterungs-Hooks gemäß den Regeln im Abschnitt „Obligatorische Post-Execution Hooks“ ausgeführt oder übersprungen
  • Abschluss dem Benutzer mit Branch, Planpfad und generierten Artefakten gemeldet

Individual skills in this repo

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

Verwandte Skills