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.ymlexiste à 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.ymln'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ù
enabledest explicitementfalse. Traitez les hooks sans champenabledcomme 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
conditionnon vide, ignorez le hook et laissez l'évaluation de la condition à l'implémentation du HookExecutor.
- Si le hook n'a pas de champ
- 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.
- Hook optionnel (
- Si aucun hook n'est enregistré ou que
.specify/extensions.ymln'existe pas, passez silencieusement.
Plan
- Exécutez
.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasksdepuis la racine du dépôt et analysez la listeFEATURE_DIRetAVAILABLE_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"). - SI EXISTE : Chargez
.specify/memory/constitution.mdpour les principes du projet et les contraintes de gouvernance. - À partir du script exécuté, extrayez le chemin vers les tâches.
- 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
- 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 unTsuivi d'au moins trois chiffres, par ex.T001—/speckit-convergeattribue de nouveaux ID avecT{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'outillist_issuesdu serveur MCP GitHub pour chercher les issues qui couvrent déjà ces ID. Ne passez pas de valeurstate; l'omettre fait que l'outil retourne à la fois les issues ouvertes et fermées. DemandezperPage: 100pour limiter le nombre d'appels, et comme l'outil utilise la pagination par curseur, demandez les pages avec le paramètreafter(en utilisant leendCursorde 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 contenantT1000ne correspondrait pas du tout, car le\bfinal 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 commeST001de correspondre, et forcent la consommation de toute la séquence de chiffres, doncT100ne peut jamais correspondre à l'intérieur deT1000; cela reconnaît aussi les titres écrits commeT001 ...,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 detasks.mdou la réinvocation de la compétence. - 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.mdcommencent 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 formeT001: <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 projetdevient le titreT001: 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.
- 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,
[!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.ymln'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ù
enabledest explicitementfalse. Traitez les hooks sans champenabledcomme 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
conditionnon vide, ignorez le hook et laissez l'évaluation de la condition à l'implémentation du HookExecutor.
- Si le hook n'a pas de champ
- 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) :
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## Extension Hooks **Hook automatique** : {extension} Exécution : `/{command}` EXECUTE_COMMAND : {command}{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.
- Hook optionnel (
- Si aucun hook n'est enregistré ou que
.specify/extensions.ymln'existe pas, passez silencieusement.