142 lines
10 KiB
Markdown
142 lines
10 KiB
Markdown
---
|
||
title: Skills
|
||
description: Référence des skills BMad — ce qu’ils sont, comment ils fonctionnent et où les trouver.
|
||
sidebar:
|
||
order: 4
|
||
---
|
||
|
||
Les skills sont des prompts pré-construits qui chargent des agents, exécutent des workflows ou lancent des tâches dans votre IDE. L’installateur BMad les génère à partir de vos modules installés au moment de l’installation. Si vous ajoutez, supprimez ou modifiez des modules ultérieurement, relancez l’installateur pour garder les skills synchronisés (voir [Dépannage](#dépannage)).
|
||
|
||
## Skills vs. Déclencheurs du menu Agent
|
||
|
||
BMad offre deux façons de démarrer un travail, chacune ayant un usage différent.
|
||
|
||
| Mécanisme | Comment l’invoquer | Ce qui se passe |
|
||
|-------------------------------|---------------------------------------------------------------|------------------------------------------------------------------------------------------------|
|
||
| **Skill** | Tapez le nom du skill (ex. `bmad-help`) dans votre IDE | Charge directement un agent, exécute un workflow ou lance une tâche |
|
||
| **Déclencheur du menu agent** | Chargez d’abord un agent, puis tapez un code court (ex. `DS`) | L’agent interprète le code et démarre le workflow correspondant tout en préservant son persona |
|
||
|
||
Les déclencheurs du menu agent nécessitent une session agent active. Utilisez les skills lorsque vous savez quel workflow vous voulez. Utilisez les déclencheurs lorsque vous travaillez déjà avec un agent et souhaitez changer de tâche sans quitter la conversation.
|
||
|
||
## Comment les skills sont générés
|
||
|
||
Lorsque vous exécutez `npx bmad-method install`, l’installateur lit les manifests de chaque module sélectionné et écrit un skill par agent, workflow, tâche et outil. Chaque skill est un répertoire contenant un fichier `SKILL.md` qui indique à l’IA de charger le fichier source correspondant et de suivre ses instructions.
|
||
|
||
L’installateur utilise des modèles pour chaque type de skill :
|
||
|
||
| Type de skill | Ce que fait le fichier généré |
|
||
|-----------------------|--------------------------------------------------------------------------------|
|
||
| **Lanceur d’agent** | Charge le fichier de persona de l’agent, active son menu et reste en caractère |
|
||
| **Skill de workflow** | Charge la configuration du workflow et suit ses étapes |
|
||
| **Skill de tâche** | Charge un fichier de tâche autonome et suit ses instructions |
|
||
| **Skill d’outil** | Charge un fichier d’outil autonome et suit ses instructions |
|
||
|
||
:::note[Relancer l’installateur]
|
||
Si vous ajoutez ou supprimez des modules, relancez l’installateur. Il régénère tous les fichiers de skill pour correspondre à votre sélection actuelle de modules.
|
||
:::
|
||
|
||
## Emplacement des fichiers de skill
|
||
|
||
L’installateur écrit les fichiers de skill dans un répertoire spécifique à l’IDE à l’intérieur de votre projet. Le chemin exact dépend de l’IDE que vous avez sélectionné lors de l’installation.
|
||
|
||
| IDE / CLI | Répertoire des skills |
|
||
|-------------|------------------------------------------------------------|
|
||
| Claude Code | `.claude/skills/` |
|
||
| Cursor | `.agents/skills/` |
|
||
| Windsurf | `.agents/skills/` |
|
||
| Autres IDE | Consultez la sortie de l’installateur pour le chemin cible |
|
||
|
||
Chaque skill est un répertoire contenant un fichier `SKILL.md`. Par exemple, une installation Claude Code ressemble à :
|
||
|
||
```text
|
||
.claude/skills/
|
||
├── bmad-help/
|
||
│ └── SKILL.md
|
||
├── bmad-prd/
|
||
│ └── SKILL.md
|
||
├── bmad-agent-dev/
|
||
│ └── SKILL.md
|
||
└── ...
|
||
```
|
||
|
||
Le nom du répertoire détermine le nom du skill dans votre IDE. Par exemple, le répertoire `bmad-agent-dev/` enregistre le skill `bmad-agent-dev`.
|
||
|
||
## Comment découvrir vos skills
|
||
|
||
Tapez le nom du skill dans votre IDE pour l’invoquer. Certaines plateformes nécessitent d’activer les skills dans les paramètres avant qu’ils n’apparaissent.
|
||
|
||
Exécutez `bmad-help` pour obtenir des conseils contextuels sur votre prochaine étape.
|
||
|
||
:::tip[Découverte rapide]
|
||
Les répertoires de skills générés dans votre projet sont la liste de référence. Ouvrez-les dans votre explorateur de fichiers pour voir chaque skill avec sa description.
|
||
:::
|
||
|
||
## Catégories de skills
|
||
|
||
### Skills d’agent
|
||
|
||
Les skills d’agent chargent un persona[^2] IA spécialisé avec un rôle défini, un style de communication et un menu de workflows. Une fois chargé, l’agent reste en caractère et répond aux déclencheurs du menu.
|
||
|
||
| Exemple de skill | Agent | Rôle |
|
||
|------------------------|------------------------|-------------------------------------------------------------|
|
||
| `bmad-agent-dev` | Amelia (Développeur) | Implémente les stories avec une adhérence stricte aux specs |
|
||
| `bmad-agent-pm` | John (Product Manager) | Crée, met à jour et valide les PRDs[^1] |
|
||
| `bmad-agent-architect` | Winston (Architecte) | Conçoit l’architecture système |
|
||
|
||
Consultez [Agents](./agents.md) pour la liste complète des agents par défaut et leurs déclencheurs.
|
||
|
||
### Skills de workflow
|
||
|
||
Les skills de workflow exécutent un processus structuré en plusieurs étapes sans charger d’abord un persona d’agent. Ils chargent une configuration de workflow et suivent ses étapes.
|
||
|
||
| Exemple de skill | Objectif |
|
||
|---------------------------------|------------------------------------------------------------------------------------------------------------------------------|
|
||
| `bmad-product-brief` | Créer ou mettre à jour un product brief[^3] — découverte guidée lorsque votre concept est clair |
|
||
| `bmad-prfaq` | Défi [PRFAQ Working Backwards](../explanation/analysis-phase.md#prfaq-working-backwards) pour éprouver votre concept produit |
|
||
| `bmad-prd` | Créer, mettre à jour ou valider un PRD[^1] |
|
||
| `bmad-create-architecture` | Concevoir l’architecture système |
|
||
| `bmad-create-epics-and-stories` | Créer des epics et des stories |
|
||
| `bmad-dev-story` | Implémenter une story |
|
||
| `bmad-code-review` | Effectuer une revue de code |
|
||
| `bmad-quick-dev` | Flux rapide unifié — clarifier l’intention, planifier, implémenter, réviser, présenter |
|
||
|
||
Consultez la [Carte des workflows](./workflow-map.md) pour la référence complète des workflows organisés par phase.
|
||
|
||
### Skills de tâche et d’outil
|
||
|
||
Les tâches et outils sont des opérations autonomes qui ne nécessitent pas de contexte d’agent ou de workflow.
|
||
|
||
**BMad-Help : Votre guide intelligent**
|
||
|
||
`bmad-help` est votre interface principale pour découvrir quoi faire ensuite. Il inspecte votre projet, comprend les requêtes en langage naturel et recommande la prochaine étape requise ou optionnelle en fonction de vos modules installés.
|
||
|
||
:::note[Exemple]
|
||
```
|
||
bmad-help
|
||
bmad-help J'ai une idée de SaaS et je connais toutes les fonctionnalités. Par où commencer ?
|
||
bmad-help Quelles sont mes options pour le design UX ?
|
||
```
|
||
:::
|
||
|
||
**Autres tâches et outils principaux**
|
||
|
||
Le module principal inclut 12 outils intégrés — specs, revues, brainstorming, personnalisation, gestion de documents, et plus. Consultez [Outils principaux](./core-tools.md) pour la référence complète.
|
||
|
||
## Convention de nommage
|
||
|
||
Tous les skills utilisent le préfixe `bmad-` suivi d’un nom descriptif (ex. `bmad-agent-dev`, `bmad-prd`, `bmad-help`). Consultez [Modules](./modules.md) pour les modules disponibles.
|
||
|
||
## Dépannage
|
||
|
||
**Les skills n’apparaissent pas après l’installation.** Certaines plateformes nécessitent d’activer explicitement les skills dans les paramètres. Consultez la documentation de votre IDE ou demandez à votre assistant IA comment activer les skills. Vous devrez peut-être aussi redémarrer votre IDE ou recharger la fenêtre.
|
||
|
||
**Des skills attendus sont manquants.** L’installateur génère uniquement les skills pour les modules que vous avez sélectionnés. Exécutez à nouveau `npx bmad-method install` et vérifiez votre sélection de modules. Vérifiez que les fichiers de skill existent dans le répertoire attendu.
|
||
|
||
**Des skills d’un module supprimé apparaissent encore.** L’installateur ne supprime pas automatiquement les anciens fichiers de skill. Supprimez les répertoires obsolètes du répertoire de skills de votre IDE, ou supprimez tout le répertoire de skills et relancez l’installateur pour obtenir un ensemble propre.
|
||
|
||
## Glossaire
|
||
|
||
[^1]: PRD (Product Requirements Document) : document de référence qui décrit les objectifs du produit, les besoins utilisateurs, les fonctionnalités attendues, les contraintes et les critères de succès, afin d’aligner les équipes sur ce qui doit être construit et pourquoi.
|
||
[^2]: Persona : dans le contexte de BMad, un persona désigne un agent IA avec un rôle défini, un style de communication et une expertise spécifiques (ex. Mary l’analyste, Winston l’architecte). Chaque persona garde son « caractère » pendant les interactions.
|
||
[^3]: Brief : document synthétique qui formalise le contexte, les objectifs, le périmètre et les contraintes d’un projet ou d’une demande, afin d’aligner rapidement les parties prenantes avant le travail détaillé.
|