Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les compétences de l'agent sont des ensembles réutilisables d'instructions qui enseignent aux agents Copilot comment effectuer des tâches spécifiques, telles que l'exécution d'un pipeline de build, la génération de code standard ou le suivi des normes de codage de votre équipe. En définissant des compétences une seule fois, vous gagnez du temps et assurez un comportement cohérent dans votre flux de travail.
Les compétences complètent les agents personnalisés et les instructions personnalisées. Alors que les agents personnalisés définissent un persona et un ensemble d’outils et des instructions personnalisées définissent des préférences de codage générales, les compétences fournissent des conseils spécifiques aux tâches que n’importe quel agent peut découvrir et utiliser automatiquement.
Prerequisites
- Visual Studio 2026 version 18.5 ou ultérieure
- Un abonnement GitHub Copilot
Fonctionnement des compétences de l’agent
Lorsque vous utilisez modeagent, Copilot découvre automatiquement les compétences de votre référentiel et de votre profil utilisateur. L’agent décide quand une compétence est pertinente pour votre demande et l’active. Lorsqu’une compétence est activée, elle apparaît dans la conversation pour vous informer qu’elle est appliquée.
Emplacements des compétences
Les compétences sont acquises dans les emplacements suivants :
| Type de compétence | Lieu |
|---|---|
| Compétences d’espace de travail ou de projet (stockées dans votre référentiel) |
.github/skills/, .claude/skills/, .agents/skills/ |
| Compétences personnelles (stockées dans votre profil utilisateur) |
~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/ |
Les compétences de l’espace de travail sont partagées avec votre équipe via le contrôle de source. Les compétences personnelles s’appliquent à tous vos projets et ne sont pas enregistrées dans un dépôt.
Créer une compétence
Vous pouvez créer une compétence à partir du volet compétences dans Visual Studio, ou manuellement dans votre système de fichiers. Pour créer une compétence à partir du volet de compétences, vous devez avoir Visual Studio 2026 Insiders version 18.6 ou ultérieure.
Créer une compétence à partir du volet compétences
Sélectionnez l’icône Tools dans le coin inférieur droit de Copilot Chat pour ouvrir le volet des compétences.
Sélectionnez le + bouton en haut à droite du panneau.
Choisissez une destination (compétence globale ou au niveau de la solution) et choisissez un nom.
Visual Studio génère un modèle de compétence à remplir. Vous pouvez utiliser assistant Copilot mode pour vous aider à terminer le modèle.
Créer une compétence manuellement
Chaque compétence est un répertoire contenant un SKILL.md fichier qui suit la spécification agentskills.io.
Créez un répertoire de compétences. Pour une compétence d’espace de travail, utilisez
.github/skills/à la racine de votre référentiel. Pour une compétence personnelle, utilisez~/.copilot/skills/.Créez un sous-répertoire pour votre compétence. Chaque compétence doit avoir son propre répertoire (par exemple).
.github/skills/github-issues/Créez un
SKILL.mdfichier dans le répertoire des compétences. Le fichier contient un frontmatter YAML avec des métadonnées suivies d’instructions Markdown.Si vous le souhaitez, ajoutez des scripts, des exemples ou d’autres ressources au répertoire de votre compétence.
Structure du répertoire de compétences
your-repo/
└── .github/
└── skills/
└── github-issues/
├── SKILL.md # Required: metadata + instructions
├── scripts/ # Optional: executable code
├── references/ # Optional: documentation
└── assets/ # Optional: templates, resources
format SKILL.md
Le SKILL.md fichier doit contenir un frontmatter YAML suivi du contenu Markdown :
---
name: github-issues
description: Creates and manages GitHub issues following team conventions. Use when working with issue tracking, bug reports, or feature requests.
---
When creating GitHub issues:
- Use the standard title format: [Component] Brief description
- Add appropriate labels based on issue type
- Include reproduction steps for bug reports
- Link related issues and PRs
Propriétés du frontmatter
| Propriété | Obligatoire | Description |
|---|---|---|
name |
Oui | Lettres minuscules, chiffres et traits d’union uniquement. Doit correspondre au nom du répertoire parent. Maximum 64 caractères. |
description |
Oui | Décrit ce que fait la compétence et quand l’utiliser. 1 024 caractères maximum. |
license |
Non | Nom de la licence ou référence à un fichier de licence groupé. |
compatibility |
Non | Configuration requise pour l’environnement, telle que le produit prévu ou les packages système requis. |
metadata |
Non | Mappage arbitraire clé-valeur destiné à des métadonnées supplémentaires. |
allowed-tools |
Non | Chaîne de caractères délimitée par des espaces contenant les outils préapprouvés que la compétence peut exploiter. |
Conseils pour l’écriture de compétences efficaces
- Assurez-vous que le fichier
SKILL.mdprincipal ne dépasse pas 500 lignes. Déplacez le matériel de référence détaillé vers des fichiers séparés dans le répertoirereferences/. - Écrivez un clair
descriptionqui inclut des mots clés spécifiques pour aider les agents à identifier quand la compétence est pertinente. - Incluez des instructions pas à pas, des exemples et des cas de périphérie courants.
Gérer les compétences à partir du panneau compétences
Sélectionnez l’icône Tools dans le coin inférieur droit de Copilot Chat pour ouvrir le volet des compétences, une vue dédiée de chaque compétence découverte. Le panneau Compétences est disponible uniquement dans les Visual Studio 2026 Insiders.
Dans le panneau, vous pouvez :
-
Modifier : ouvrez les compétences directement dans l’éditeur
SKILL.mdà partir du menu ... - Ouvrez l’emplacement du fichier : accédez au répertoire des compétences sur le disque.
- Recherche : filtrer les compétences par nom ou mot clé.
Le panneau présente également les diagnostics pour toutes les erreurs de configuration des compétences, ce qui vous permet de détecter et de résoudre rapidement les problèmes.
Compétences de la communauté
Consultez le dépôt awesome-copilot pour des exemples d'aptitudes partagées par la communauté.