spec-kit

Spec Kit est une boîte à outils open source de GitHub qui aide les équipes à utiliser le développement piloté par les spécifications (SDD) avec des agents de codage IA. Au lieu de traiter les spécifications comme un échafaudage jetable, le SDD rend les spécifications exécutables : elles génèrent directement des implémentations fonctionnelles. La boîte à outils fournit un processus piloté par les spécifications prêt à l'emploi, qui peut être personnalisé ou remplacé par votre propre flux de travail. Le composant principal est la CLI Specify, installée via uv ou PyPI. Après avoir exécuté `specify init`, elle configure un projet et installe des commandes slash ou des compétences d'agent pour les agents de codage IA courants. Les intégrations prises en charge incluent plus de 30 agents de codage basés sur CLI et IDE, tels que Copilot, Codex, Claude Code, et d'autres. Les commandes slash principales suivent un flux de travail structuré : - `/speckit.constitution` — établir les principes du projet et les lignes directrices de développement - `/speckit.specify` — définir ce qu'il faut construire (exigences et récits utilisateur) - `/speckit.plan` — créer un plan de mise en œuvre technique - `/speckit.tasks` — décomposer le plan en tâches actionnables - `/speckit.taskstoissues` — convertir les tâches en issues GitHub - `/speckit.implement` — exécuter les tâches pour construire la fonctionnalité - `/speckit.converge` — comparer l'implémentation à la spec, au plan et aux tâches, puis ajouter le travail restant sous forme de nouvelles tâches Les commandes facultatives incluent `/speckit.clarify` pour clarifier les zones sous-spécifiées, `/speckit.analyze` pour les contrôles de cohérence entre artefacts, et `/speckit.checklist` pour des listes de contrôle qualité personnalisées. Le dépôt inclut également des extensions optionnelles. Une extension de correction de bugs ajoute un flux de travail évaluer → corriger → tester pour des corrections de bugs ciblées et fondées sur des preuves. Une extension d'évaluation d'idées fournit un flux de travail réception → recherche → définition → structuration → décision pour transformer des idées brutes en décisions documentées : go / clarification nécessaire / abandon. La personnalisation est prise en charge via trois mécanismes : les extensions ajoutent de nouvelles commandes et modèles, les presets remplacent le comportement des modèles et commandes existants, et les bundles regroupent des ensembles organisés d'extensions, de presets, d'étapes et de flux de travail en configurations basées sur les rôles (par exemple, chef de produit, analyste métier, chercheur en sécurité, développeur). Les remplacements locaux au projet permettent des ajustements ponctuels. Les modèles sont résolus à l'exécution, tandis que les commandes d'extension et de preset sont appliquées au moment de l'installation. Spec Kit inclut également des commandes d'auto-gestion telles que `specify self check`, `specify self upgrade --dry-run` et `specify self upgrade`, avec des options pour épingler des tags de version spécifiques. Les ressources communautaires incluent des extensions, des presets, des bundles, des tutoriels pas à pas et des projets associés sur le site de documentation. Le projet s'utilise lui-même : les mainteneurs utilisent Spec Kit lors du développement de Spec Kit, en particulier pour les fonctionnalités substantielles, via un flux de travail automatisé d'évaluation des fonctionnalités.