Passer au contenu principal
Afficher en Markdown

Feature Specs

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.

Avantages clés

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

Quand utiliser les Feature Specs

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

Variantes de flux de travail

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.

Exigences d'abord

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.

Loading diagram...

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

Conception d'abord

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.

Loading diagram...

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

Comparaison rapide

Exigences d'abordConception d'abord
Commence parLe comportement du système, saisi sous forme d'exigencesLa conception technique, l'architecture ou le pseudocode
GénèreLa conception à partir des exigencesLes exigences à partir de la conception
Idéal pourLe développement axé sur le produitLes projets contraints techniquement ou axés sur la conception
AssureLe comportement souhaité est spécifiéLa faisabilité technique
FlexibilitéLa mise en œuvre peut s'adapterLes exigences peuvent s'adapter

Exigences avec la notation EARS

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

Analyser les exigences avant la conception

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 →

Documentation de conception

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.

Loading diagram...

Pour commencer

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.

En savoir plus

Page mise à jour : 27 août 2026