Entrée Utilisateur
$ARGUMENTS
Vous DEVEZ considérer l'entrée utilisateur avant de procéder (si elle n'est pas vide).
Vérifications Pré-Exécution
Vérification des hooks d'extension (avant analyse) :
- Vérifiez si
.specify/extensions.ymlexiste à la racine du projet. - S'il existe, lisez-le et recherchez les entrées sous la clé
hooks.before_analyze - Si le YAML ne peut pas être parsé ou est invalide, ne l'ignorez 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) 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 commande à partir des noms de commande des hooks, remplacez les points (
.) par des traits d'union (-). Par exemple,speckit.git.commit→/speckit-git-commit. - Pour chaque hook exécutable, générez la sortie suivante 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) :
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 du## Extension Hooks **Pre-Hook automatique** : {extension} Exécution : `/{command}` EXECUTE_COMMAND : {command} Attendez le résultat de la commande du hook avant de passer à l'Objectif.{command}littéral montré ci-dessus, par exemple un agent en mode compétences 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 si
.specify/extensions.ymln'existe pas, ignorez silencieusement
Objectif
Identifier les incohérences, duplications, ambiguïtés et éléments sous-spécifiés dans les trois artefacts principaux (spec.md, plan.md, tasks.md) avant l'implémentation. Cette commande DOIT s'exécuter uniquement après que /speckit-tasks a produit avec succès un tasks.md complet.
Contraintes de Fonctionnement
STRICTEMENT EN LECTURE SEULE : Ne modifiez aucun fichier. Générez un rapport d'analyse structuré. Proposez un plan de correction optionnel (l'utilisateur doit explicitement approuver avant que des commandes de modification ultérieures ne soient invoquées manuellement).
Autorité de la Constitution : La constitution du projet (.specify/memory/constitution.md) est non négociable dans le cadre de cette analyse. Les conflits avec la constitution sont automatiquement CRITIQUES et nécessitent un ajustement de la spec, du plan ou des tâches—pas une dilution, une réinterprétation ou un ignorance silencieuse du principe. Si un principe lui-même doit changer, cela doit se produire dans une mise à jour de la constitution séparée et explicite en dehors de /speckit-analyze.
Étapes d'Exécution
1. Initialiser le Contexte d'Analyse
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 parsez le JSON pour obtenir FEATURE_DIR et AVAILABLE_DOCS. Dérivez les chemins absolus :
- SPEC = FEATURE_DIR/spec.md
- PLAN = FEATURE_DIR/plan.md
- TASKS = FEATURE_DIR/tasks.md
Abandonnez avec un message d'erreur si un fichier requis est manquant (indiquez à l'utilisateur d'exécuter la commande prérequise manquante). Pour les guillemets simples dans les arguments comme "I'm Groot", utilisez la syntaxe d'échappement : par ex 'I'''m Groot' (ou guillemets doubles si possible : "I'm Groot").
2. Charger les Artefacts (Divulgation Progressive)
Chargez uniquement le contexte minimal nécessaire de chaque artefact :
Depuis spec.md :
- Aperçu/Contexte
- Exigences Fonctionnelles
- Critères de Succès (résultats mesurables — par ex., performance, sécurité, disponibilité, succès utilisateur, impact métier)
- User Stories
- Cas Limites (si présents)
Depuis plan.md :
- Choix d'architecture/stack
- Références au Modèle de Données
- Phases
- Contraintes techniques
Depuis tasks.md :
- ID de Tâches
- Descriptions
- Regroupement par phase
- Marqueurs de parallélisme [P]
- Chemins de fichiers référencés
Depuis la constitution :
- Chargez
.specify/memory/constitution.mdpour la validation des principes
3. Construire des Modèles Sémantiques
Créez des représentations internes (n'incluez pas les artefacts bruts dans la sortie) :
- Inventaire des exigences : Pour chaque Exigence Fonctionnelle (FR-###) et Critère de Succès (SC-###), enregistrez une clé stable. Utilisez l'identifiant explicite FR-/SC- comme clé primaire lorsqu'il est présent, et éventuellement dérivez aussi un slug de phrase impérative pour la lisibilité (par exemple, "User can upload file" →
user-can-upload-file). Incluez uniquement les éléments des Critères de Succès qui nécessitent un travail constructible (par exemple, infrastructure de test de charge, outillage d'audit de sécurité), et excluez les métriques de résultats post-lancement et les KPI métier (par exemple, "Réduire les tickets de support de 50 %"). - Inventaire des actions utilisateur/histoires : Actions utilisateur discrètes avec critères d'acceptation
- Cartographie de couverture des tâches : Mappez chaque tâche à une ou plusieurs exigences ou histoires (inférence par mot-clé / motifs de référence explicites comme des IDs ou des phrases clés)
- Ensemble de règles de la constitution : Extrayez les noms des principes et les déclarations normatives DOIT/DEVRAIT
4. Passes de Détection (Analyse Éco-efficace en Jetons)
Concentrez-vous sur les résultats à fort signal. Limitez à 50 résultats au total ; regroupez le reste dans un résumé de dépassement.
A. Détection des Duplications
- Identifiez les exigences quasi-dupliquées
- Marquez les formulations de moindre qualité pour consolidation
B. Détection des Ambiguïtés
- Signalez les adjectifs vagues (rapide, évolutif, sécurisé, intuitif, robuste) sans critères mesurables
- Signalez les espaces réservés non résolus (TODO, TKTK, ???,
<placeholder>, etc.)
C. Sous-spécification
- Exigences avec verbes mais sans objet ou résultat mesurable
- User stories sans alignement des critères d'acceptation
- Tâches référençant des fichiers ou composants non définis dans la spec/plan
D. Alignement avec la Constitution
- Toute exigence ou élément du plan en conflit avec un principe MUST
- Sections obligatoires ou portails de qualité manquants de la constitution
E. Lacunes de Couverture
- Exigences avec zéro tâche associée
- Tâches sans exigence/histoire mappée
- Critères de Succès nécessitant un travail constructible (performance, sécurité, disponibilité) non reflétés dans les tâches
F. Incohérence
- Dérive terminologique (même concept nommé différemment entre les fichiers)
- Entités de données référencées dans le plan mais absentes de la spec (ou vice versa)
- Contradictions dans l'ordre des tâches (par ex., tâches d'intégration avant les tâches de configuration fondamentale sans note de dépendance)
- Exigences conflictuelles (par ex., une nécessite Next.js tandis qu'une autre spécifie Vue)
5. Attribution de la Sévérité
Utilisez cette heuristique pour prioriser les résultats :
- CRITIQUE : Violation d'un MUST de la constitution, artefact de spec principal manquant, ou exigence avec zéro couverture bloquant la fonctionnalité de base
- HAUTE : Exigence dupliquée ou conflictuelle, attribut de sécurité/performance ambigu, critère d'acceptation non testable
- MOYENNE : Dérive terminologique, couverture de tâche non fonctionnelle manquante, cas limite sous-spécifié
- BASSE : Améliorations de style/formulation, redondance mineure n'affectant pas l'ordre d'exécution
6. Produire un Rapport d'Analyse Compact
Générez un rapport Markdown (aucune écriture de fichier) avec la structure suivante :
Rapport d'Analyse de Spécification
| ID | Catégorie | Sévérité | Emplacement(s) | Résumé | Recommandation |
|---|---|---|---|---|---|
| A1 | Duplication | HAUTE | spec.md:L120-134 | Deux exigences similaires ... | Fusionner la formulation ; garder la version la plus claire |
(Ajoutez une ligne par résultat ; générez des IDs stables préfixés par l'initiale de la catégorie.)
Tableau de Résumé de Couverture :
| Clé d'Exigence | A une Tâche ? | IDs de Tâches | Notes |
|---|
Problèmes d'Alignement de la Constitution : (le cas échéant)
Tâches Non Mappées : (le cas échéant)
Mesures :
- Total des Exigences
- Total des Tâches
- Pourcentage de Couverture (exigences avec >=1 tâche)
- Nombre d'Ambiguïtés
- Nombre de Duplications
- Nombre de Problèmes Critiques
7. Fournir les Actions Suivantes
À la fin du rapport, générez un bloc Actions Suivantes concis :
- Si des problèmes CRITIQUES existent : Recommander une résolution avant
/speckit-implement - Si seulement BASSE/MOYENNE : L'utilisateur peut continuer, mais fournir des suggestions d'amélioration
- Fournir des suggestions de commande explicites : par ex., "Exécutez /speckit-specify avec affinement", "Exécutez /speckit-plan pour ajuster l'architecture", "Modifiez manuellement tasks.md pour ajouter la couverture pour 'performance-metrics'"
8. Proposer une Correction
Demandez à l'utilisateur : "Souhaitez-vous que je suggère des modifications correctives concrètes pour les N principaux problèmes ?" (Ne les appliquez PAS automatiquement.)
9. Vérifier les Hooks d'Extension
Après le rapport, vérifiez si .specify/extensions.yml existe à la racine du projet.
- S'il existe, lisez-le et recherchez les entrées sous la clé
hooks.after_analyze - Si le YAML ne peut pas être parsé ou est invalide, ne l'ignorez 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) 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 commande à partir des noms de commande des hooks, remplacez les points (
.) par des traits d'union (-). Par exemple,speckit.git.commit→/speckit-git-commit. - Pour chaque hook exécutable, générez la sortie suivante 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 du## Extension Hooks **Hook automatique** : {extension} Exécution : `/{command}` EXECUTE_COMMAND : {command}{command}littéral montré ci-dessus, par exemple un agent en mode compétences 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 si
.specify/extensions.ymln'existe pas, ignorez silencieusement
Principes de Fonctionnement
Efficacité du Contexte
- Jetons minimaux à fort signal : Concentrez-vous sur les résultats exploitables, pas sur une documentation exhaustive
- Divulgation progressive : Chargez les artefacts de manière incrémentielle ; ne déversez pas tout le contenu dans l'analyse
- Sortie éco-efficace en jetons : Limitez le tableau des résultats à 50 lignes ; résumez le dépassement
- Résultats déterministes : Relancer sans changements doit produire des IDs et comptes cohérents
Directives d'Analyse
- NE MODIFIEZ JAMAIS les fichiers (ceci est une analyse en lecture seule)
- NE HALLLUCINEZ JAMAIS des sections manquantes (si absentes, signalez-les avec précision)
- Priorisez les violations de la constitution (elles sont toujours CRITIQUES)
- Utilisez des exemples plutôt que des règles exhaustives (citez des instances spécifiques, pas des motifs génériques)
- Signalez zéro problème avec grâce (émettez un rapport de succès avec des statistiques de couverture)
Contexte
$ARGUMENTS