Подключаемые модули для GitHub Copilot

Подключаемые модули позволяют устанавливать и управлять ими вместе, а не настраивать каждую отдельно. Например, подключаемый модуль тестирования может объединить навык выполнения тестов, агент для проверки кода и сервер MCP для службы тестирования отчетов.

Где можно использовать подключаемые модули

Подключаемые модули доступны на этих Copilot поверхностях:

Visual Studio Code. Просмотрите и установите подключаемые модули из меню "Настройка " на боковой панели чата или в окне "Агенты". Сведения о формате подключаемого модуля VS Code см. в справочнике по разработке подключаемых модулей агента.
GitHub Copilot CLI. Просматривайте и устанавливайте подключаемые модули из зарегистрированной платформы.
GitHub Copilot app. Просматривайте и устанавливайте подключаемые модули из настройки.
Copilot in the cloud. Настройте подключаемые модули с помощью параметров репозитория.

Подключаемый модуль может содержать компоненты, которые работают только в определенной поверхности. Убедитесь, что подключаемый модуль поддерживает используемую поверхность. Например, для конфигурации сервера LSP, описанной в этой категории Copilot CLI. Дополнительные сведения см. в разделе Справочник по подключаемым модулям и Marketplace.

Что содержат плагины

Подключаемый модуль может упаковыть некоторые или все эти компоненты. Доступные компоненты и их расположения зависят от формата и поверхности подключаемого модуля:

Пользовательские агенты — специализированные AI-ассистенты (*.agent.md файлы в архиве agents/)
Навыки — инструкции, скрипты и ресурсы для конкретных задач (подкаталоги навыка в skills/, содержащий SKILL.md файл)
Перехватчики — обработчики событий, реагирующие на действия агента ( hooks.json файл в корневом каталоге подключаемого модуля или в hooks/)
Расширения — код, зависящий от Surface, который добавляет такие возможности, как инструменты и команды косой черты
Конфигурации сервера MCP — интеграция протокола контекста модели (корневой каталог mcp.json в подключаемых модулях агента 1.0)
Конфигурации сервера LSP — интеграция протокола языкового сервера на поддерживаемых поверхностях

Форматы подключаемых модулей

Подключаемые модули агента — это формат для совместного использования манифестов подключаемых модулей, навыков и конфигураций сервера MCP в совместимых поверхностях. Подключаемые модули агента 1.0 объявляют каноническую схему plugin.jsonв; ее расположения схемы и компонентов не поддерживаются каждой поверхностью таким же образом. Copilot CLI также поддерживает устаревший формат подключаемого Copilot модуля. В интерфейсе командной строки манифест без схемы подключаемых модулей агента использует этот устаревший формат.

Выберите подключаемые модули агента, если требуется предоставить общий доступ к навыкам и серверам MCP в совместимых поверхностях. Используйте устаревший формат ИНТЕРФЕЙСА командной строки, если вам нужны настраиваемые пути компонентов или поддерживает существующий подключаемый модуль Copilot.

Для нового подключаемого модуля используйте подключаемые модули агента 1.0, если вам не требуются настраиваемые пути к компонентам. Используйте устаревший формат в основном для существующих устаревших подключаемых модулей.

Как устроены плагины

Подключаемый модуль — это каталог с определенной структурой и файлом манифеста plugin.json . Для подключаемых модулей агента 1.0 требуется манифест в корневом каталоге подключаемого модуля. Устаревшие подключаемые модули поддерживают дополнительные расположения манифестов. Манифест предоставляет подключаемый модуль имя и метаданные. В зависимости от формата он также может указывать на компоненты. Наряду с манифестом каталог может содержать агенты, навыки, перехватчики, конфигурации сервера MCP и конфигурации сервера LSP.

Структура подключаемых модулей агента 1.0

Подключаемые модули агента 1.0 хранят навыки и серверы MCP в стандартных расположениях, чтобы совместимые клиенты могли их обнаружить. Другие компоненты, включая агенты, перехватчики, команды и серверы LSP, зависят от клиента. Copilot считывает эти компоненты из com.github.copilot каталога. Другие клиенты игнорируют этот каталог, поэтому один и тот же подключаемый модуль может объединять общие навыки и серверы MCP с Copilotкомпонентами с определенными компонентами.

Каталог подключаемых модулей агента 1.0 может выглядеть следующим образом:

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

Манифест должен включать подключаемые модули агента 1.0 $schema. Поддерживаемые поля манифеста верхнего уровня, требования к имени и расположения компонентов см. в полях манифеста подключаемого модуля агента 1.0.

Устаревшая структура подключаемого модуля

Устаревший каталог подключаемого Copilot модуля может выглядеть следующим образом:

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)

Полный набор полей, которые вы можете включить в манифест, см. Ссылка на плагин GitHub Copilot CLI. Пошаговые рекомендации по созданию плагина смотрите Создание плагина для GitHub Copilot CLI.

Зачем использовать плагины?

Плагины предоставляют следующие преимущества:

Повторное использование между проектами
Общая Copilot конфигурация в репозиториях
Делитесь экспертизой в области (например, предоставляя навыки эксперта по Rails или Kubernetes)
Инкапсулировать сложные настройки сервера MCP

Откуда приходят подключаемые модули

Встроенный marketplace в Visual Studio Code, Copilot CLIи GitHub Copilot app это удивительный copilot. Другие платформы необходимо добавить до того, как их подключаемые модули будут доступны.

Добавление Marketplace делает его подключаемые модули доступными для просмотра. Он не устанавливает или не включает их. Идентификатор подключаемого модуля объединяет имя подключаемого модуля с именем Marketplace как PLUGIN-NAME@MARKETPLACE-NAME. Имя Marketplace поступает из поля в файлеmarketplace.json, а не из name имени репозитория.

Что определяет, включен ли подключаемый модуль

Подключаемые модули могут быть доступны, установлены или включены. Добавление Marketplace делает его подключаемые модули доступными для просмотра. Установка подключаемого модуля добавляет его в поверхность и позволяет сделать его компоненты доступными в сеансах на этой поверхности. Общая конфигурация может задать значение по умолчанию или применить, включен ли подключаемый модуль:

Источник конфигурации	Effect	Может ли член отключить подключаемый модуль?
Управляемые корпоративными настройками	Требовать или блокировать подключаемый модуль в поддерживаемых поверхностях.	No. Управляемая политика всегда выигрывает.
Управляемые параметры команды предприятия	Добавьте необходимые подключаемые модули в корпоративные `enabledPlugins` файлы группы, наложенные на базовые показатели предприятия.	No. Эти записи являются управляемыми политиками.
Стандарты репозитория	Включите подключаемый модуль для всех, кто работает в репозитории.	Да, где поверхность поддерживает локальную переопределение.

По умолчанию репозиторий не делает подключаемый модуль обязательным. Они не могут включить подключаемый модуль, который блокирует управляемые политики или использовать Marketplace, который запрещает политику. Управляемые параметры по умолчанию не могут включить необязательный подключаемый модуль. Им требуются только подключаемые модули или блокируются.

Корпоративные файлы группы добавляют управляемые enabledPlugins записи в базовые показатели предприятия. Участники не могут отключить необходимые подключаемые модули. См . раздел AUTOTITLE.

Используется .github/copilot/settings.jsonрепозиторий по умолчанию. Сведения о конфигурации и локальных переопределениях для конкретных поверхностей см. в разделе Каталог конфигурации CLI GitHub Copilot.

Администраторы предприятия могут указывать дополнительные платформы и подключаемые модули, необходимые или заблокированные. См . раздел AUTOTITLE.

Как работают маркетплейсы плагинов

Маркетплейс плагинов — это реестр плагинов, с которых можно просматривать и устанавливать. Marketplace можно разместить в репозитории gh.asamalin.top, другом узле Git или локальном каталоге. Так как подключаемые модули в Marketplace версии, marketplace упрощает обнаружение, установку и обновление подключаемых модулей.

Marketplace определяется файлом marketplace.json , который предоставляет метаданные о Marketplace и перечисляет его подключаемые модули.

Инструкции по использованию подключаемых модулей или публикации Marketplace в репозитории см. в GitHub статье "Дополнительные сведения".

Плагины по сравнению с ручной конфигурацией

Любые функции, которые можно добавить с помощью плагина, можно также настраивать Copilot вручную — например, добавляя пользовательские профили агентов или MCP-серверы. Однако плагины дают несколько преимуществ по сравнению с ручной конфигурацией:

Feature	Ручная настройка в репозитории	Плагин
Scope	Одиночный репозиторий	Любой проект
Sharing	Копирование вручную	Команда установки или `enabledPlugins` запись
Versioning	История гита	Версии на рынке
Открытие	Поиск репозиториев	Просмотр на рынке