Les Feature Specs offrent une approche structurée pour créer de nouvelles fonctionnalités, en vous guidant à travers la collecte des exigences, la conception technique et la planification de mise en œuvre. Selon votre point de départ, que vous ayez des exigences utilisateur claires ou une conception technique en tête, vous pouvez choisir entre deux variantes de flux de travail qui s'adaptent à votre processus de développement.
Approche structurée - Des phases claires vous guident de l'idée à la mise en œuvre
Flexibilité - Choisissez le flux de travail qui correspond à votre point de départ
Documentation - Génération automatique des documents d'exigences et de conception
Suivi - Surveillez la progression à travers des tâches de mise en œuvre distinctes
Collaboration - Artefacts partagés pour l'alignement entre le produit et l'ingénierie
Idéal pour :
Moins idéal pour :
Les Feature Specs prennent en charge deux variantes de flux de travail pour s'adapter à différents scénarios de développement. Choisissez le flux de travail qui correspond le mieux à votre point de départ et aux contraintes de votre projet.
Commencez par le comportement du système que vous voulez créer, saisi sous forme d'exigences, puis générez la conception technique et les tâches de mise en œuvre.
Quand l'utiliser :
Flux : Exigences → Conception → Tâches
Commencez par la conception technique (architecture ou conception de bas niveau), puis déduisez les exigences réalisables et les tâches de mise en œuvre.
Quand l'utiliser :
Flux : Conception → Exigences → Tâches
| Exigences d'abord | Conception d'abord | |
|---|---|---|
| Commence par | Le comportement du système, saisi sous forme d'exigences | La conception technique, l'architecture ou le pseudocode |
| Génère | La conception à partir des exigences | Les exigences à partir de la conception |
| Idéal pour | Le développement axé sur le produit | Les projets contraints techniquement ou axés sur la conception |
| Assure | Le comportement souhaité est spécifié | La faisabilité technique |
| Flexibilité | La mise en œuvre peut s'adapter | Les exigences peuvent s'adapter |
Le fichier requirements.md utilise la notation EARS (Easy Approach to Requirements Syntax) pour fournir des exigences structurées et testables. Chaque exigence suit ce modèle :
WHEN [condition/event] THE SYSTEM SHALL [expected behavior]
Par exemple :
WHEN a user submits a form with invalid data THE SYSTEM SHALL display validation errors next to the relevant fields
Cette approche structurée offre plusieurs avantages :
Avant de passer des exigences à la conception, vous pouvez demander à Kiro d'analyser vos exigences pour détecter des incohérences logiques, des ambiguïtés, des contraintes contradictoires et des lacunes. Sélectionnez Analyze Requirements dans les options de clavardage ou dans le menu déroulant Continue de l'éditeur après la génération des exigences.
En savoir plus sur Analyze Requirements →
Le fichier design.md documente l'architecture technique, les diagrammes de séquence et les considérations de mise en œuvre. Il saisit la vue d'ensemble du fonctionnement du système, y compris les composants et leurs interactions.
Les Feature Specs commencent comme n'importe quel autre spec - consultez Pour commencer pour les étapes propres à chaque surface. Lorsque Kiro vous demande votre intention, choisissez Feature, puis sélectionnez votre flux de travail : Requirements-First ou Design-First. Pour les fonctionnalités bien comprises où vous n'avez pas besoin de portes d'approbation entre les phases, sélectionnez plutôt Quick Spec.
Vous pouvez également définir un flux de travail par défaut dans vos paramètres Kiro pour éviter l'étape de sélection.
Feature Specs