7.8 KiB
| title | description | sidebar | ||
|---|---|---|---|---|
| Skills | Référence des skills BMad — ce qu'ils sont, comment ils fonctionnent et où les trouver. |
|
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).
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 | .cursor/skills/ |
| Windsurf | .windsurf/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 à :
.claude/skills/
├── bmad-help/
│ └── SKILL.md
├── bmad-create-prd/
│ └── SKILL.md
├── bmad-analyst/
│ └── SKILL.md
└── ...
Le nom du répertoire détermine le nom du skill dans votre IDE. Par exemple, le répertoire bmad-analyst/ enregistre le skill bmad-analyst.
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 une persona1 IA spécialisée 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-analyst |
Mary (Analyste) | Brainstorming de projets, recherche, création de briefs |
bmad-architect |
Winston (Architecte) | Conçoit l'architecture système |
bmad-ux-designer |
Sally (Designer UX) | Crée les designs UX |
bmad-tech-writer |
Paige (Rédacteur Technique) | Documente les projets, rédige des guides, génère des diagrammes |
Consultez Agents 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 une persona d'agent. Ils chargent une configuration de workflow et suivent ses étapes.
| Exemple de skill | Objectif |
|---|---|
bmad-create-prd |
Créer un PRD2 |
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 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 11 outils intégrés — revues, compression, brainstorming, gestion de documents, et plus. Consultez Outils principaux 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-analyst, bmad-create-prd, bmad-help). Consultez Modules 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
-
Persona : dans le contexte de BMad, une 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. ↩︎
-
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. ↩︎