À propos des GitHub Copilot plug-ins

Les plug-ins offrent un moyen de distribuer des fonctionnalités personnalisées Copilot . Vous pouvez utiliser un plug-in pour ajouter un ensemble préconfiguré de fonctionnalités à Copilot, y compris Copilot CLI, Copilot cloud agentet le GitHub Copilot app.

Qu’est-ce qu’un plug-in ?

Package distribuable qui étend les Copilotfonctionnalités de l’application.
Ensemble de composants dans une unité installable unique.

Que contiennent les plug-ins?

Un plug-in peut contenir certains composants ou tous les composants suivants. Les emplacements de ces composants dépendent du format du plug-in :

Agents personnalisés — Assistants IA spécialisés (*.agent.md fichiers dans agents/)
Compétences : fonctionnalités pouvant être appelées discrètes (sous-répertoires de compétences dans skills/, contenant un SKILL.md fichier)
Hooks — gestionnaires d’événements qui interceptent le comportement de l’agent (un fichier hooks.json à la racine du plug-in ou dans hooks/)
Configurations du serveur MCP — Intégrations du protocole de contexte de modèle
Configurations du serveur LSP : intégrations du protocole Language Server (fichier lsp.json à la racine du plug-in ou dans .github/)

Formats de plug-in

Copilot prend en charge deux formats de plug-in :

Agent Plugins 1.0 est un format portable pour partager des compétences et des configurations de serveur MCP sur des clients compatibles. Pour utiliser ce format, définissez https://agent-plugins.org/schemas/1.0.0/plugin.schema.json dans plugin.json sur $schema. Les compétences sont découvertes à partir de skills/, et la configuration du serveur MCP est découverte à partir de mcp.json la racine du plug-in. Ces emplacements ne peuvent pas être configurés dans le manifeste. Choisissez Agent Plugins 1.0 lorsque vous souhaitez rendre les compétences et les serveurs MCP portables.
Les anciens Copilot plug-ins ne déclarent pas les Agent Plugins $schema. Ils utilisent les champs de manifeste existants et le comportement de découverte des composants, y compris les chemins de composant configurables et la configuration MCP dans .mcp.json, .github/mcp.jsonou le mcpServers champ manifeste. Choisissez le format hérité lorsque vous avez besoin de chemins de composant configurables ou conservez un plug-in spécifique existant Copilot.

Pour créer un nouveau plug-in, utilisez Agent Plugins 1.0, sauf si vous avez besoin de chemins d’accès des composants configurables. Utilisez le format hérité principalement pour les plug-ins hérités existants.

Les deux formats sont pris en charge. L’ajout de $schema modifie la façon dont Copilot interprète le manifeste et détecte les composants. Les plugins sans $schema continuent à être chargés comme des plugins hérités.

Comment les plug-ins sont structurés

Un plug-in est un répertoire avec une structure spécifique et un plugin.json fichier manifeste. Agent Plugins 1.0 exige le manifeste à la racine du plug-in. Les plugins hérités prennent en charge des emplacements supplémentaires pour les manifestes. Le manifeste donne au plug-in un nom et des métadonnées. Selon le format, il peut également pointer vers des composants. Outre le manifeste, le répertoire peut contenir des agents, des compétences, des hooks, des configurations de serveur MCP et des configurations de serveur LSP.

Structure des plug-ins d’agent 1.0

Agent Plugins 1.0 stocke les compétences et les serveurs MCP dans des emplacements standard afin que les clients compatibles puissent les découvrir. D’autres composants, notamment les agents, les hooks, les commandes et les serveurs LSP, sont spécifiques au client. Copilot lit ces composants à partir du com.github.copilot répertoire. D’autres clients ignorent ce répertoire, de sorte que le même module d’extension peut combiner des compétences partagées et des serveurs MCP avec des composants spécifiques à Copilot.

Un répertoire Agent Plugins 1.0 peut ressembler à ceci :

my-plugin/
├── plugin.json               # Required manifest
├── skills/                   # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── mcp.json                  # MCP server config (optional)
└── com.github.copilot/       # Copilot components (optional)
    ├── agents/
    │   └── helper.agent.md
    ├── commands/
    ├── rules/
    ├── hooks/
    │   └── hooks.json
    └── lsp.json

Le manifeste doit inclure les plug-ins de l’agent 1.0 $schema. Pour connaître les champs de manifeste de niveau supérieur pris en charge, les exigences de nom et les emplacements des composants, consultez les champs de manifeste Agent Plugins 1.0.

Ancienne structure de plugin

Un ancien répertoire de plugin Copilot peut ressembler à ceci :

my-plugin/
├── plugin.json           # Required manifest
├── agents/               # Custom agents (optional)
│   └── helper.agent.md
├── skills/               # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── hooks.json            # Hook configuration (optional)
├── .mcp.json             # MCP server config (optional)
└── lsp.json              # LSP server config (optional)

Pour obtenir l’ensemble complet de champs que vous pouvez inclure dans le manifeste, consultez Référence du plug-in CLI GitHub Copilot. Pour obtenir des instructions pas à pas sur la création d’un plug-in, consultez Création d’un plug-in pour GitHub Copilot CLI.

Pourquoi utiliser des plug-ins ?

Les plug-ins offrent les avantages suivants :

Réutilisation entre les projets
Standardisation de la configuration de l’équipe Copilot
Partagez une expertise de domaine (par exemple, en fournissant les compétences d’un expert Rails ou d’un expert Kubernetes)
Encapsuler des configurations de serveur MCP complexes

Où puis-je obtenir des plug-ins ?

Vous pouvez installer des plug-ins à partir de :

Une place de marché
Un référentiel
Chemin d’accès local

Une Place de marché est un emplacement où les développeurs peuvent publier, découvrir, installer et gérer des plug-ins. C’est un peu comme un app store, mais pour les plug-ins.

Voici quelques exemples de places de marché :

copilot-plugins (ajoutés par défaut)
awesome-copilot (ajouté par défaut)
claude-code-plugins
claudeforge-marketplace

La façon dont vous installez un plug-in dépend du client que vous utilisez :

Dans Copilot CLI, vous pouvez installer des extensions de manière impérative à l’aide de la commande copilot plugin install ou de la commande /plugin install, ou de manière déclarative en ajoutant l’extension au champ enabledPlugins d’un fichier ~/.copilot/settings.json au niveau utilisateur ou d’un fichier .github/copilot/settings.json au niveau du dépôt. Consultez « Recherche et installation de plug-ins pour GitHub Copilot CLI ».
Dans Copilot cloud agent, vous installez les plug-ins de manière déclarative en les ajoutant au enabledPlugins champ du fichier du .github/copilot/settings.json référentiel. Pour installer des plug-ins à partir d’une Place de marché qui n’est pas inscrite par défaut, vous pouvez également ajouter la Place de marché au extraKnownMarketplaces champ dans le même fichier.
Dans le GitHub Copilot appfichier , cliquez sur Personnaliser, puis sur Plug-ins pour parcourir les places de marché et installer les plug-ins.

Les administrateurs d’entreprise peuvent définir des normes de plug-in qui s’appliquent aux utilisateurs sur le plan de l’entreprise Copilot , notamment en spécifiant des places de marché et des plug-ins supplémentaires qui sont installés automatiquement. Consultez « À propos des normes de plug-in gérés par l’entreprise ».

Fonctionnement des places de marché des plug-ins

Une place de marché de plug-ins est un registre de plug-ins à partir duquel vous pouvez parcourir et installer. Une Place de marché peut être hébergée dans un référentiel sur GitHub.com, dans n’importe quel autre service d’hébergement Git en ligne ou sur votre système de fichiers local ou partagé.

Une place de marché est définie par un marketplace.json fichier, qui fournit des métadonnées sur la Place de marché et répertorie les plug-ins qu’il met à disposition. Chaque entrée dans le tableau de plugins la Place de marché décrit un plug-in, y compris son nom, sa description, sa version et le chemin d’accès au répertoire du plug-in.

Étant donné que les plug-ins d’une Place de marché sont versionnés, les places de marché facilitent la découverte, l’installation et la mise à jour des plug-ins et les partagent dans une équipe. Pour obtenir des instructions pas à pas sur la création d’une place de marché, consultez Création d’une place de marché de plug-ins pour GitHub Copilot CLI.

Plug-ins par rapport à la configuration manuelle

Toutes les fonctionnalités que vous pouvez ajouter avec un plug-in peuvent également être ajoutées en configurant Copilot manuellement, par exemple en ajoutant des profils d’agent personnalisés ou des serveurs MCP. Toutefois, les plug-ins offrent plusieurs avantages par rapport à la configuration manuelle :

Fonctionnalité	Configuration manuelle dans un référentiel	Plug-in
Scope	Référentiel unique	Tout projet
Partage	Copier/coller manuellement	Commande d’installation ou entrée `enabledPlugins`
Versioning	Historique Git	Versions du Marketplace
Discovery	Recherche de référentiels	Navigation sur la Place de marché

Qui peut utiliser cette fonctionnalité ?

Dans cet article