Communitygithub.com

tangjuyo/reels-blocker

Generiert eine ausführbare, abhängigkeitsgeordnete tasks.md für eine Funktion basierend auf verfügbaren Design-Artefakten.

Was ist reels-blocker?

Dieses Skill automatisiert die Erstellung einer strukturierten tasks.md-Datei, die alle Schritte zur Implementierung einer Software-Funktion auflistet. Es analysiert Design-Dokumente wie plan.md, spec.md und optionale Artefakte (data-model.md, contracts/, research.md), extrahiert User Stories mit Prioritäten und generiert daraus abhängigkeitsgeordnete Aufgaben (Tasks). Das Skill stellt sicher, dass Aufgaben strengen Formatierungsregeln folgen (Checkliste mit ID, Labels, Dateipfaden) und unterstützt optionale sowie obligatorische Erweiterungs-Hooks vor und nach der Generierung. Es ist ideal für Developer, die reproduzierbare, direkt ausführbare Aufgabenlisten für KI-Agenten (z.B. Claude Code, Cursor) benötigen, die parallel ausgeführt werden können und eine klare MVP-Abgrenzung bieten.

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

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

Vorab-Prüfungen

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

  • Prüfen Sie, ob .specify/extensions.yml im Projektstamm existiert.
  • Wenn es existiert, lesen Sie es und suchen Sie nach Einträgen unter dem Schlüssel hooks.before_tasks.
  • 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 (inklusive des Parser-Fehlers) und dass keine Hooks geprü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 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 basierend auf seinem optional-Flag Folgendes aus:
    • Optionaler Hook (optional: true):
      ## Erweiterungs-Hooks
      
      **Optionaler Pre-Hook**: {extension}
      Befehl: `/{command}`
      Beschreibung: {description}
      
      Eingabeaufforderung: {prompt}
      Zur Ausführung: `/{command}`
      
    • Obligatorischer Hook (optional: false):
      ## Erweiterungs-Hooks
      
      **Automatischer Pre-Hook**: {extension}
      Ausführen: `/{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 dessen Beendigung warten, bevor Sie fortfahren. Führen Sie ihn auf dieselbe Weise aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten literalen {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

  1. Einrichtung: Führen Sie .specify/scripts/bash/setup-tasks.sh --json vom Repository-Stamm aus aus und parsen Sie FEATURE_DIR, TASKS_TEMPLATE_CONTENT, TASKS_TEMPLATE und die Liste AVAILABLE_DOCS. FEATURE_DIR und TASKS_TEMPLATE müssen absolute Pfade sein, wenn sie angegeben werden. AVAILABLE_DOCS ist eine Liste von Dokumentnamen/relativen Pfaden, die unter FEATURE_DIR verfügbar sind (z. B. research.md oder contracts/). Für einfache Anführungszeichen in Argumenten wie "I'm Groot" verwenden Sie die Escape-Syntax: z. B. 'I'''m Groot' (oder doppelte Anführungszeichen, wenn möglich: "I'm Groot").

  2. Design-Dokumente laden: Lesen Sie aus FEATURE_DIR:

    • Erforderlich: plan.md (Tech-Stack, Bibliotheken, Struktur), spec.md (User Stories mit Prioritäten)
    • Optional: data-model.md (Entitäten), contracts/ (Schnittstellenverträge), research.md (Entscheidungen), quickstart.md (Testszenarien)
    • FALLS VORHANDEN: Laden Sie .specify/memory/constitution.md für Projektprinzipien und Governance-Einschränkungen.
    • Hinweis: Nicht alle Projekte haben alle Dokumente. Generieren Sie Aufgaben basierend auf dem, was verfügbar ist.
  3. Aufgabengenerierungs-Workflow ausführen:

    • Laden Sie plan.md und extrahieren Sie Tech-Stack, Bibliotheken, Projektstruktur.
    • Laden Sie spec.md und extrahieren Sie User Stories mit ihren Prioritäten (P1, P2, P3, usw.)
    • Wenn data-model.md existiert: Extrahieren Sie Entitäten und ordnen Sie sie User Stories zu.
    • Wenn contracts/ existiert: Ordnen Sie Schnittstellenverträge User Stories zu.
    • Wenn research.md existiert: Extrahieren Sie Entscheidungen für Einrichtungsaufgaben.
    • Generieren Sie Aufgaben, organisiert nach User Story (siehe Aufgabengenerierungs-Regeln unten).
    • Generieren Sie einen Abhängigkeitsgraphen, der die Reihenfolge der User-Story-Abschlüsse anzeigt.
    • Erstellen Sie Beispiele für parallele Ausführung pro User Story.
    • Validieren Sie die Vollständigkeit der Aufgaben (jede User Story hat alle benötigten Aufgaben, unabhängig testbar).
  4. tasks.md generieren: Verwenden Sie TASKS_TEMPLATE_CONTENT (aus der obigen JSON-Ausgabe) als Struktur. Aus Kompatibilitätsgründen mit älteren Setup-Skripten, die TASKS_TEMPLATE_CONTENT auslassen, lesen Sie stattdessen TASKS_TEMPLATE. Füllen Sie mit:

    • Korrekter Funktionsname aus plan.md.
    • Phase 1: Einrichtungsaufgaben (Projektinitialisierung).
    • Phase 2: Grundlegende Aufgaben (blockierende Voraussetzungen für alle User Stories).
    • Phase 3+: Eine Phase pro User Story (in Prioritätsreihenfolge aus spec.md).
    • Jede Phase umfasst: Story-Ziel, unabhängige Testkriterien, Tests (falls angefordert), Implementierungsaufgaben.
    • Abschlussphase: Polieren & übergreifende Belange.
    • Alle Aufgaben MÜSSEN dem strengen Checklistenformat folgen (siehe Aufgabengenerierungs-Regeln unten).
    • Klare Dateipfade für jede Aufgabe.
    • Abschnitt "Abhängigkeiten", der die Reihenfolge der Story-Abschlüsse anzeigt.
    • Beispiele für parallele Ausführung pro Story.
    • Abschnitt zur Implementierungsstrategie (MVP zuerst, inkrementelle Auslieferung).

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 Projektstamm existiert.

  • Wenn es nicht existiert oder keine Hooks unter dem Schlüssel hooks.after_tasks 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_tasks.
  • 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 (inklusive des Parser-Fehlers) und dass keine Hooks geprü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 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 basierend auf seinem optional-Flag Folgendes aus:
    • Obligatorischer Hook (optional: false) — Sie MÜSSEN EXECUTE_COMMAND: für jeden obligatorischen Hook ausgeben:
      ## Erweiterungs-Hooks
      
      **Automatischer Hook**: {extension}
      Ausführen: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Nach dem Ausgeben des obigen Blocks MÜSSEN Sie den Hook tatsächlich aufrufen und auf dessen Beendigung warten, bevor Sie fortfahren. Führen Sie ihn auf dieselbe Weise aus, wie Sie den Befehl selbst in diesem Agenten/Session ausführen würden (der Aufruf kann von der oben gezeigten literalen {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 Hook**: {extension}
      Befehl: `/{command}`
      Beschreibung: {description}
      
      Eingabeaufforderung: {prompt}
      Zur Ausführung: `/{command}`
      

Abschlussbericht

Geben Sie den Pfad zur generierten tasks.md und eine Zusammenfassung aus:

  • Gesamtanzahl der Aufgaben
  • Aufgabenanzahl pro User Story
  • Identifizierte Parallelisierungsmöglichkeiten
  • Unabhängige Testkriterien für jede Story
  • Vorgeschlagener MVP-Umfang (typischerweise nur User Story 1)
  • Formatvalidierung: Bestätigen Sie, dass ALLE Aufgaben dem Checklistenformat folgen (Checkbox, ID, Labels, Dateipfade)

Kontext für die Aufgabengenerierung: $ARGUMENTS

Die tasks.md sollte sofort ausführbar sein - jede Aufgabe muss spezifisch genug sein, dass ein LLM sie ohne zusätzlichen Kontext abschließen kann.

Aufgabengenerierungs-Regeln

KRITISCH: Aufgaben MÜSSEN nach User Story organisiert sein, um unabhängige Implementierung und Tests zu ermöglichen.

Tests sind OPTIONAL: Generieren Sie Testaufgaben nur, wenn dies in der Funktionsspezifikation explizit angefordert wird oder der Benutzer einen TDD-Ansatz wünscht.

Checklistenformat (ERFORDERLICH)

Jede Aufgabe MUSS strikt diesem Format folgen:

- [ ] [Aufgaben-ID] [P?] [Story?] Beschreibung mit Dateipfad

Formatkomponenten:

  1. Checkbox: BEGINNEN SIE IMMER mit - [ ] (Markdown-Checkbox)
  2. Aufgaben-ID: Fortlaufende Nummer (T001, T002, T003...) in Ausführungsreihenfolge
  3. [P] Marker: Nur einfügen, wenn die Aufgabe parallelisierbar ist (unterschiedliche Dateien, keine Abhängigkeiten von unvollständigen Aufgaben)
  4. [Story] Label: ERFORDERLICH nur für Aufgaben in User-Story-Phasen
    • Format: [US1], [US2], [US3], usw. (entspricht User Stories aus spec.md)
    • Einrichtungsphase: KEIN Story-Label
    • Grundlagenphase: KEIN Story-Label
    • User-Story-Phasen: MÜSSEN Story-Label haben
    • Abschlussphase: KEIN Story-Label
  5. Beschreibung: Klare Aktion mit exaktem Dateipfad

Beispiele:

  • ✅ RICHTIG: - [ ] T001 Projektstruktur gemäß Implementierungsplan erstellen
  • ✅ RICHTIG: - [ ] T005 [P] Authentifizierungs-Middleware in src/middleware/auth.py implementieren
  • ✅ RICHTIG: - [ ] T012 [P] [US1] Benutzermodell in src/models/user.py erstellen
  • ✅ RICHTIG: - [ ] T014 [US1] UserService in src/services/user_service.py implementieren
  • ❌ FALSCH: - [ ] Benutzermodell erstellen (fehlende ID und Story-Label)
  • ❌ FALSCH: T001 [US1] Modell erstellen (fehlende Checkbox)
  • ❌ FALSCH: - [ ] [US1] Benutzermodell erstellen (fehlende Aufgaben-ID)
  • ❌ FALSCH: - [ ] T001 [US1] Modell erstellen (fehlender Dateipfad)

Aufgabenorganisation

  1. Aus User Stories (spec.md) - PRIMÄRE ORGANISATION:

    • Jede User Story (P1, P2, P3...) erhält eine eigene Phase.
    • Ordnen Sie alle zugehörigen Komponenten ihrer Story zu:
      • Modelle, die für diese Story benötigt werden
      • Dienste, die für diese Story benötigt werden
      • Schnittstellen/UI, die für diese Story benötigt werden
      • Wenn Tests angefordert: Tests, die für diese Story spezifisch sind
    • Markieren Sie Story-Abhängigkeiten (die meisten Stories sollten unabhängig sein).
  2. Aus Verträgen:

    • Ordnen Sie jeden Schnittstellenvertrag → der User Story zu, die er bedient.
    • Wenn Tests angefordert: Jeder Schnittstellenvertrag → Vertragstestaufgabe [P] vor der Implementierung in der Phase dieser Story.
  3. Aus Datenmodell:

    • Ordnen Sie jede Entität der/den User Story(s) zu, die sie benötigt.
    • Wenn eine Entität mehrere Stories bedient: Platzieren Sie sie in der frühesten Story oder in der Einrichtungsphase.
    • Beziehungen → Aufgaben auf Dienstebene in der entsprechenden Story-Phase.
    • Zitieren Sie für jedes Feld mit Einschränkungen in data-model.md (max_length, nullable/required, Enum-Werte, Validierungsregeln) die Einschränkung wörtlich in der Aufgabenbeschreibung, damit sie nicht dem Ermessen zur Implementierungszeit überlassen bleibt.
  4. Aus Einrichtung/Infrastruktur:

    • Gemeinsame Infrastruktur → Einrichtungsphase (Phase 1)
    • Grundlegende/blockierende Aufgaben → Grundlagenphase (Phase 2)
    • Story-spezifische Einrichtung → innerhalb der Phase dieser Story.

Phasenstruktur

  • Phase 1: Einrichtung (Projektinitialisierung)
  • Phase 2: Grundlagen (blockierende Voraussetzungen - MÜSSEN vor User Stories abgeschlossen sein)
  • Phase 3+: User Stories in Prioritätsreihenfolge (P1, P2, P3...)
    • Innerhalb jeder Story: Tests (falls angefordert) → Modelle → Dienste → Endpunkte → Integration
    • Jede Phase sollte ein vollständiges, unabhängig testbares Inkrement sein.
  • Abschlussphase: Polieren & übergreifende Belange

Erledigt, wenn

  • tasks.md mit allen Phasen, Aufgaben-IDs und Dateipfaden generiert
  • Erweiterungs-Hooks gemäß den Regeln unter "Obligatorische Post-Execution-Hooks" ausgelöst oder übersprungen
  • Abschlussbericht an den Benutzer mit Aufgabenanzahl, Story-Aufschlüsselung und MVP-Umfang

Individual skills in this repo

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

Verwandte Skills