{"meta":{"title":"Ссылка на плагин GitHub Copilot CLI","intro":"Найдите команды и детали конфигурации для плагинов CLI.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/reference","title":"Справочные материалы"},{"href":"/ru/copilot/reference/copilot-cli-reference","title":"Ссылка Второй пилот CLI"},{"href":"/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference","title":"Ссылка на плагин CLI"}],"documentType":"article"},"body":"# Ссылка на плагин GitHub Copilot CLI\n\nНайдите команды и детали конфигурации для плагинов CLI.\n\n> \\[!NOTE]\n> Помощь по использованию плагинов можно найти `copilot plugin [SUBCOMMAND] --help` в терминале.\n\n## Команды CLI\n\nВы можете использовать следующие команды в терминале для управления плагинами для Второй пилот CLI.\n\n| Command | Описание |\n| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |\n| `copilot plugin install SPECIFICATION` | Установите плагин. См. [спецификацию плагина для `install` команды](#plugin-specification-for-install-command) ниже. |\n| `copilot plugin uninstall NAME` | Удалить плагин |\n| `copilot plugin list` | Список установленных плагинов |\n| `copilot plugin update NAME` | Обновить плагин |\n| `copilot plugin marketplace add SPECIFICATION` | Зарегистрируйте маркетплейс |\n| `copilot plugin marketplace list` | Список зарегистрированных торговых площадок |\n| `copilot plugin marketplace browse NAME` | Просмотр плагинов маркетплейса |\n| `copilot plugin marketplace remove NAME` | Отменить регистрацию с маркетплейса |\n\n### Спецификация плагина для `install` команды\n\n| Формат | Пример | Описание |\n| --------------- | ---------------------------- | ----------------------------------------- |\n| Маркетплейс | `plugin@marketplace` | Плагин с зарегистрированного маркетплейса |\n| GitHub | `OWNER/REPO` | Корень GitHub репозитория |\n| GitHub subdir | `OWNER/REPO:PATH/TO/PLUGIN` | Подкаталог в репозитории |\n| Git URL | `https://github.com/o/r.git` | Любой URL в Git |\n| Местный маршрут | | |\n\n```\n `./my-plugin` или `/abs/path` | Местный справочник |\n```\n\n## `plugin.json`\n\nВсе плагины состоят из каталога плагинов, содержащая, как минимум, файл манифеста, `plugin.json` расположенный в корне папки плагинов. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating).\n\n### Обязательное поле\n\n| Поле | Тип | Описание |\n| ------ | ------ | -------------------------------------------------------------------------------- |\n| `name` | струна | Имя плагина для kebab-case (только буквы, цифры, дефисы). Максимум 64 персонажа. |\n\n### Опциональные поля метаданных\n\n| Поле | Тип | Описание |\n| ------------- | ------ | ------------------------------------------ |\n| `description` | струна | Краткое описание. Максимум 1024 персонажа. |\n| `version` | струна | Семантическая версия (например, `1.0.0`). |\n| `author` | объект | |\n\n```\n `name` (обязательно), `email` (по желанию), `url` (по необходимости). |\n```\n\n\\| `homepage` | струна | URL главной страницы плагина. |\n\\| `repository` | струна | URL репозитория исходного кода. |\n\\| `license` | струна | Идентификатор лицензии (например, `MIT`). |\n\\| `keywords` | строка\\[] | Ключевые слова поиска. |\n\\| `category` | струна | Категория плагинов. |\n\\| `tags` | строка\\[] | Дополнительные теги. |\n\n### Поля пути компонентов\n\nОни указывают CLI, где найти компоненты плагина. Все они необязательны. CLI использует стандартные конвенции, если они опущены.\n\n| Поле | Тип | По умолчанию | Описание |\n| ------------ | ------------------- | ------------ | ----------------------------------------------------------------------------------------------- |\n| `agents` | String \\| string\\[] | `agents/` | Пути к директориям агентов (`.agent.md` файлы). |\n| `skills` | String \\| string\\[] | `skills/` | Пути к каталогам навыков (`SKILL.md` файлам). |\n| `commands` | String \\| string\\[] | — | Пути к директориям команд. |\n| `hooks` | Строковый \\| объект | — | Путь к конфигурационному файлу hooks или объекту inline hooks. |\n| `mcpServers` | Строковый \\| объект | — | Путь к конфигурационному файлу MCP (например, `.mcp.json`), или встроенные определения сервера. |\n| `lspServers` | Строковый \\| объект | — | Путь к конфигурационному файлу LSP или встроенным определениям сервера. |\n\n### Пример файла `plugin.json`\n\n```json copy\n{\n \"name\": \"my-dev-tools\",\n \"description\": \"React development utilities\",\n \"version\": \"1.2.0\",\n \"author\": {\n \"name\": \"Jane Doe\",\n \"email\": \"jane@example.com\"\n },\n \"license\": \"MIT\",\n \"keywords\": [\"react\", \"frontend\"],\n \"agents\": \"agents/\",\n \"skills\": [\"skills/\", \"extra-skills/\"],\n \"hooks\": \"hooks.json\",\n \"mcpServers\": \".mcp.json\"\n}\n```\n\n## `marketplace.json`\n\nВы можете создать маркетплейс плагинов — который пользователи смогут использовать для поиска и установки ваших плагинов — создав `marketplace.json` файл и сохранив его в `.github/plugin/` каталоге репозитория. Вы также можете хранить файл `marketplace.json` в локальной файловой системе. Например, сохранение файла как `/PATH/TO/my-marketplace/.github/plugin/marketplace.json` позволяет добавить его в CLI с помощью следующей команды:\n\n```shell\ncopilot plugin marketplace add /PATH/TO/my-marketplace\n```\n\n> \\[!NOTE]\n> Второй пилот CLI также ищет `marketplace.json` файл в `.claude-plugin/` каталоге.\n\nДополнительные сведения см. в разделе [Создание маркетплейса плагинов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace).\n\n### Пример файла `marketplace.json`\n\n```json copy\n{\n \"name\": \"my-marketplace\",\n \"owner\": {\n \"name\": \"Your Organization\",\n \"email\": \"plugins@example.com\"\n },\n \"metadata\": {\n \"description\": \"Curated plugins for our team\",\n \"version\": \"1.0.0\"\n },\n \"plugins\": [\n {\n \"name\": \"frontend-design\",\n \"description\": \"Create a professional-looking GUI ...\",\n \"version\": \"2.1.0\",\n \"source\": \"./plugins/frontend-design\"\n },\n {\n \"name\": \"security-checks\",\n \"description\": \"Check for potential security vulnerabilities ...\",\n \"version\": \"1.3.0\",\n \"source\": \"./plugins/security-checks\"\n }\n ]\n}\n```\n\n> \\[!NOTE]\n> Значение `source` поля для каждого плагина — это путь к каталогу плагина относительно корня репозитория. Не обязательно использовать `./` его в начале пути. Например `\"./plugins/plugin-name\"` , и `\"plugins/plugin-name\"` разрешить в одну и ту же папку.\n\n###\n\n```\n `marketplace.json` Поля\n```\n\n#### Поля верхнего уровня\n\n| Поле | Тип | Обязательный | Описание |\n| ------- | ------ | ------------ | ------------------------------------------------- |\n| `name` | струна | Да | Название рынка кебаб-кейс. Максимум 64 персонажа. |\n| `owner` | объект | Да | |\n\n```\n `{ name, email? }` — информация о владельце маркетплейса. |\n```\n\n\\| `plugins` | массив | Да | Список записей плагинов (см. таблицу ниже). |\n\\| `metadata` | объект | Нет | `{ description?, version?, pluginRoot? }` |\n\n#### Поля ввода плагинов (объекты внутри `plugins` массива)\n\n| Поле | Тип | Обязательный | Описание |\n| ------------- | ------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `name` | струна | Да | Имя плагина для кебаб-кейса. Максимум 64 персонажа. |\n| `source` | Строковый \\| объект | Да | Где получить плагин (относительный путь GitHub, , или URL). |\n| `description` | струна | Нет | Описание плагина. Максимум 1024 персонажа. |\n| `version` | струна | Нет | Версия плагина. |\n| `author` | объект | Нет | `{ name, email?, url? }` |\n| `homepage` | струна | Нет | URL главной страницы плагина. |\n| `repository` | струна | Нет | URL репозитория исходного кода. |\n| `license` | струна | Нет | Идентификатор лицензии. |\n| `keywords` | строка\\[] | Нет | Ключевые слова поиска. |\n| `category` | струна | Нет | Категория плагинов. |\n| `tags` | строка\\[] | Нет | Дополнительные теги. |\n| `commands` | String \\| string\\[] | Нет | Пути к директориям команд. |\n| `agents` | String \\| string\\[] | Нет | Пути к каталогам агентов. |\n| `skills` | String \\| string\\[] | Нет | Пути к каталогам навыков. |\n| `hooks` | Строковый \\| объект | Нет | Путь к хукам, конфиг или объект встроенных хуков. |\n| `mcpServers` | Строковый \\| объект | Нет | Путь к конфигурации MCP или встроенным определениям сервера. |\n| `lspServers` | Строковый \\| объект | Нет | Путь к конфигурациям LSP или встроенным определениям сервера. |\n| `strict` | булевый | Нет | Когда `true` (по умолчанию) плагины должны соответствовать полным правилам схемы и валидации. Когда `false`используется расслабленная валидация, что даёт больше гибкости — особенно для прямых установок или устаревших плагинов. |\n\n## Расположения файлов\n\n| Элемент | Путь |\n| --------------------- | ---- |\n| Установленные плагины | |\n\n```\n `~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME` (установлен через маркетплейс) и `~/.copilot/installed-plugins/_direct/SOURCE-ID/` (установлен напрямую) |\n```\n\n\\| Кэш маркетплейса | Каталог кэша платформы: `~/.cache/copilot/marketplaces/` (Linux), `~/Library/Caches/copilot/marketplaces/` (macOS). Переобоймо с `COPILOT_CACHE_HOME`помощью . |\n\\| Манифест плагинов |\n`.plugin/plugin.json`, `plugin.json`, `.github/plugin/plugin.json`, или `.claude-plugin/plugin.json` (отмечено в таком порядке) |\n\\| Манифест рынка |\n`marketplace.json`, `.plugin/marketplace.json`, `.github/plugin/marketplace.json`, или `.claude-plugin/marketplace.json` (отмечено в таком порядке) |\n\\| Агенты |\n`agents/` (по умолчанию, можно отменить в манифесте) |\n\\| Навыки |\n`skills/` (по умолчанию, можно отменить в манифесте) |\n\\| Конфигурация крючков |\n`hooks.json` или `hooks/hooks.json` |\n\\| Конфигурация MCP |\n`.mcp.json`, `.github/mcp.json` |\n\\| Конфигурация LSP |\n`lsp.json` или `.github/lsp.json` |\n\n## Порядок загрузки и приоритет\n\nЕсли вы устанавливаете несколько плагинов, возможно, что некоторые кастомные агенты, навыки, MCP-серверы или инструменты, предоставляемые через MCP-серверы, имеют дублирующиеся имена. В такой ситуации CLI определяет, какой компонент использовать, исходя из порядка приоритета.\n\n* **Агенты и навыки** используют приоритет «первый-найденный-выигрышный».\n\n Если у вас есть кастомный агент или навык проектного уровня с тем же именем или идентификатором, что и в плагине, который вы устанавливаете, агент или навык в плагине молча игнорируются. Плагин не может отменять конфигурации на уровне проекта или личные настройки. Пользовательские агенты дедуплифицируются с помощью их идентификатора, который выводится из имени файла (например, если файл имеет имя `reviewer.agent.md`, идентификатор агента — `reviewer`). Навыки дедуплифицируются по полю имени внутри `SKILL.md` файла.\n\n* **Серверы MCP** используют приоритет последних побед.\n\n Если вы установите плагин, который определяет MCP-сервер с тем же именем сервера, что и уже установленный вами MCP-сервер, определение плагина имеет приоритет. Вы можете использовать `--additional-mcp-config` опцию командной строки, чтобы переопределить конфигурацию MCP-сервера с таким же названием, установленную через плагин.\n\n* **Встроенные инструменты и агенты** всегда присутствуют и не могут быть переопределены пользовательскими компонентами.\n\nСледующая схема иллюстрирует правила порядка загрузки и приоритета.\n\n```text\n┌──────────────────────────────────────────────────────────────────┐\n│ BUILT-IN - HARDCODED, ALWAYS PRESENT │\n│ • tools: bash, view, apply_patch, glob, rg, task, ... │\n│ • agents: explore, task, code-review, general-purpose, research │\n└────────────────────────┬─────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ CUSTOM AGENTS - FIRST LOADED IS USED (dedup by ID) │\n │ 1. ~/.copilot/agents/ (user, .github convention) │\n │ 2. /.github/agents/ (project) │\n │ 3. /.github/agents/ (inherited, monorepo) │\n │ 4. /.claude/agents/ (project) │\n │ 5. /.claude/agents/ (inherited, monorepo) │\n │ 6. PLUGIN: agents/ dirs (plugin, by install order) │\n │ 7. Remote org/enterprise agents (remote, via API) │\n └──────────────────────┬──────────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ AGENT SKILLS - FIRST LOADED IS USED (dedup by name) │\n │ 1. /.github/skills/ (project) │\n │ 2. /.agents/skills/ (project) │\n │ 3. /.claude/skills/ (project) │\n │ 4. /.github/skills/ etc. (inherited) │\n │ 5. ~/.copilot/skills/ (personal-copilot) │\n │ 6. ~/.agents/skills/ (personal-agents) │\n │ 7. PLUGIN: skills/ dirs (plugin) │\n │ 8. COPILOT_SKILLS_DIRS env + config (custom) │\n │ --- then commands (.claude/commands/), skills override commands ---│\n └──────────────────────┬──────────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ MCP SERVERS - LAST LOADED IS USED (dedup by server name) │\n │ 1. ~/.copilot/mcp-config.json (lowest priority) │\n │ 2. PLUGIN: MCP configs (plugins) │\n │ 3. --additional-mcp-config flag (highest priority) │\n └─────────────────────────────────────────────────────────────────────┘\n```\n\n## Дополнительные материалы\n\n* [GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli)\n* [Справочник команды GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [GitHub Copilot CLI программный справочник](/ru/copilot/reference/copilot-cli-reference/cli-programmatic-reference)"}