Información sobre GitHub Copilot complementos

Los complementos proporcionan una manera de distribuir la funcionalidad personalizada Copilot . Puede usar un complemento para agregar un conjunto preconfigurado de funcionalidades a Copilot, incluidos CLI de Copilot y agente en la nube de Copilot.

¿Qué es un complemento?

Un paquete distribuible que extiende la funcionalidad de Copilot.
Una agrupación de componentes en una sola unidad instalable.

Qué complementos contienen

Un complemento puede contener algunos o todos los componentes siguientes:

Agentes personalizados : asistentes especializados de IA (*.agent.md archivos en agents/)
Aptitudes : funcionalidades discretas que se pueden llamar (subdirectorios de aptitudes en skills/, que contienen un SKILL.md archivo)
Hooks — controladores de eventos que interceptan el comportamiento del agente (un archivo hooks.json en el directorio raíz del plugin o en hooks/)
Configuraciones del servidor MCP — integraciones del Protocolo de Contexto de Modelo (un archivo en la raíz del complemento, o un archivo en )
Configuraciones del servidor LSP — integraciones del Language Server Protocol (un lsp.json archivo en la raíz del complemento, o en .github/)

Cómo se estructuran los complementos

Un complemento es un directorio con una estructura específica. Como mínimo, contiene un plugin.json archivo de manifiesto en la raíz del directorio. El manifiesto proporciona al complemento un nombre y apunta a los componentes que proporciona el complemento. Junto con el manifiesto, el directorio puede contener cualquier combinación de agentes, aptitudes, enlaces, configuraciones de servidor MCP y configuraciones de servidor LSP.

Un directorio de complementos típico tiene este aspecto:

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)

Para obtener el conjunto completo de campos que puede incluir en el manifiesto, consulte Referencia del plugin CLI de GitHub Copilot. Para obtener instrucciones paso a paso sobre cómo crear un complemento, consulte Creación de un complemento para CLI de GitHub Copilot.

¿Por qué usar complementos?

Los complementos proporcionan las siguientes ventajas:

Reutilización entre proyectos
Estandarización de la configuración de Copilot del equipo
Comparta conocimientos sobre dominios (por ejemplo, proporcionando las aptitudes de un experto de Rails o un experto de Kubernetes)
Encapsular configuraciones complejas del servidor MCP

¿Dónde puedo obtener complementos?

Puede instalar complementos desde:

Un marketplace
Un repositorio
Ruta de acceso local

Un marketplace es una ubicación en la que los desarrolladores pueden publicar, detectar, instalar y administrar complementos. Es un poco como una tienda de aplicaciones, pero para complementos.

Entre los ejemplos de marketplace se incluyen:

copilot-plugins (agregado por defecto)
awesome-copilot (agregado de forma predeterminada)
claude-code-plugins
claudeforge-marketplace

La forma de instalar un complemento depende del cliente que use:

En CLI de Copilot, puedes instalar complementos de forma imperativa con el comando copilot plugin install o con el comando con barra /plugin install, o de forma declarativa, añadiendo el complemento al campo enabledPlugins de un archivo ~/.copilot/settings.json a nivel de usuario o de un archivo .github/copilot/settings.json a nivel de repositorio. Consulte Búsqueda e instalación de complementos para CLI de GitHub Copilot.
En agente en la nube de Copilot, los complementos se instalan mediante declaración agregándolos al enabledPlugins campo del archivo del .github/copilot/settings.json repositorio. Para instalar complementos desde un marketplace que no está registrado de manera predeterminada, también puede añadir el marketplace al campo extraKnownMarketplaces en el mismo archivo.

Los administradores de empresa pueden definir estándares de complementos que se aplican a los usuarios en el plan de Copilot la empresa, incluida la especificación de complementos y marketplaces adicionales que se instalan automáticamente. Consulte Acerca de los estándares de complementos administrados por la empresa.

Funcionamiento de los marketplaces de complementos

Una tienda de complementos es un catálogo de complementos donde puede explorar e instalar complementos. Un marketplace se puede hospedar en un repositorio en GitHub.com, en cualquier otro servicio de hospedaje de Git en línea o en el sistema de archivos local o compartido.

Un marketplace se define mediante un marketplace.json archivo, que proporciona metadatos sobre Marketplace y enumera los complementos que pone a disposición. Cada entrada de la matriz de plugins Marketplace describe un complemento, incluido su nombre, descripción, versión y la ruta de acceso al directorio del complemento.

Dado que los complementos de un marketplace tienen versiones, los marketplaces facilitan la detección, instalación y actualización de complementos y compartirlos en un equipo. Para obtener instrucciones paso a paso sobre cómo crear un marketplace, consulte Creación de un marketplace de complementos para CLI de GitHub Copilot.

Plugins en comparación con la configuración manual

Cualquier funcionalidad que pueda agregar con un complemento, también puede agregar mediante la Copilot configuración manual, por ejemplo, agregando perfiles de agente personalizados o servidores MCP. Sin embargo, los complementos proporcionan varias ventajas sobre la configuración manual:

Feature	Configuración manual en un repositorio	Plugin
Ámbito	Repositorio único	Cualquier proyecto
Sharing	Copiar y pegar manualmente	Comando de instalación o `enabledPlugins` entrada
Versioning	Historial de Git	Versiones de Marketplace
Discovery	Búsqueda de repositorios	Exploración de Marketplace