Skip to main content

О GitHub Copilot плагинах

Плагины — это устанавливаемые пакеты, которые расширяются Copilot многоразовыми агентами, навыками, крючками и интеграциями.

Кто может использовать эту функцию?

GitHub Copilot CLI Доступна со всеми Copilot тарифными планами. Если вы получаете Copilot от организации, Copilot CLI политика должна быть включена в настройках организации.

Copilot cloud agent доступна для всех платных Copilot планов.

Агент доступен во всех репозиториях, хранящихся на GitHub, за исключением тех, которые принадлежат управляемые учетные записи пользователей и где он явно отключен.

GitHub Copilot app доступна для всех Copilot планов.
Sign up for Copilot

Плагины предоставляют возможность распространять пользовательскую Copilot функциональность. Подключаемый модуль можно использовать для добавления предварительно настроенного набора возможностейCopilot, включая Copilot CLICopilot cloud agent, и GitHub Copilot app.

Что такое подключаемый модуль?

  • Распространяемый пакет, расширяющий Copilotфункциональность .
  • Набор компонентов в одном устанавливаемом устройстве.

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

Плагин может содержать некоторые или все из следующих компонентов:

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

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

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

Типичная папка плагинов выглядит так:

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

Где можно найти плагины?

Вы можете установить плагины из:

  • Рынок
  • Хранилище
  • Местная тропа

Маркетплейс — это место, где разработчики могут публиковать, обнаружать, устанавливать и управлять плагинами. Это немного похоже на магазин приложений — только для плагинов.

Примеры маркетплейсов включают:

То, как вы устанавливаете плагин, зависит от того, каким клиентом вы используете:

  • В Copilot CLI, вы можете устанавливать плагины обязательно с помощью copilot plugin install команды или /plugin install команды slash, либо декларативно, добавляя плагин в enabledPlugins поле либо пользовательского ~/.copilot/settings.json или .github/copilot/settings.json репозитория. См . раздел AUTOTITLE.
  • В Copilot cloud agent, вы устанавливаете плагины декларативно, добавляя их в enabledPlugins поле файла .github/copilot/settings.json репозитория. Чтобы установить плагины с маркетплейса, который по умолчанию не зарегистрирован, можно добавить маркетплейс в extraKnownMarketplaces поле в том же файле.
  • GitHub Copilot appВ разделе "Настройка" щелкните "Настроить", а затем щелкните "Подключаемые модули", чтобы просмотреть marketplaces и установить подключаемые модули.

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

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

Маркетплейс плагинов — это реестр плагинов, с которых можно просматривать и устанавливать. Маркетплейс может быть размещён в репозитории на GitHub.comлюбом другом онлайн-сервисе хостинга Git или в вашей локальной или общей файловой системе.

Маркетплейс определяется файлом marketplace.json , который предоставляет метаданные о маркетплейсе и перечисляет доступные плагины. Каждая запись в массиве plugins маркетплейса описывает плагин — включая его название, описание, версию и путь к каталогу плагина.

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

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

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

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

Дополнительные материалы