create-github-issues-for-unmet-specification-requirements

À propos de create-github-issues-for-unmet-specification-requirements

Cette compétence automatise la création d'issues GitHub pour les exigences d'un fichier de spécification qui n'ont pas encore été implémentées dans la base de code. Elle comble l'écart entre les spécifications écrites et le code livré en transformant systématiquement les exigences non satisfaites en issues suivies et exploitables, réduisant ainsi le risque que les besoins documentés soient ignorés silencieusement.

Le flux de travail est compact : il analyse le fichier de spécification pour extraire toutes les exigences, vérifie la base de code pour déterminer le statut d'implémentation de chaque exigence, recherche les issues existantes (via search_issues) pour éviter les doublons, et crée une nouvelle issue par exigence non implémentée (via create_issue) en utilisant le modèle feature_request.yml du dépôt, avec un retour au modèle par défaut en cas d'absence. Chaque issue doit comporter un identifiant d'exigence et une description clairs, des conseils d'implémentation et des critères d'acceptation, avec des étiquettes telles que feature ou enhancement selon le cas. La vérification de l'implémentation inclut la recherche de modèles de code connexes dans la base de code, la vérification des fichiers de spécification associés sous un répertoire /spec/, et la confirmation qu'une exigence n'est pas déjà partiellement implémentée.

Elle s'adresse aux développeurs, chefs techniques et responsables de projet qui travaillent à partir de documents de spécification et souhaitent maintenir leur suivi d'issues synchronisé avec les exigences non satisfaites. Les cas d'utilisation typiques incluent l'initialisation d'un backlog à partir d'une nouvelle spécification, la conciliation d'une spécification avec une base de code existante et l'assurance que chaque exigence dispose d'une issue traçable. Il s'agit d'un flux de travail léger en lecture et création : il lit la spécification et le code, et écrit des issues GitHub via des outils standard, sans opérations destructrices, gestion d'identifiants ou exécution de code, ce qui en fait une solution à faible risque.

FAQ

Que produit cette compétence ?

Une issue GitHub par exigence non implémentée trouvée dans la spécification, chacune avec un identifiant d'exigence et une description, des conseils d'implémentation, des critères d'acceptation et des étiquettes appropriées telles que feature ou enhancement.

Comment évite-t-il de créer des issues en double ?

Avant de créer des issues, il recherche les issues existantes (en utilisant search_issues) et vérifie que chaque exigence n'est pas déjà implémentée ou partiellement implémentée dans la base de code.

Quel modèle d'issue utilise-t-il ?

Il utilise le modèle feature_request.yml du dépôt, et revient au modèle par défaut si celui-ci n'est pas disponible.

Comment détermine-t-il si une exigence est implémentée ?

Il recherche dans la base de code les modèles de code connexes et vérifie les fichiers de spécification associés sous un répertoire /spec/ pour évaluer le statut d'implémentation.

Fournissez-vous le fichier de spécification ?

Oui. La compétence fonctionne sur un fichier de spécification que vous lui indiquez, en extrayant toutes les exigences avant de vérifier le statut d'implémentation.