Les Specs, ou spécifications, sont des artefacts structurés qui formalisent le processus de développement pour les fonctionnalités et les corrections de bogues dans votre application. Elles offrent une approche systématique pour transformer des idées de haut niveau en plans de mise en œuvre détaillés avec un suivi et une responsabilisation clairs.
| Fonctionnalité | IDE | CLI | Web | Mobile |
|---|---|---|---|---|
| Feature Specs | ✓ | ✓ | ✓ | ✓ |
| Bugfix Specs | ✓ | ✓ | ✓ | ✓ |
| Quick Spec | ✓ | ✓ | ✓ | ✓ |
| Exécution parallèle des tâches | ✓ | ✓ | ✓ | ✓ |
| Analyze Requirements | ✓ | ✓ | — | — |
| Correctness (tests basés sur les propriétés) | ✓ | — | — | — |
Sur Mobile, la vue du spec affiche requirements.md, design.md et tasks.md. Pour lire le fichier bugfix.md d'un Bugfix Spec, utilisez Kiro Web ou demandez-le à l'agent dans la session.
Avec les Specs de Kiro, vous pouvez :
- Décomposer les exigences en récits utilisateurs avec critères d'acceptation
- Créer des documents de conception avec des diagrammes de séquence et des plans d'architecture
- Suivre l'avancement de la mise en œuvre à travers des tâches distinctes
- Collaborer efficacement entre les équipes de produit et d'ingénierie
Chaque Spec génère trois fichiers clés qui forment le fondement de votre spécification :
- requirements.md (ou bugfix.md) - Capture les récits utilisateurs, les critères d'acceptation ou l'analyse de bogue dans une notation structurée
- design.md - Documente l'architecture technique, les diagrammes de séquence et les considérations de mise en œuvre
- tasks.md - Fournit un plan de mise en œuvre détaillé avec des tâches distinctes et traçables
Toutes les Specs suivent un flux de travail en trois phases qui transforme votre idée en une mise en œuvre exécutable :
Exigences ou analyse de bogue - Définir ce qui doit être construit ou corrigé
- Feature Specs : récits utilisateurs et critères d'acceptation dans
requirements.md - Bugfix Specs : analyse de bogue avec comportement actuel/attendu/inchangé dans
bugfix.md
Conception - Créer l'architecture technique et l'approche de mise en œuvre dans design.md
- Architecture système et conception des composants
- Diagrammes de séquence et flux de données
- Gestion des erreurs et stratégie de test
Tâches - Générer des tâches de mise en œuvre distinctes et exécutables dans tasks.md
- Tâches traçables avec des résultats clairs
- Mises à jour du statut en temps réel au fil de la mise en œuvre
- Exécutez les tâches individuellement ou toutes à la fois
Kiro fournit une interface d'exécution des tâches pour les fichiers tasks.md qui affiche les mises à jour de statut en temps réel. Les tâches sont mises à jour comme étant en cours ou terminées, ce qui vous permet de suivre efficacement l'avancement de la mise en œuvre.
Lorsque vous exécutez toutes les tâches d'une Spec, Kiro analyse votre liste de tâches, détermine lesquelles dépendent les unes des autres et exécute les tâches indépendantes simultanément. Pour la plupart des Feature Specs, cela réduit considérablement le temps d'exécution sans aucune configuration.
Kiro construit un graphe de dépendances des tâches dans votre tasks.md et regroupe les tâches indépendantes en vagues :
- Vague 1 - toutes les tâches sans dépendances. Elles s'exécutent simultanément.
- Vague 2 - toutes les tâches dont les dépendances ont été satisfaites par la vague 1. Elles s'exécutent simultanément.
- Vague N - se poursuit jusqu'à ce que toutes les tâches soient terminées.
Les vagues s'exécutent séquentiellement; les tâches d'une même vague s'exécutent simultanément.
Kiro prend en charge deux types de Specs pour répondre à vos besoins de développement :
Pour créer de nouvelles fonctionnalités et capacités dans votre application. Les Feature Specs vous guident à travers la collecte des exigences, la conception technique et la planification de la mise en œuvre avec deux variantes de flux de travail : Requirements-First et Design-First. Pour les fonctionnalités bien comprises, vous pouvez aussi utiliser Quick Spec pour générer automatiquement les trois artefacts sans points de validation.
En savoir plus sur les Feature Specs →
Pour diagnostiquer et corriger systématiquement les bogues avec une précision chirurgicale tout en prévenant les régressions. Les Bugfix Specs vous aident à identifier les causes profondes, à concevoir des correctifs et à valider que rien d'autre n'est brisé.
En savoir plus sur les Bugfix Specs →
- Dans le panneau Kiro, cliquez sur le bouton
+sous Specs. Vous pouvez aussi choisir Spec dans le panneau de clavardage. - Kiro vous demandera si vous développez une fonctionnalité ou corrigez un bogue
- Si vous choisissez Fonctionnalité, décrivez votre fonctionnalité et choisissez votre flux de travail : Requirements-First ou Design-First
- Si vous choisissez Bogue, décrivez votre bogue
- À mesure que vous avancez dans chaque phase, sélectionnez le bouton flottant Review sur les documents d'exigences, de conception, de correction de bogue ou de comportement. Il ouvre Markdown Review, où vous pouvez commenter des passages précis et envoyer tous vos commentaires à Kiro en une seule fois.
- Suivez le flux de travail à travers chaque phase jusqu'à la mise en œuvre
Approfondissez le système de Specs de Kiro avec ces guides :
Specs