Entrée Utilisateur
$ARGUMENTS
Vous DEVEZ considérer l'entrée utilisateur avant de continuer (si elle n'est pas vide).
Vérifications Pré-Exécution
Vérifier les hooks d'extension (avant convergence) :
-
Vérifiez si
.specify/extensions.ymlexiste dans la racine du projet. -
S'il existe, lisez-le et cherchez les entrées sous la clé
hooks.before_converge. -
Si le YAML ne peut pas être analysé ou est invalide, ne passez pas en silence : dites à l'utilisateur que
.specify/extensions.ymln'a pas pu être lu (incluez l'erreur d'analyse) et qu'aucun hook n'a été vérifié, y compris les hooks obligatoires (optional: false) qui y sont 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
conditiondu hook :- Si le hook n'a pas de champ
condition, ou s'il est nul/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) :## Hooks d'Extension **Pre-Hook Optionnel** : {extension} Commande : `/{command}` Description : {description} Invite : {prompt} Pour exécuter : `/{command}` -
Hook obligatoire (
optional: false) :## Hooks d'Extension **Pre-Hook Automatique** : {extension} Exécution : `/{command}` EXECUTE_COMMAND : {command} Attendez le résultat de la commande du hook avant de passer à l'Objectif.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'ID littéral
{command}montré ci-dessus, par exemple un agent en mode skills l'exécute comme/skill:speckit-...ou$speckit-...). Le simple fait d'émettre le bloc n'exécute pas le hook.
-
-
Si aucun hook n'est enregistré ou si
.specify/extensions.ymln'existe pas, passez en silence.
Objectif
Combler l'écart entre ce que la spécification, le plan et les tâches d'une fonctionnalité exigent et ce que la base de code implémente actuellement. Lisez spec.md, plan.md et tasks.md comme la seule source d'intention (avec la constitution comme contraintes directrices), évaluez l'état actuel du code, déterminez quelles exigences, critères d'acceptation, décisions de plan et tâches existantes ne sont pas satisfaits, incomplets ou seulement partiellement satisfaits, et ajoutez chaque élément de travail restant comme une nouvelle tâche traçable à la fin de tasks.md afin que /speckit-implement puisse le terminer. Cette commande DOIT s'exécuter uniquement après que /speckit-implement a été exécuté sur le tasks.md actuel, et après que /speckit-tasks a produit un tasks.md complet.
Ce n'est pas un outil de diff et ne suit pas les modifications. Il évalue l'état présent du code par rapport aux artefacts de la fonctionnalité — pas de git, pas de comparaison de branches, pas d'historique.
Contraintes Opérationnelles
AJOUT SEULEMENT, JAMAIS RÉÉCRITURE : La seule écriture de la commande est l'ajout d'une nouvelle section ## Phase N : Convergence à tasks.md. Elle NE DOIT PAS :
- modifier
spec.mdouplan.mdde quelque manière que ce soit ; - réécrire, renuméroter, réorganiser ou supprimer une tâche existante (y compris les tâches d'une phase de Convergence antérieure) ;
- modifier, créer ou supprimer du code applicatif — la complétion des tâches ajoutées est le travail de
/speckit-implement.
Lorsque la base de code satisfait déjà tout, la commande DOIT laisser tasks.md inchangé octet par octet (pas d'en-tête de Convergence vide) et signaler un résultat propre.
Autorité de la Constitution : La constitution du projet (.specify/memory/constitution.md) est non négociable. Le code qui viole un principe DOIT est le constat de la plus haute gravité et produit une tâche de correction correspondante. Si la constitution est un modèle non rempli, ignorez les vérifications de la constitution avec élégance plutôt que d'échouer.
Étapes d'Exécution
1. Initialiser le Contexte de Convergence
Exécutez .specify/scripts/bash/check-prerequisites.sh --json --require-spec --require-tasks --include-tasks une fois depuis la racine du dépôt et analysez le JSON pour obtenir FEATURE_DIR et AVAILABLE_DOCS. Déduisez les chemins absolus :
- SPEC = FEATURE_DIR/spec.md
- PLAN = FEATURE_DIR/plan.md
- TASKS = FEATURE_DIR/tasks.md
- CONSTITUTION =
.specify/memory/constitution.md(si présent)
Si spec.md, plan.md ou tasks.md est manquant, ARRÊTEZ avec un message clair et actionnable nommant la commande prérequise à exécuter (/speckit-specify pour une spec manquante, /speckit-plan pour un plan manquant, /speckit-tasks pour des tâches manquantes). Ne produisez pas de sortie partielle.
Pour les guillemets simples dans les arguments comme "Je m'appelle Groot", utilisez la syntaxe d'échappement : par exemple 'Je m'''appelle Groot' (ou des guillemets doubles si possible : "Je m'appelle Groot").
2. Charger les Artéfacts (Divulgation Progressive)
Chargez uniquement le contexte minimal nécessaire à partir de chaque artéfact :
Depuis spec.md :
- Exigences Fonctionnelles (FR-###)
- Critères de Succès (SC-###) — incluez uniquement les éléments nécessitant un travail constructible ; excluez les mesures de résultat post-lancement et les KPI commerciaux
- User Stories et leurs Scénarios d'Acceptation
- Cas Limites (si présents)
Depuis plan.md :
- Choix d'architecture/stack et décisions techniques
- Références au Modèle de Données
- Phases et points de contact nommés (fichiers/composants que le plan indique devoir être créés ou modifiés)
- Contraintes techniques
Depuis tasks.md :
- IDs des tâches (pour calculer le prochain ID et le prochain numéro de phase)
- Descriptions, regroupement par phase, et chemins de fichiers référencés
Depuis la constitution (si ce n'est pas un modèle non rempli) :
- Noms des principes et énoncés normatifs DOIT/DEVRAIT
3. Construire l'Inventaire des Intents
Créez un modèle interne (ne renvoyez pas les artéfacts bruts) :
- Inventaire des exigences : une clé stable par FR-### / SC-### / scénario d'acceptation d'user-story (par exemple
US1/AC2), plus les décisions du plan et les principes de la constitution qui imposent des obligations constructibles. - Carte du périmètre du code : à partir des chemins de fichiers nommés dans
plan.mdettasks.md, plus une recherche par mot-clé pour les concepts que chaque exigence décrit, dérivez l'ensemble des fichiers sources et composants dans le périmètre d'évaluation. Limitez l'évaluation à ceux-ci — n'inférez pas de périmètre au-delà de ce que les artéfacts définissent.
4. Évaluer la Base de Code et Classer les Constats
Incluez chaque tâche existante dans l'inventaire des intents, indépendamment de l'état des cases à cocher ou de la phase de Convergence : les affirmations d'achèvement ne sont pas des preuves. Vérifiez le comportement actuel par rapport à la spec, au plan, aux tâches et à la constitution ; pour les chaînes de tâches correctives, évaluez le comportement résultant, pas les détails d'implémentation remplacés. Vérifiez à la fois les obligations non satisfaites et l'implémentation qui contredit, dépasse ou sort de l'intention déclarée.
Pour chaque élément de l'inventaire des intents, inspectez le code actuel dans le périmètre et produisez un Constat uniquement là où il y a un écart. Classez chaque constat par type d'écart :
manquant: le travail requis est totalement absent du code.partiel: le travail existe mais ne satisfait pas encore pleinement l'exigence / le critère d'acceptation / la décision du plan.contredit: le code fait quelque chose qui entre en conflit avec l'intention déclarée ou un principe DOIT de la constitution.non demandé: le code contient un travail non demandé par la spec, le plan ou les tâches (signalé pour information — converge ne supprime pas de code, il ajoute seulement une tâche pour réviser/justifier ou le supprimer).
Chaque Constat enregistre : un identifiant stable, la source-ref à laquelle il se rattache, le type-écart, une sévérité, et une courte description lisible avec la preuve (le fichier/la zone observé(e)).
Cas particuliers :
- Peu ou pas de code encore : traitez l'ensemble du périmètre spécifié comme un travail restant
manquantplutôt que d'échouer. - Rien ne reste : produisez zéro constat et suivez la branche convergée à l'Étape 7.
5. Attribuer la Sévérité
- CRITIQUE : viole un principe DOIT de la constitution, ou un écart
manquant/contreditqui bloque la fonctionnalité de base d'une user story P1. - HAUTE : un écart
manquantoupartielsur une exigence fonctionnelle principale ou un critère d'acceptation. - MOYENNE : un écart
partielsur une exigence secondaire, ou un ajoutnon demandéavec une justification peu claire. - BASSE : écarts partiels mineurs, polish, ou ajouts
non demandésà faible risque.
6. Présenter le Résumé des Constats de Session
Avant d'ajouter quoi que ce soit, affichez un résumé compact, classé par sévérité (pas encore d'écritures de fichiers) :
Résumé des Constats de Convergence
| ID | Type d'Écart | Sévérité | Source | Preuve | Travail Restant |
|---|---|---|---|---|---|
| F1 | manquant | HAUTE | FR-008 | Exemple : aucun garde-fou append-only détecté dans path/to/module.py lors de l'écriture de tasks.md | Ajouter l'application de l'append-only |
Mesures récapitulatives :
- Exigences / critères d'acceptation vérifiés
- Décisions du plan vérifiées
- Principes de la constitution vérifiés (ou "ignorée — modèle")
- Constats par type d'écart (manquant / partiel / contredit / non demandé)
- Constats par sévérité
7. Ajouter les Tâches de Convergence (ou signaler la convergence)
S'il y a un ou plusieurs constats actionnables (résultat tasks_appended) :
Ajoutez à la fin de tasks.md, conformément au contrat d'ajout :
-
Parcourez tous les IDs de tâches existants ; soit
Mle maximum. Déterminez le numéro de prochaine phaseN(phase existante la plus haute + 1). -
Écrivez un seul nouvel en-tête de section
## Phase N : Convergence. -
Émettez un élément de liste à cocher par constat actionnable, ordonné CRITIQUE/HAUTE en premier, en attribuant des IDs à remplissage nul
T{M+1:03d}, T{M+2:03d}, …:- [ ] T042 <description impérative> selon <source-ref> (<type-écart>)<source-ref>trace la tâche jusqu'à son origine : par ex.FR-003,SC-002,US1/AC2,plan: décision de stockage,Constitution II.<type-écart>est l'un demanquant,partiel,contredit,non demandé.Les tâches de violation de la Constitution DOIVENT être émises en premier et décrites comme
CRITIQUE. -
Ne réutilisez ni ne renumérotez jamais les IDs existants. Si une phase de Convergence antérieure existe, ajoutez-en une nouvelle, numérotée séparément en dessous — ne touchez pas à l'ancienne.
S'il n'y a aucun constat actionnable (résultat converged) :
- Ne modifiez pas
tasks.mddu tout — pas d'en-tête de phase vide. - Rapportez : "✅ Convergé — l'implémentation satisfait la spec, le plan et les tâches."
- Incluez les comptes récapitulatifs de ce qui a été vérifié.
8. Fournir les Prochaines Actions (Transfert)
- Sur
tasks_appended: indiquez combien de tâches ont été ajoutées et sous quelle phase, et recommandez d'exécuter/speckit-implementpour les terminer ; notez qu'une exécution de convergence ultérieure trouvera moins ou aucun élément restant. - Sur
converged: recommandez de passer à la révision / d'ouvrir une PR. Aucun passage d'implémentation supplémentaire n'est nécessaire pour le périmètre spécifié de cette fonctionnalité.
9. Vérifier les hooks d'extension
Après avoir produit le résultat, vérifiez si .specify/extensions.yml existe dans la racine du projet.
-
S'il existe, lisez-le et cherchez les entrées sous la clé
hooks.after_converge. -
Si le YAML ne peut pas être analysé ou est invalide, ne passez pas en silence : dites à l'utilisateur que
.specify/extensions.ymln'a pas pu être lu (incluez l'erreur d'analyse) et qu'aucun hook n'a été vérifié, y compris les hooks obligatoires (optional: false) qui y sont 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
conditiondu hook :- Si le hook n'a pas de champ
condition, ou s'il est nul/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
-
Signalez le résultat de la convergence (
convergedoutasks_appended) en session avant de lister les hooks, afin que les utilisateurs puissent décider d'exécuter ou non des commandes de suivi optionnelles. -
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) :## Hooks d'Extension **Hook Optionnel** : {extension} Commande : `/{command}` Description : {description} Invite : {prompt} Pour exécuter : `/{command}` -
Hook obligatoire (
optional: false) :## Hooks d'Extension **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'ID littéral
{command}montré ci-dessus, par exemple un agent en mode skills l'exécute comme/skill:speckit-...ou$speckit-...). Le simple fait d'émettre le bloc n'exécute pas le hook.
-
-
Si aucun hook n'est enregistré ou si
.specify/extensions.ymln'existe pas, passez en silence.