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 :
- Les fonctionnalités complexes nécessitant une planification structurée
- Les fonctionnalités comportant plusieurs tâches de mise en œuvre
- Les projets nécessitant de la documentation pour la collaboration en équipe
- Les fonctionnalités dont les exigences ou la conception doivent être itérées
Moins idéal pour :
- Les corrections de bogues (utilisez plutôt les Bugfix Specs)
- La programmation exploratoire sans objectifs clairs
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 :
- Vous connaissez le comportement du système que vous voulez créer
- L'architecture est flexible et peut être conçue pour répondre aux besoins
- Vous créez des fonctionnalités produit guidées par les commentaires des clients
- Vous démarrez un projet greenfield sans contraintes techniques
- Vous travaillez dans une organisation orientée produit
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 :
- Vous avez une architecture en tête (conception de haut niveau)
- Vous voulez commencer par le comportement de mise en œuvre à travers du pseudocode et des algorithmes (conception de bas niveau)
- Le système doit répondre à des exigences non fonctionnelles strictes (latence, débit, conformité)
- Vous portez des documents de conception d'autres outils vers Kiro
- Vous explorez la faisabilité technique avant de vous engager sur la portée
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 :
- Clarté : Les exigences sont sans ambiguïté et faciles à comprendre
- Testabilité : Chaque exigence peut être directement traduite en cas de test
- Traçabilité : Les exigences individuelles peuvent être suivies à travers la mise en œuvre
- Exhaustivité : Le format encourage à réfléchir à toutes les conditions et comportements
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