Objectif de la checklist : "Tests unitaires pour l'anglais"
CONCEPT CRITIQUE : Les checklists sont des TESTS UNITAIRES POUR LA RÉDACTION D'EXIGENCES - elles valident la qualité, la clarté et l'exhaustivité des exigences dans un domaine donné.
PAS pour la vérification/les tests :
- ❌ PAS "Vérifier que le bouton clique correctement"
- ❌ PAS "Tester que la gestion d'erreurs fonctionne"
- ❌ PAS "Confirmer que l'API retourne 200"
- ❌ PAS vérifier si le code/l'implémentation correspond au cahier des charges
POUR la validation de la qualité des exigences :
- ✅ "La hiérarchie visuelle est-elle définie pour tous les types de cartes ?" (exhaustivité)
- ✅ "Le terme 'affichage proéminent' est-il quantifié avec un dimensionnement/positionnement spécifique ?" (clarté)
- ✅ "Les exigences d'état de survol sont-elles cohérentes entre tous les éléments interactifs ?" (cohérence)
- ✅ "Les exigences d'accessibilité sont-elles définies pour la navigation au clavier ?" (couverture)
- ✅ "Le cahier des charges définit-il ce qui se produit lorsque l'image du logo ne se charge pas ?" (cas limites)
Métaphore : Si votre cahier des charges est du code écrit en anglais, la checklist est sa suite de tests unitaires. Vous testez si les exigences sont bien rédigées, complètes, sans ambiguïté et prêtes pour l'implémentation - PAS si l'implémentation fonctionne.
Propriété et cycle de vie des cases à cocher :
- Les checklists personnalisées générées par cette commande sont des artefacts de révision de la qualité des exigences, appartenant au relecteur.
[x]signifie que le relecteur a déterminé que le critère de qualité des exigences est satisfait.[x]ne signifie PAS que le travail d'implémentation est terminé.- Cette commande génère ou ajoute des éléments de checklist ; elle NE DOIT PAS marquer les éléments générés
[x]. - Un agent peut aider à évaluer les éléments uniquement lorsque le relecteur le demande explicitement.
checklists/requirements.mdest une checklist de qualité de cahier des charges intégrée distincte, maintenue par/speckit-specifyet/speckit-clarify; ne traitez pas cette exception comme s'appliquant aux checklists personnalisées générées ici.
Entrée utilisateur
$ARGUMENTS
Vous DEVEZ tenir compte de 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 génération de la checklist) :
- 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_checklist. - Si le YAML ne peut pas être analysé ou est invalide, ne passez pas silencieusement : 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. Considérez 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 commande des hooks, remplacez les points (
.) par des traits d'union (-). Par exemple,speckit.git.commit→/speckit-git-commit. - Pour chaque hook exécutable, produisez la sortie suivante en fonction de son indicateur
optional:- Hook optionnel (
optional: true) :## Hooks d'extension **Pré-hook optionnel** : {extension} Commande : `/{commande}` Description : {description} Invite : {invite} Pour exécuter : `/{commande}` - 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 : `/{commande}` EXECUTE_COMMAND : {commande} Attendez le résultat de la commande du hook avant de passer aux étapes d'exécution.{commande}montré ci-dessus, par exemple, un agent en mode skills l'exécute comme/skill:speckit-...ou$speckit-...). L'émission du bloc seul n'exécute pas le hook.
- Hook optionnel (
- Si aucun hook n'est enregistré ou si
.specify/extensions.ymln'existe pas, passez silencieusement.
Étapes d'exécution
-
Configuration : Exécutez
.specify/scripts/bash/check-prerequisites.sh --json --template checklist-templatedepuis la racine du dépôt et analysez le JSON pour obtenir FEATURE_DIR, la liste AVAILABLE_DOCS et TEMPLATE_CONTENT.- Tous les chemins de fichiers 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. -
Clarifier l'intention (dynamique) : Dérivez jusqu'à TROIS questions clarifiantes contextuelles initiales (pas de catalogue préétabli). Elles DOIVENT :
- Être générées à partir du phrasé de l'utilisateur + des signaux extraits du cahier des charges/plan/tâches.
- Ne demander que des informations qui modifient matériellement le contenu de la checklist.
- Être ignorées individuellement si déjà sans ambiguïté dans
$ARGUMENTS. - Privilégier la précision à l'étendue.
Algorithme de génération :
- Extraire les signaux : mots-clés du domaine de la fonctionnalité (par exemple, auth, latence, UX, API), indicateurs de risque ("critique", "doit", "conformité"), indices des parties prenantes ("QA", "révision", "équipe sécurité"), et livrables explicites ("a11y", "rollback", "contrats").
- Regrouper les signaux en domaines d'intérêt candidats (max 4) classés par pertinence.
- Identifier le public probable et le moment (auteur, relecteur, QA, release) si ce n'est pas explicite.
- Détecter les dimensions manquantes : étendue du périmètre, profondeur/rigueur, accentuation des risques, limites d'exclusion, critères d'acceptation mesurables.
- Formuler des questions choisies parmi ces archétypes :
- Raffinement du périmètre (par exemple, "Cela doit-il inclure les points d'intégration avec X et Y ou rester limité à l'exactitude du module local ?")
- Priorisation des risques (par exemple, "Parmi ces zones de risque potentielles, lesquelles devraient faire l'objet de contrôles d'étape obligatoires ?")
- Calibrage de la profondeur (par exemple, "S'agit-il d'une liste de vérification légère avant validation ou d'une barrière de release formelle ?")
- Cadrage du public (par exemple, "Cela sera-t-il utilisé uniquement par l'auteur ou par les pairs lors de la révision de la PR ?")
- Exclusion de limite (par exemple, "Devons-nous exclure explicitement les éléments de réglage des performances ce tour-ci ?")
- Lacune de classe de scénario (par exemple, "Aucun flux de reprise détecté—les chemins de rollback/échec partiel sont-ils dans le périmètre ?")
Règles de formatage des questions :
- Si des options sont présentées, générez un tableau compact avec les colonnes : Option | Candidate | Pourquoi c'est important
- Limitez à un maximum d'options A–E ; omettez le tableau si une réponse libre est plus claire.
- Ne demandez jamais à l'utilisateur de reformuler ce qu'il a déjà dit.
- Évitez les catégories spéculatives (pas d'hallucination). En cas d'incertitude, demandez explicitement : "Confirmez si X appartient au périmètre."
Valeurs par défaut lorsque l'interaction est impossible :
- Profondeur : Standard
- Public : Relecteur (PR) si lié au code ; Auteur sinon
- Accent : Les 2 premiers clusters de pertinence
Produisez les questions (étiquetez Q1/Q2/Q3). Après les réponses : si ≥2 classes de scénario (Alternatif / Exception / Reprise / Domaine non fonctionnel) restent peu claires, vous POUVEZ poser jusqu'à DEUX suivis supplémentaires ciblés (Q4/Q5) avec une justification d'une ligne chacun (par exemple, "Risque de chemin de reprise non résolu"). Ne dépassez pas cinq questions au total. Ignorez l'escalade si l'utilisateur refuse explicitement d'en ajouter.
-
Comprendre la demande utilisateur : Combinez
$ARGUMENTS+ réponses clarifiantes :- Dérivez le thème de la checklist (par exemple, sécurité, révision, déploiement, UX).
- Consolidez les éléments explicitement obligatoires mentionnés par l'utilisateur.
- Mappez les sélections d'accent vers une structure de catégories.
- Déduisez tout contexte manquant à partir du cahier des charges/plan/tâches (ne HALLLUCINEZ PAS).
-
Charger le contexte de la fonctionnalité : Lisez depuis FEATURE_DIR :
- spec.md : Exigences et périmètre de la fonctionnalité.
- plan.md (s'il existe) : Détails techniques, dépendances.
- tasks.md (s'il existe) : Tâches d'implémentation.
Stratégie de chargement du contexte :
- Chargez uniquement les parties nécessaires pertinentes pour les domaines d'intérêt actifs (évitez de vider le fichier entier).
- Préférez résumer les longues sections en puces concises de scénario/exigence.
- Utilisez la divulgation progressive : ajoutez une récupération ultérieure uniquement si des lacunes sont détectées.
- Si les documents sources sont volumineux, générez des éléments de résumé intermédiaires au lieu d'intégrer le texte brut.
-
Générer la checklist - Utilisez TEMPLATE_CONTENT comme modèle structurel et créez des "Tests unitaires pour les exigences" :
- Créez le répertoire
FEATURE_DIR/checklists/s'il n'existe pas. - Générez un nom de fichier de checklist unique :
- Utilisez un nom court et descriptif basé sur le domaine (par exemple,
ux.md,api.md,security.md). - Format :
[domaine].md
- Utilisez un nom court et descriptif basé sur le domaine (par exemple,
- Comportement de gestion des fichiers :
- Si le fichier n'existe PAS : Créez un nouveau fichier et numérotez les éléments en commençant par CHK001.
- Si le fichier existe : Ajoutez de nouveaux éléments au fichier existant, en continuant à partir du dernier CHK ID (par exemple, si le dernier élément est CHK015, commencez les nouveaux éléments à CHK016).
- Ne supprimez ni ne remplacez jamais le contenu existant de la checklist - conservez et ajoutez toujours.
- Laissez chaque élément nouvellement généré non coché (
[ ]) ; l'état de la case à cocher appartient au relecteur.
PRINCIPE FONDAMENTAL - Tester les exigences, pas l'implémentation : Chaque élément de checklist DOIT évaluer les EXIGENCES ELLES-MÊMES pour :
- Exhaustivité : Toutes les exigences nécessaires sont-elles présentes ?
- Clarté : Les exigences sont-elles sans ambiguïté et spécifiques ?
- Cohérence : Les exigences sont-elles alignées les unes avec les autres ?
- Mesurabilité : Les exigences peuvent-elles être vérifiées objectivement ?
- Couverture : Tous les scénarios/cas limites sont-ils traités ?
Structure des catégories - Regroupez les éléments par dimensions de qualité des exigences :
- Exhaustivité des exigences (Toutes les exigences nécessaires sont-elles documentées ?)
- Clarté des exigences (Les exigences sont-elles spécifiques et sans ambiguïté ?)
- Cohérence des exigences (Les exigences s'alignent-elles sans conflits ?)
- Qualité des critères d'acceptation (Les critères de succès sont-ils mesurables ?)
- Couverture des scénarios (Tous les flux/cas sont-ils traités ?)
- Couverture des cas limites (Les conditions limites sont-elles définies ?)
- Exigences non fonctionnelles (Performance, sécurité, accessibilité, etc. - sont-elles spécifiées ?)
- Dépendances et hypothèses (Sont-elles documentées et validées ?)
- Ambiguïtés et conflits (Qu'est-ce qui doit être clarifié ?)
COMMENT RÉDIGER LES ÉLÉMENTS DE CHECKLIST - "Tests unitaires pour l'anglais" :
❌ MAUVAIS (Test de l'implémentation) :
- "Vérifier que la page d'accueil affiche 3 cartes d'épisode"
- "Tester que les états de survol fonctionnent sur le bureau"
- "Confirmer que le clic sur le logo navigue vers l'accueil"
✅ CORRECT (Test de la qualité des exigences) :
- "Le nombre exact et la disposition des épisodes en vedette sont-ils spécifiés ?" [Exhaustivité]
- "Le terme 'affichage proéminent' est-il quantifié avec un dimensionnement/positionnement spécifique ?" [Clarté]
- "Les exigences d'état de survol sont-elles cohérentes entre tous les éléments interactifs ?" [Cohérence]
- "Les exigences de navigation au clavier sont-elles définies pour toute l'interface utilisateur interactive ?" [Couverture]
- "Le comportement de repli est-il spécifié lorsque l'image du logo ne se charge pas ?" [Cas limites]
- "Les états de chargement sont-ils définis pour les données d'épisode asynchrones ?" [Exhaustivité]
- "Le cahier des charges définit-il la hiérarchie visuelle pour les éléments d'interface concurrents ?" [Clarté]
STRUCTURE DE L'ÉLÉMENT : Chaque élément doit suivre ce modèle :
- Format de question portant sur la qualité des exigences.
- Concentrez-vous sur ce qui est ÉCRIT (ou non écrit) dans le cahier des charges/plan.
- Incluez la dimension de qualité entre crochets [Exhaustivité/Clarté/Cohérence/etc.].
- Référencez la section du cahier des charges
[Spéc §X.Y]lors de la vérification des exigences existantes. - Utilisez le marqueur
[Gap]lors de la vérification des exigences manquantes.
EXEMPLES PAR DIMENSION DE QUALITÉ :
Exhaustivité :
- "Les exigences de traitement des erreurs sont-elles définies pour tous les modes d'échec de l'API ? [Gap]"
- "Les exigences d'accessibilité sont-elles spécifiées pour tous les éléments interactifs ? [Exhaustivité]"
- "Les exigences de point de rupture mobile sont-elles définies pour les mises en page responsives ? [Gap]"
Clarté :
- "Le terme 'chargement rapide' est-il quantifié avec des seuils de temps spécifiques ? [Clarté, Spéc §NFR-2]"
- "Les critères de sélection des 'épisodes connexes' sont-ils définis explicitement ? [Clarté, Spéc §FR-5]"
- "Le terme 'proéminent' est-il défini avec des propriétés visuelles mesurables ? [Ambiguïté, Spéc §FR-4]"
Cohérence :
- "Les exigences de navigation sont-elles alignées sur toutes les pages ? [Cohérence, Spéc §FR-10]"
- "Les exigences du composant carte sont-elles cohérentes entre la page d'accueil et les pages de détail ? [Cohérence]"
Couverture :
- "Les exigences sont-elles définies pour les scénarios d'état zéro (aucun épisode) ? [Couverture, Cas limite]"
- "Les scénarios d'interaction utilisateur simultanée sont-ils traités ? [Couverture, Gap]"
- "Les exigences sont-elles spécifiées pour les échecs de chargement partiel de données ? [Couverture, Flux d'exception]"
Mesurabilité :
- "Les exigences de hiérarchie visuelle sont-elles mesurables/testables ? [Critères d'acceptation, Spéc §FR-1]"
- "Le 'poids visuel équilibré' peut-il être vérifié objectivement ? [Mesurabilité, Spéc §FR-2]"
Classification des scénarios et couverture (Accent sur la qualité des exigences) :
- Vérifiez si les exigences existent pour : les scénarios Primaire, Alternatif, Exception/Erreur, Reprise, Non fonctionnel.
- Pour chaque classe de scénario, demandez : "Les exigences de [type de scénario] sont-elles complètes, claires et cohérentes ?"
- Si une classe de scénario est manquante : "Les exigences de [type de scénario] sont-elles intentionnellement exclues ou manquantes ? [Gap]"
- Incluez la résilience/le rollback lorsqu'une mutation d'état se produit : "Les exigences de rollback sont-elles définies pour les échecs de migration ? [Gap]"
Exigences de traçabilité :
- MINIMUM : ≥80 % des éléments DOIVENT inclure au moins une référence de traçabilité.
- Chaque élément doit référencer : la section du cahier des charges
[Spéc §X.Y], ou utiliser des marqueurs :[Gap],[Ambiguïté],[Conflit],[Hypothèse]. - S'il n'existe pas de système d'ID : "Un schéma d'ID d'exigence et de critères d'acceptation est-il établi ? [Traçabilité]"
Soulever et résoudre les problèmes (Problèmes de qualité des exigences) : Posez des questions sur les exigences elles-mêmes :
- Ambiguïtés : "Le terme 'rapide' est-il quantifié avec des métriques spécifiques ? [Ambiguïté, Spéc §NFR-1]"
- Conflits : "Les exigences de navigation entrent-elles en conflit entre §FR-10 et §FR-10a ? [Conflit]"
- Hypothèses : "L'hypothèse d'une 'API de podcast toujours disponible' est-elle validée ? [Hypothèse]"
- Dépendances :
- Créez le répertoire
…
[Le contenu a été tronqué pour la traduction]