Communitygithub.com

tangjuyo/reels-blocker

Effectue une analyse de cohérence et de qualité non destructive entre spec.md, plan.md et tasks.md après la génération des tâches.

Qu'est-ce que reels-blocker ?

Cette compétence d'agent AI est conçue pour garantir la cohérence et la qualité des artefacts de spécification avant le début de l'implémentation. Elle effectue une analyse structurée en lecture seule des fichiers spec.md, plan.md et tasks.md, en détectant les incohérences, les duplications, les ambiguïtés et les lacunes de couverture. Elle prend en charge les plateformes d'agents comme Claude Code, Cursor et Codex via des commandes slash (par exemple `/speckit-analyze`). Le processus inclut la vérification des hooks d'extension avant et après analyse via `.specify/extensions.yml`, la validation par rapport à la constitution du projet, et la génération d'un rapport d'analyse avec des suggestions de corrections. Les résultats sont présentés dans un format tabulaire avec des niveaux de sévérité (CRITIQUE, HAUTE, MOYENNE, BASSE) et des recommandations concrètes. L'utilisateur doit explicitement approuver toute modification corrective subséquente.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangjuyo/reels-blocker/tree/HEAD/.claude/skills/speckit-analyze

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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.yml existe à 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.yml n'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ù enabled est explicitement false. Traitez les hooks sans champ enabled comme activés par défaut.
  • Pour chaque hook restant, n'essayez pas d'interpréter ou d'évaluer les expressions de condition du 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 condition non vide, ignorez le hook et laissez l'évaluation de la condition à l'implémentation du HookExecutor
  • 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) :
      ## 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.
      
      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 {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.
  • Si aucun hook n'est enregistré ou si .specify/extensions.yml n'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.md pour 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

IDCatégorieSévéritéEmplacement(s)RésuméRecommandation
A1DuplicationHAUTEspec.md:L120-134Deux 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'ExigenceA une Tâche ?IDs de TâchesNotes

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.yml n'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ù enabled est explicitement false. Traitez les hooks sans champ enabled comme activés par défaut.
  • Pour chaque hook restant, n'essayez pas d'interpréter ou d'évaluer les expressions de condition du 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 condition non vide, ignorez le hook et laissez l'évaluation de la condition à l'implémentation du HookExecutor
  • 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) :
      ## Extension Hooks
      
      **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 du {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.
  • Si aucun hook n'est enregistré ou si .specify/extensions.yml n'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

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Skills associés