Communitygithub.com

tangjuyo/reels-blocker

Wandelt vorhandene Aufgaben basierend auf verfügbaren Design-Artefakten in umsetzbare, abhängigkeitsgeordnete GitHub-Issues für das Feature um.

Was ist reels-blocker?

Diese Skill-Komponente ist darauf ausgelegt, eine `tasks.md`-Datei (die innerhalb des `.specify/`-Projektrahmens generiert wurde) zu nehmen, die Aufgabenbeschreibungen mit IDs wie `T001`, `T002` usw. enthält, und automatisch entsprechende GitHub-Issues zu erstellen. Sie stellt sicher, dass die erstellten Issues die Abhängigkeiten widerspiegeln, die in der ursprünglichen Aufgabenliste definiert sind, wodurch eine strukturierte und deduplizierte Projektverfolgung ermöglicht wird. Die wichtigsten Funktionen umfassen die Überprüfung der Voraussetzungen über ein dediziertes Skript, das Abrufen der Projektprinzipien aus einer optionalen Verfassungsdatei und die Verwendung des GitHub MCP-Servers zur Verwaltung von Issues. Ein robuster Deduplizierungsmechanismus verhindert die Erstellung doppelter Issues, indem er die Titel bestehender Issues auf bereits vorhandene Aufgaben-IDs durchsucht. Darüber hinaus unterstützt sie ein Hooks-System (sowohl vor als auch nach der Konvertierung), das eine Integration mit Erweiterungen wie `speckit` ermöglicht, um benutzerdefinierte Aktionen auszuführen. Es werden strikte Validierungen durchgeführt, um sicherzustellen, dass der Ursprung des Git-Remotes auf GitHub verweist, und es werden keine Issues in anderen Repositorys erstellt.

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

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

Prüfung auf Erweiterungs-Hooks (vor der Aufgaben-zu-Issues-Konvertierung):

  • 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_taskstoissues.
  • Wenn das YAML nicht geparst werden kann oder ungültig ist: 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 zwingenden (optional: false) Hooks, und fahren Sie dann normal fort.
  • Filtern Sie Hooks heraus, bei denen enabled explizit false ist. Behandeln Sie Hooks ohne enabled-Feld als standardmäßig aktiviert.
  • Versuchen Sie nicht, für jeden verbleibenden 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 Auswertung der Bedingung der HookExecutor-Implementierung.
  • Beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen ersetzen Sie 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}
      Führe aus: `/{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 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 literalen {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, fahren Sie still fort.

Gliederung

  1. Führen Sie .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks aus dem Repository-Stammverzeichnis aus und parsen Sie die Liste FEATURE_DIR und AVAILABLE_DOCS. Alle Pfade müssen absolut sein. 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. FALLS VORHANDEN: Laden Sie .specify/memory/constitution.md für Projektprinzipien und Governance-Einschränkungen.
  3. Extrahieren Sie aus dem ausgeführten Skript den Pfad zu den Aufgaben.
  4. Holen Sie den Git-Remote durch Ausführen von:
git config --get remote.origin.url

[!CAUTION] FAHREN SIE NUR MIT DEN NÄCHSTEN SCHRITTEN FORT, WENN DER REMOTE EINE GITHUB-URL IST

  1. Vorhandene Issues für die Deduplizierung abrufen: Bevor Sie etwas erstellen, erstellen Sie den Satz von Aufgaben-IDs, die Sie verarbeiten möchten, aus tasks.md (jede ist ein T gefolgt von mindestens drei Ziffern, z. B. T001 — /speckit-converge weist neue IDs mit T{M+1:03d} zu, was eher eine Untergrenze als eine Obergrenze darstellt, sodass IDs ab einer Datei mit mehr als 999 Aufgaben vierstellig oder länger sind). Verwenden Sie dann das list_issues-Tool des GitHub MCP-Servers, um nach Issues zu suchen, die diese IDs bereits abdecken. Übergeben Sie keinen state-Wert, da das Weglassen dazu führt, dass das Tool sowohl offene als auch geschlossene Issues zurückgibt. Fordern Sie perPage: 100 an, um die Anzahl der Aufrufe gering zu halten, und da das Tool cursor-basierte Paginierung verwendet, fordern Sie Seiten mit dem Parameter after (unter Verwendung des endCursor aus der vorherigen Antwort) an. Überprüfen Sie für jeden Issue-Titel die Übereinstimmung mit dem Aufgaben-ID-Muster \bT\d{3,}\b (das {3,} akzeptiert vierstellige und längere IDs – mit \d{3} würde ein Titel, der T1000 enthält, überhaupt nicht übereinstimmen, da das abschließende \b nicht zwischen zwei Ziffern fallen kann, sodass diese Aufgabe weder dedupliziert noch erstellt würde; Wortgrenzen verhindern immer noch, dass ein Token wie ST001 übereinstimmt, und erzwingen, dass die gesamte Ziffernsequenz konsumiert wird, sodass T100 niemals innerhalb von T1000 übereinstimmen kann; dies erkennt auch Titel, die als T001 ..., T001: ... oder [T001] ... geschrieben sind) und markieren Sie, wenn es mit einer Ihrer Aufgaben-IDs übereinstimmt, diese ID als bereits vorhandenes Issue. Beenden Sie die Paginierung, sobald jede Aufgaben-ID gefunden wurde, oder wenn es keine weiteren Seiten mehr gibt, damit Sie nicht die gesamte Issue-Historie des Repositorys abrufen, sobald alle Aufgaben-IDs berücksichtigt sind. Dies begrenzt die Anzahl der Aufrufe bei Repositorys mit großen Issue-Historien und verhindert dennoch Duplikate, wenn der Befehl erneut ausgeführt wird, nachdem tasks.md neu generiert oder die Skill erneut aufgerufen wurde.
  2. Erstellen Sie für jede Aufgabe in der Liste mit dem GitHub MCP-Server ein neues Issue in dem Repository, das für den Git-Remote repräsentativ ist. Aufgabenzeilen in tasks.md beginnen mit einer Markdown-Checkbox, entfernen Sie daher zunächst das führende - [ ] (und alle Marker [P] / [US#]), um die Aufgaben-ID und ihre Beschreibung wiederherzustellen. Erstellen Sie das Issue mit einem einzigen kanonischen Titel der Form T001: <description>, wobei die ID einmal gefolgt von der Aufgabenbeschreibung geschrieben wird (z. B. wird die Zeile - [ ] T001 Create project structure zum Titel T001: Erstelle Projektstruktur).
    • Überspringen Sie jede Aufgabe, deren ID bereits im Satz vorhandener Issues aus dem vorherigen Schritt vorhanden ist, und melden Sie dies (z. B. T001 hat bereits ein Issue, überspringe).
    • Erstellen Sie nur Issues für Aufgaben, die noch kein passendes Issue haben.

[!CAUTION] ERSTELLEN SIE UNTER KEINEN UMSTÄNDEN ISSUES IN REPOSITORIES, DIE NICHT MIT DER REMOTE-URL ÜBEREINSTIMMEN

Post-Execution-Checks

Prüfung auf Erweiterungs-Hooks (nach der Aufgaben-zu-Issues-Konvertierung): 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_taskstoissues.
  • Wenn das YAML nicht geparst werden kann oder ungültig ist: 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 zwingenden (optional: false) Hooks, und fahren Sie dann normal fort.
  • Filtern Sie Hooks heraus, bei denen enabled explizit false ist. Behandeln Sie Hooks ohne enabled-Feld als standardmäßig aktiviert.
  • Versuchen Sie nicht, für jeden verbleibenden 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 Auswertung der Bedingung der HookExecutor-Implementierung.
  • Beim Erstellen von Befehlsaufrufen aus Hook-Befehlsnamen ersetzen Sie 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}
      Führe aus: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Nachdem Sie den obigen Block ausgegeben haben, 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 literalen {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, fahren Sie still fort.

Individual skills in this repo

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

Verwandte Skills