Création de compétences d’agent pour GitHub Copilot CLI

Modifiez le comportement et les capacités de Copilot lorsqu’il fonctionne sur des tâches particulières.

Dans cet article

Les compétences de l’agent sont des dossiers d’instructions, de scripts et de ressources que Copilot peut charger en cas de pertinence pour améliorer ses performances dans les tâches spécialisées. Pour plus d’informations, consultez « À propos des compétences de l’agent ».

Création et ajout d’une compétence

Pour créer une compétence d’agent, vous écrivez un SKILL.md fichier et, éventuellement, d’autres ressources, telles que des fichiers Markdown supplémentaires ou des scripts, que vous référencez dans les SKILL.md instructions.

Pour ajouter une compétence, vous enregistrez le fichier SKILL.md et toutes les ressources associées dans un emplacement où Copilot recherche les compétences. Cela peut se trouver dans un référentiel ou dans votre répertoire de base.

  1. Créez un skills répertoire pour stocker votre compétence et les autres que vous souhaiterez peut-être créer à l’avenir.

    Pour les compétences de projet, spécifiques à un référentiel unique, stockez votre compétence sous .github/skills ou .claude/skills.

    Pour les compétences personnelles, partagées entre les projets, stockez vos compétences sous ~/.copilot/skills ou ~/.claude/skills.

  2. Créez un sous-répertoire pour votre nouvelle compétence. Chaque compétence doit avoir son propre répertoire (par exemple). .github/skills/webapp-testing

    Les noms des sous-répertoires de compétence doivent être en minuscules et utiliser des traits d’union pour les espaces.

  3. Dans votre sous-répertoire de compétence, créez un SKILL.md fichier contenant les instructions de votre compétence.

    Important

    Les fichiers de compétence doivent être nommés SKILL.md.

           `SKILL.md` les fichiers sont des fichiers Markdown avec un frontmatter YAML. Dans leur forme la plus simple, ils incluent :
    • Informations préliminaires YAML * nom (obligatoire) : identificateur unique de la compétence. Cela doit être minuscule, en utilisant des traits d’union pour les espaces. En règle générale, cela correspond au nom du répertoire de la compétence. * description (obligatoire) : description de ce que fait la compétence, et quand Copilot doit l’utiliser. * licence (facultatif) : description de la licence qui s’applique à cette compétence.
    • Corps Markdown, avec les instructions, les exemples et les directives que Copilot doit suivre.

  4. Si vous le souhaitez, ajoutez des scripts, des exemples ou d’autres ressources au répertoire de votre compétence.

    Par exemple, si vous écriviez une compétence pour convertir des images entre différents formats, vous pouvez inclure un script pour convertir des images SVG en PNG. Les instructions sur les compétences doivent expliquer à Copilot quand et comment utiliser ces ressources.

Exemple de fichier SKILL.md

Pour une compétence de projet, ce fichier se trouve dans un .github/skills/github-actions-failure-debugging répertoire de votre référentiel.

Pour une compétence personnelle, ce fichier se trouve dans un ~/.copilot/skills/github-actions-failure-debugging répertoire.

Markdown
---
name: github-actions-failure-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
---

To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:

1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status
2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs
3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs
4. Try to reproduce the failure yourself in your own environment.
5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.

Utilisation des compétences de l’agent

Lors de la réalisation de tâches, Copilot décide quand utiliser vos compétences en fonction de votre invite et de la description de la compétence.

Lorsque Copilot choisit d’utiliser une compétence, le fichier SKILL.md sera injecté dans le contexte de l’agent, donnant à l’agent l’accès à vos instructions. Il peut ensuite suivre ces instructions et utiliser tous les scripts ou exemples que vous avez peut-être inclus dans le répertoire de la compétence.

Pour indiquer à Copilot d’utiliser une compétence spécifique, incluez le nom de la compétence dans votre prompt, précédé d’une barre oblique. Par exemple, si vous avez une compétence nommée « frontend-design », vous pouvez utiliser une invite telle que :

Use the /frontend-design skill to create a responsive navigation bar in React.

Commandes de compétences dans l’interface CLI

  • Répertoriez les aptitudes actuellement disponibles : utilisez la commande ou la :

    What skills do you have?

  •         **Activez ou désactivez des compétences spécifiques :** utilisez la commande `/skills` , puis utilisez les touches haut et bas de votre clavier, ainsi que la barre d’espace, pour activer ou désactiver les compétences.

  •         **En savoir plus sur une compétence** (y compris son emplacement) : utilisez la commande `/skills info`.

  •         **Ajouter un emplacement de compétences :** pour ajouter un autre emplacement dans lequel stocker des compétences, utilisez la commande `/skills add`.

  •         **Rechargez les compétences :** si vous avez ajouté une compétence pendant une session CLI, vous pouvez l’ajouter à l’aide de la commande `/skills reload` pour éviter d’avoir à redémarrer l’interface CLI pour l’utiliser.

  •         **Supprimer les compétences :** pour supprimer une compétence que vous avez ajoutée directement, et non via un plug-in, utilisez la commande `/skills remove SKILL-DIRECTORY`. Pour supprimer les compétences ajoutées dans le cadre d’un plug-in, vous devez gérer le plug-in lui-même. Utilisez la `info` sous-commande pour savoir à quel plug-in une compétence provient.

Compétences et instructions personnalisées

Vous pouvez utiliser des compétences et des instructions personnalisées pour enseigner Copilot comment travailler dans votre référentiel et comment effectuer des tâches spécifiques.

Nous vous recommandons d’utiliser des instructions personnalisées pour des instructions simples pertinentes pour presque chaque tâche (par exemple des informations sur les normes de codage de votre référentiel) et des compétences pour obtenir des instructions plus détaillées que Copilot ne doit accéder qu’en cas de pertinence.

Pour en savoir plus sur les instructions personnalisées du référentiel, consultez Ajout d’instructions personnalisées du dépôt pour GitHub Copilot.

Pour en savoir plus sur la façon dont les compétences diffèrent des autres fonctionnalités de personnalisation, consultez Comparaison des fonctionnalités de personnalisation de l’interface CLI GitHub Copilot.