Как добавить marketplace в Copilot CLI

Проверено 13 сентября 2026 года. Команда copilot plugin marketplace add SOURCE принимает owner/repo, owner/repo#ref, URL или local path. Registration key берётся из собственного поля name в marketplace.json; задать произвольное локальное имя нельзя.

Основной первоисточник — GitHub Copilot CLI plugin reference. Для структуры и trust review полезны также официальное создание plugins и официальное создание marketplace. Цены, тарифы и список моделей не используются: они не нужны для процедуры и меняются независимо.

Зафиксируйте copilot version, пользователя и current working directory. Управляемые настройки организации или repository overlay могут иметь приоритет над локальным значением. Если CLI сообщает Managed или указывает controlling settings file, не обходите ограничение: оформите изменение у владельца соответствующего уровня.

Подготовка и модель доверия

Сделайте два baseline: copilot plugin list --json и copilot plugin marketplace list --json. Храните временные копии вне tracked files. Для каждого plugin запишите name, version, source, installedFrom, enabled и marketplace. Для каталога — manifest name, owner и source.

Затем изучите компоненты plugin. Agent или skill может направлять модель, hook — выполнять код на событии, MCP server — обращаться к локальной или внешней системе. Отдельно отметьте write-capable действия и credentials. Для первого теста оставьте только read-only сценарий на тестовых данных.

Определите критерий остановки: неизвестный source, неожиданная смена ref, запрос лишнего scope, появление секрета в выводе, новый hook или write tool. При любом таком сигнале завершите session, отключите plugin и проведите отдельный аудит. Не расширяйте разрешения вслепую.

Для командной эксплуатации назначьте владельца каждого дополнительного marketplace и plugin. Владелец отвечает за периодический просмотр upstream, срок поддержки, проверку обновлений и удаление устаревших компонентов. Без владельца даже безопасный сегодня read-only plugin постепенно превращается в неизвестную зависимость: меняются source, transitive packages, endpoint и организационные требования.

Составьте минимальную тестовую матрицу. Она должна включать запуск CLI без plugin, с plugin, после disable и после rollback. Для marketplace отдельно сравнивайте catalog и installed state: появление новой версии в browse не означает, что локальный plugin уже обновился. Это различие предотвращает ложные отчёты об успешном обновлении и помогает воспроизводить проблему.

Все наблюдения записывайте с датой, точной командой и exit status, чтобы другой инженер мог повторить проверку без устных пояснений.

Пошаговые действия

1. Получите source marketplace и проверьте владельца.
2. Откройте marketplace.json и проверьте name, owner и plugin sources.
3. Для GitHub source предпочтите проверенный ref; для воспроизводимости изучите возможность полного commit SHA в manifest.
4. Добавьте marketplace командой copilot plugin marketplace add SOURCE.
5. Выполните marketplace list --json и найдите manifest name, а не придуманное alias.
6. Откройте browse и сравните каталог с manifest.
7. Не устанавливайте plugins автоматически: каждый оценивайте отдельно.
8. Для отката выполните marketplace remove NAME, если из него ещё ничего не установлено.

После операции всегда открывайте новую Copilot CLI session. Уже работающий процесс мог загрузить старую конфигурацию. Повторите оба списка и сравните по name, а не по порядку строк. Если изменилось больше одного элемента, не выдавайте результат за успешный до разбора diff.

Готовый шаблон для копирования

Заполните карточку изменения:

Source: <owner/repo#ref | URL | local path>
Manifest name: <marketplace.json name>
Owner checked: <name>
Plugin sources reviewed: <список>
Команда: copilot plugin marketplace add <source>
List/browse result: <описание>
Installed plugins: none during registration
Rollback: marketplace remove <manifest-name>
Дата проверки документации: 13.09.2026
Официальный источник: https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-plugin-reference

Готовый prompt для подготовки change request:

Подготовь безопасный план изменения GitHub Copilot CLI plugin по карточке.
Не устанавливай, не удаляй и не меняй конфигурацию сам.
Не придумывай version, source, enabled, permissions или успешный результат.
Верни: baseline, точную команду, проверку manifest, read-only позитивный тест,
негативный тест, признаки успеха, риски, очистку и откат.
Отсутствующий факт пометь «нужно проверить вручную».

<вставьте заполненную карточку>

Реалистичный пример входа и ожидаемого результата

Вход. Команда регистрирует acme/copilot-marketplace#v1, чей manifest name равен acme-tools.