Entrée Utilisateur
$ARGUMENTS
Vous DEVEZ considérer l'entrée utilisateur avant de procéder (si elle n'est pas vide).
Garde de Périmètre
Le travail de cette commande se limite à la mise à jour de la constitution du projet. Les modèles et commandes dépendants lisent la constitution au moment de l'exécution et ne sont pas modifiés ici.
- Classez chaque partie de l'entrée utilisateur soit comme contenu de la constitution, soit comme une intention séparée non liée à la gouvernance.
- Si l'entrée inclut des demandes d'implémentation de fonctionnalités, de génération de code, de refactoring, de construction ou de déploiement, vous NE DEVEZ PAS les exécuter. Extrayez-les plutôt comme des intentions différées.
- Vous NE DEVEZ PAS créer, modifier ou supprimer des fichiers sources d'application, des routes de fonctionnalités, des composants, des tests, des fichiers de déploiement ou d'autres artefacts non liés au flux de travail de la constitution.
- S'il n'est pas clair qu'une instruction est un contenu de constitution, demandez des clarifications avant d'apporter des modifications.
- Après avoir terminé la mise à jour de la constitution, incluez une section
Actions suivantespour chaque intention différée. Listez l'intention originale et suggérez la commande Spec Kit appropriée, telle que/speckit-specify, sans l'invoquer. - S'il n'y a pas d'intentions non liées à la gouvernance, omettez la section
Actions suivantes.
Vérifications Pré-Exécution
Vérification des hooks d'extension (avant mise à jour de la constitution) :
- Vérifiez si le fichier
.specify/extensions.ymlexiste à la racine du projet. - S'il existe, lisez-le et cherchez les entrées sous la clé
hooks.before_constitution. - Si le YAML ne peut pas être parsé ou est invalide, ne passez pas sous silence : 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) 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
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 commande à 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 le résultat suivant en fonction de son indicateur
optional:- Hook optionnel (
optional: true) :## Hooks d'Extension **Pré-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'ID littéral## Hooks d'Extension **Pré-Hook Automatique** : {extension} Exécution : `/{command}` EXECUTE_COMMAND : {command} Attendez le résultat de la commande du hook avant de passer au Plan.{command}montré ci-dessus, par exemple un agent en mode skills l'exécute comme/skill:speckit-...ou$speckit-...). Émettre le bloc seul ne lance pas le hook.
- Hook optionnel (
- Si aucun hook n'est enregistré ou que
.specify/extensions.ymln'existe pas, passez sous silence.
Plan
Vous mettez à jour la constitution du projet dans .specify/memory/constitution.md. Le squelette de constitution actif est résolu au moment de la commande à partir du constitution-template via la pile de résolution des presets/templates Spec Kit.
Suivez ce flux d'exécution :
-
Exécutez
.specify/scripts/bash/resolve-template.sh constitution-template --jsondepuis la racine du dépôt et analysezTEMPLATE_CONTENTcomme le template actif.- Le résolveur partagé applique les surcharges du projet, en composant les couches de preset et les couches d'extension avant le repli sur le template de base. Il DOIT réussir avant de continuer.
- S'il échoue, arrêtez-vous et signalez l'erreur de résolution ; ne continuez pas avec une seule couche de template contributrice.
- Si
.specify/memory/constitution.mdexiste, chargez-le comme source des valeurs et amendements actuels spécifiques au projet. Préservez les informations toujours applicables lors de l'application du nouveau squelette résolu. - S'il n'existe pas, utilisez le template résolu comme document initial.
- N'écrivez pas dans une couche de template versionnée.
- Identifiez chaque jeton de paramètre de la forme
[ALL_CAPS_IDENTIFIER]. IMPORTANT : L'utilisateur peut avoir besoin de moins ou plus de principes que ceux utilisés dans le template. Si un nombre est spécifié, respectez-le - suivez le template général. Vous mettrez à jour le document en conséquence.
-
Collectez/dérivez les valeurs pour les paramètres :
- Si l'entrée utilisateur (conversation) fournit une valeur, utilisez-la.
- Sinon, déduisez du contexte existant du dépôt (README, docs, versions antérieures de la constitution si intégrées).
- Pour les dates de gouvernance :
RATIFICATION_DATEest la date d'adoption originale (si inconnue, demandez ou mettez TODO),LAST_AMENDED_DATEest aujourd'hui si des modifications sont apportées, sinon conservez la précédente. CONSTITUTION_VERSIONdoit être incrémentée selon les règles du versionnement sémantique :- MAJEUR : Suppressions ou redéfinitions de principes/gouvernance rétrocompatibles.
- MINEUR : Nouveau principe/section ajouté ou guidance étendue de manière significative.
- CORRECTIF : Clarifications, reformulations, corrections de fautes, améliorations non sémantiques.
- Si le type de version est ambigu, proposez un raisonnement avant de finaliser.
-
Rédigez le contenu de la constitution mis à jour en utilisant le template résolu comme structure requise :
- Remplacez chaque paramètre par un texte concret (aucun jeton entre crochets restant, sauf les emplacements de template intentionnellement conservés que le projet a choisi de ne pas encore définir — justifiez explicitement ceux laissés).
- Préservez la hiérarchie des titres ; les commentaires peuvent être supprimés une fois remplacés, sauf s'ils apportent encore des conseils clarificateurs.
- Assurez-vous que chaque section de Principe comporte : une ligne de nom succincte, un paragraphe (ou liste à puces) capturant les règles non négociables, une justification explicite si elle n'est pas évidente.
- Assurez-vous que la section Gouvernance liste la procédure d'amendement, la politique de versionnement et les attentes de révision de conformité.
-
Produisez un Rapport d'Impact de Synchronisation (Sync Impact Report) sous forme de commentaire HTML en haut du fichier de constitution après la mise à jour. Ce rapport est un matériel temporaire pour la révision humaine de l'amendement, pas un contenu de gouvernance ; il est censé être supprimé avant que le fichier de constitution amendé ne soit validé.
- Changement de version : ancienne → nouvelle
- Liste des principes modifiés (ancien titre → nouveau titre si renommé)
- Sections ajoutées
- Sections supprimées
- TODOs de suivi si des paramètres ont été intentionnellement différés.
-
Validation avant la sortie finale :
- Aucun jeton entre crochets inexpliqué restant.
- La ligne de version correspond au rapport.
- Dates au format ISO YYYY-MM-DD.
- Les principes sont déclaratifs, testables et exempts de langage vague (remplacez « devrait » par DOIT/DEVRAIT/SERA avec justification selon le cas).
-
Écrivez la constitution terminée dans
.specify/memory/constitution.md(écrasez). -
Affichez un résumé final à l'utilisateur avec :
- Nouvelle version et justification de la version.
- Tous les paramètres TODO ou éléments différés nécessitant un suivi manuel.
- Message de validation suggéré (par exemple,
docs: amendment de la constitution en vX.Y.Z (ajouts de principes + mise à jour de la gouvernance)). - Une section
Actions suivantespour toute intention différée non liée à la gouvernance.
Exigences de Formatage et de Style :
- Utilisez les titres Markdown exactement comme dans le template (ne descendez/montez pas les niveaux).
- Limitez les longues lignes de justification pour la lisibilité (<100 caractères de préférence) mais ne forcez pas avec des sauts de ligne maladroits.
- Conservez une seule ligne vide entre les sections.
- Évitez les espaces de fin.
Si l'utilisateur fournit des mises à jour partielles (par exemple, seulement une révision de principe), effectuez quand même les étapes de validation et de décision de version.
Si des informations critiques manquent (par exemple, date de ratification vraiment inconnue), insérez TODO(<FIELD_NAME>) : explication et incluez-le dans le Rapport d'Impact de Synchronisation sous les éléments différés.
Écrivez uniquement .specify/memory/constitution.md ; ne créez ni ne modifiez les fichiers source du template.
Vérifications Post-Exécution
Vérification des hooks d'extension (après mise à jour de la constitution) :
Vérifiez si le fichier .specify/extensions.yml existe à la racine du projet.
- S'il existe, lisez-le et cherchez les entrées sous la clé
hooks.after_constitution. - Si le YAML ne peut pas être parsé ou est invalide, ne passez pas sous silence : 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) 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
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 commande à 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 le résultat suivant 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) :
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## Hooks d'Extension **Hook Automatique** : {extension} Exécution : `/{command}` EXECUTE_COMMAND : {command}{command}montré ci-dessus, par exemple un agent en mode skills l'exécute comme/skill:speckit-...ou$speckit-...). Émettre le bloc seul ne lance pas le hook.
- Hook optionnel (
- Si aucun hook n'est enregistré ou que
.specify/extensions.ymln'existe pas, passez sous silence.