Communitygithub.com

tangjuyo/reels-blocker

Convertit les tâches existantes en issues GitHub actionnables, ordonnées par dépendances, à partir des artefacts de conception disponibles.

Qu'est-ce que reels-blocker ?

Cette compétence automatise la transformation d'une liste de tâches structurée (fichier `tasks.md`) en issues GitHub, en respectant l'ordre des dépendances et en évitant les doublons. Elle est conçue pour les projets utilisant les artefacts Specify (constitution, extensions, scripts) et s'intègre via le serveur MCP GitHub. La compétence vérifie d'abord la présence de hooks d'extension avant exécution, puis exécute un script de prérequis (`check-prerequisites.sh`) pour charger le répertoire de fonctionnalité et la liste des documents disponibles. Elle déduplique les issues existantes en parcourant l'historique GitHub avec pagination, et crée uniquement les issues manquantes avec un titre canonique (`T001: description`). Après la conversion, des hooks d'extension post-exécution peuvent être déclenchés. Cela permet aux développeurs de maintenir un lien direct entre les tâches de conception et le suivi de projet dans GitHub, automatiquement et sans duplication.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Entrée utilisateur

$ARGUMENTS

Vous DEVEZ prendre en compte l'entrée utilisateur avant de continuer (si elle n'est pas vide).

Vérifications pré-exécution

Vérification des hooks d'extension (avant la conversion tâches → issues) :

  • Vérifiez si .specify/extensions.yml existe à la racine du projet.
  • S'il existe, lisez-le et cherchez les entrées sous la clé hooks.before_taskstoissues.
  • Si le YAML ne peut pas être parsé ou est invalide, ne passez pas silencieusement : dites à l'utilisateur que .specify/extensions.yml n'a pas pu être lu (incluez l'erreur du parseur) et qu'aucun hook n'a été vérifié, y compris les hooks obligatoires (optional: false) enregistrés, puis continuez normalement.
  • Filtrez les hooks où enabled est explicitement false. Traitez les hooks sans champ enabled comme activés par défaut.
  • Pour chaque hook restant, n'essayez pas d'interpréter ou d'évaluer les expressions de condition :
    • Si le hook n'a pas de champ condition, ou qu'il est null/vide, traitez le hook comme exécutable.
    • Si le hook définit une condition non vide, ignorez le hook et laissez l'évaluation de la condition à l'implémentation du HookExecutor.
  • Lors de la construction des invocations de commandes à partir des noms de commandes de hook, remplacez les points (.) par des traits d'union (-). Par exemple, speckit.git.commit → /speckit-git-commit.
  • Pour chaque hook exécutable, affichez ce qui suit en fonction de son indicateur optional :
    • Hook optionnel (optional: true) :
      ## Extension Hooks
      
      **Pre-Hook optionnel** : {extension}
      Commande : `/{command}`
      Description : {description}
      
      Invite : {prompt}
      Pour exécuter : `/{command}`
      
    • Hook obligatoire (optional: false) :
      ## Extension Hooks
      
      **Pre-Hook automatique** : {extension}
      Exécution : `/{command}`
      EXECUTE_COMMAND : {command}
      
      Attendez le résultat de la commande du hook avant de procéder au Plan. Après avoir émis le bloc ci-dessus, vous DEVEZ réellement invoquer le hook et attendre qu'il se termine avant de continuer. Exécutez-le de la même manière que vous exécuteriez la commande vous-même dans cet agent/session (l'invocation peut différer de l'identifiant littéral `{command}` indiqué ci-dessus, par exemple un agent en mode skills l'exécute comme `/skill:speckit-...` ou `$speckit-...`). Émettre le bloc seul n'exécute pas le hook.
      
  • Si aucun hook n'est enregistré ou que .specify/extensions.yml n'existe pas, passez silencieusement.

Plan

  1. Exécutez .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks depuis la racine du dépôt et analysez la liste FEATURE_DIR et AVAILABLE_DOCS. Tous les chemins doivent être absolus. Pour les guillemets simples dans les arguments comme "I'm Groot", utilisez la syntaxe d'échappement : par exemple 'I'''m Groot' (ou des guillemets doubles si possible : "I'm Groot").
  2. SI EXISTE : Chargez .specify/memory/constitution.md pour les principes du projet et les contraintes de gouvernance.
  3. À partir du script exécuté, extrayez le chemin vers les tâches.
  4. Obtenez le dépôt distant Git en exécutant :
git config --get remote.origin.url

[!CAUTION] NE PROCÉDEZ AUX ÉTAPES SUIVANTES QUE SI LE DÉPÔT DISTANT EST UNE URL GITHUB

  1. Récupérez les issues existantes pour déduplication : Avant de créer quoi que ce soit, construisez l'ensemble des identifiants de tâches que vous allez traiter à partir de tasks.md (chacun est un T suivi d'au moins trois chiffres, par ex. T001 — /speckit-converge attribue de nouveaux ID avec T{M+1:03d}, ce qui est un plancher plutôt qu'un plafond, donc dès qu'un fichier contient plus de 999 tâches, les ID font quatre chiffres ou plus). Utilisez ensuite l'outil list_issues du serveur MCP GitHub pour chercher les issues qui couvrent déjà ces ID. Ne passez pas de valeur state ; l'omettre fait que l'outil retourne à la fois les issues ouvertes et fermées. Demandez perPage: 100 pour limiter le nombre d'appels, et comme l'outil utilise la pagination par curseur, demandez les pages avec le paramètre after (en utilisant le endCursor de la réponse précédente). Pour chaque titre d'issue, faites correspondre le motif d'identifiant de tâche \bT\d{3,}\b (le {3,} accepte les ID à quatre chiffres et plus — avec \d{3} un titre contenant T1000 ne correspondrait pas du tout, car le \b final ne peut pas se placer entre deux chiffres, donc cette tâche serait silencieusement ni dédupliquée ni créée ; les limites de mot empêchent toujours un jeton comme ST001 de correspondre, et forcent la consommation de toute la séquence de chiffres, donc T100 ne peut jamais correspondre à l'intérieur de T1000 ; cela reconnaît aussi les titres écrits comme T001 ..., T001: ... ou [T001] ...) et, quand il correspond à l'un de vos ID de tâches, marquez cet ID comme ayant déjà une issue. Arrêtez la pagination dès que chaque ID de tâche a été trouvé, ou quand il n'y a plus de pages, afin de ne pas continuer à récupérer tout l'historique des issues du dépôt une fois que tous les ID de tâches sont comptabilisés. Cela limite le nombre d'appels sur les dépôts avec un grand historique d'issues et empêche les doublons lorsque la commande est réexécutée après la regénération de tasks.md ou la réinvocation de la compétence.
  2. Pour chaque tâche de la liste, utilisez le serveur MCP GitHub pour créer une nouvelle issue dans le dépôt qui correspond au dépôt distant Git. Les lignes de tâches dans tasks.md commencent par une case à cocher Markdown, donc supprimez d'abord le - [ ] (et les marqueurs [P] / [US#]) pour récupérer l'ID de la tâche et sa description. Créez l'issue avec un titre canonique unique de la forme T001: <description>, avec l'ID écrit une fois suivi de la description de la tâche (par exemple, la ligne - [ ] T001 Créer la structure du projet devient le titre T001: Créer la structure du projet).
    • Ignorez toute tâche dont l'ID est déjà présent dans l'ensemble des issues existantes de l'étape précédente, et signalez-le (par exemple, T001 a déjà une issue, ignoré).
    • Créez uniquement les issues pour les tâches qui n'ont pas encore d'issue correspondante.

[!CAUTION] EN AUCUN CAS NE CRÉEZ D'ISSUES DANS DES DÉPÔTS QUI NE CORRESPONDENT PAS À L'URL DISTANTE

Vérifications post-exécution

Vérification des hooks d'extension (après la conversion tâches → issues) : Vérifiez si .specify/extensions.yml existe à la racine du projet.

  • S'il existe, lisez-le et cherchez les entrées sous la clé hooks.after_taskstoissues.
  • Si le YAML ne peut pas être parsé ou est invalide, ne passez pas silencieusement : dites à l'utilisateur que .specify/extensions.yml n'a pas pu être lu (incluez l'erreur du parseur) et qu'aucun hook n'a été vérifié, y compris les hooks obligatoires (optional: false) enregistrés, puis continuez normalement.
  • Filtrez les hooks où enabled est explicitement false. Traitez les hooks sans champ enabled comme activés par défaut.
  • Pour chaque hook restant, n'essayez pas d'interpréter ou d'évaluer les expressions de condition :
    • Si le hook n'a pas de champ condition, ou qu'il est null/vide, traitez le hook comme exécutable.
    • Si le hook définit une condition non vide, ignorez le hook et laissez l'évaluation de la condition à l'implémentation du HookExecutor.
  • Lors de la construction des invocations de commandes à partir des noms de commandes de hook, remplacez les points (.) par des traits d'union (-). Par exemple, speckit.git.commit → /speckit-git-commit.
  • Pour chaque hook exécutable, affichez ce qui suit en fonction de son indicateur optional :
    • Hook optionnel (optional: true) :
      ## Extension Hooks
      
      **Hook optionnel** : {extension}
      Commande : `/{command}`
      Description : {description}
      
      Invite : {prompt}
      Pour exécuter : `/{command}`
      
    • Hook obligatoire (optional: false) :
      ## Extension Hooks
      
      **Hook automatique** : {extension}
      Exécution : `/{command}`
      EXECUTE_COMMAND : {command}
      
      Après avoir émis le bloc ci-dessus, vous DEVEZ réellement invoquer le hook et attendre qu'il se termine avant de continuer. Exécutez-le de la même manière que vous exécuteriez la commande vous-même dans cet agent/session (l'invocation peut différer de l'identifiant littéral {command} indiqué ci-dessus, par exemple un agent en mode skills l'exécute comme /skill:speckit-... ou $speckit-...). Émettre le bloc seul n'exécute pas le hook.
  • Si aucun hook n'est enregistré ou que .specify/extensions.yml n'existe pas, passez silencieusement.

Individual skills in this repo

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

Skills associés