Ссылка на плагин GitHub Copilot CLI

Для обзора того, что такое плагины и как они работают между Copilot клиентами, см. О GitHub Copilot плагинах.

Команды CLI

Вы можете использовать следующие команды в терминале для управления плагинами для Второй пилот CLI. copilot plugin и copilot plugins являются взаимозаменяемыми — используйте все, что лучше считывается для подкоманда.

Неинтерактивно, copilot plugins enable NAME --plugin``copilot plugins disable NAME --pluginи copilot plugins remove NAME --plugin предоставляют те же операции включения, отключения и удаления. --plugin является типом по умолчанию и может быть опущен для этих трех команд. См. раздел AUTOTITLE для неинтерактивных --mcp и --skill типов, которые расширяют эти команды до серверов и навыков MCP.

Спецификация плагина для install команды

copilot plugins install варианты

Помимо установки подключаемого модуля из спецификации, copilot plugins install можно установить отдельный навык из файла, URL-адреса или каталога --skill. Установка навыка не является установкой подключаемого модуля и не проходит через Marketplace— дополнительные сведения о навыках см. в статье Справочник команды GitHub Copilot CLI .

Установка каталога регистрирует его как пользовательский источник навыка, а не копирует его; Установка файла или URL-адреса копирует содержимое навыка в личный или проектный каталог навыков.

Серверы MCP устанавливаются из настроенного политикой реестра, для которого требуется проверка подлинности и интерактивная запись секрета. Используйте панель мониторинга (режим онлайн) или /plugins команду косой /mcp черты, чтобы добавить серверы MCP вместо copilot plugins install.

copilot plugins update варианты

Сторонние подключаемые модули , установленные из встроенных copilot-plugins и awesome-copilot marketplace, автоматически обновляются в начале каждого сеанса в доверенном рабочем каталоге. Отключите это поведение с параметром autoUpdate (задано falseзначением) или переменной COPILOT_AUTO_UPDATE=false среды. Автоматическое обновление также пропускается по умолчанию в CI. См . раздел AUTOTITLE.

Вы добавили marketplace самостоятельно, чтобы выбрать одно и то же автоматическое обновление сеанса, задав autoUpdate: true запись в параметрах extraKnownMarketplaces пользователя. Это согласие учитывается только из собственных параметров пользователя— параметр репозитория или управляемого (MDM) не может включить или перенаправить автоматическое обновление для Marketplace. См. параметры репозитория.

copilot plugins marketplace вложенные комманды

Встроенные marketplace по умолчанию поставляются со средой выполнения и не могут быть удалены.

plugin.json

Все плагины состоят из каталога плагинов, содержащая, как минимум, файл манифеста, plugin.json расположенный в корне папки плагинов. См . раздел AUTOTITLE.

Обязательное поле

Опциональные поля метаданных

Поля пути компонентов

Они указывают CLI, где найти компоненты плагина. Все они необязательны. CLI использует стандартные конвенции, если они опущены.

Пример файла plugin.json

{
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "[email protected]"
  },
  "license": "MIT",
  "keywords": ["react", "frontend"],
  "agents": "agents/",
  "skills": ["skills/", "extra-skills/"],
  "hooks": "hooks.json",
  "mcpServers": ".mcp.json"
}

{
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "[email protected]"
  },
  "license": "MIT",
  "keywords": ["react", "frontend"],
  "agents": "agents/",
  "skills": ["skills/", "extra-skills/"],
  "hooks": "hooks.json",
  "mcpServers": ".mcp.json"
}

Поддержка спецификации подключаемого модуля

Объявление канонического $schema варианта при выборе подключаемого модуля в формате plugin.json версии 1.0.0, а также при загрузке стандартного подключаемого модуля:

Конфигурация сервера LSP

Чтобы включить серверы LSP (Language Server Protocol) в плагин, создайте lsp-config/servers.json файл в каталоге плагинов или укажите путь или встроенный объект с помощью lspServers поля в plugin.json.

Пример lsp-config/servers.json (или встроенный через lspServers ):plugin.json

{
    "lspServers": {
        "my-lsp": {
            "command": "my-language-server",
            "fileExtensions": { ".myext": "mylang" }
        }
    }
}

Для кроссплатформенной поддержки используйте bash и powershell вместо command:

{
    "lspServers": {
        "my-lsp": {
            "bash": "${PLUGIN_ROOT}/scripts/start-lsp.sh",
            "powershell": "${PLUGIN_ROOT}/scripts/start-lsp.ps1",
            "fileExtensions": { ".myext": "mylang" }
        }
    }
}

(*) По крайней мере один из command, bash, или powershell обязательно. Когда указаны оба bash и powershell, платформенно соответствующий выбор выбирается автоматически (PowerShell на Windows, Bash в других местах).

Используйте ${PLUGIN_ROOT} для ссылки на пути в каталоге плагинов.

marketplace.json

Вы можете создать маркетплейс плагинов — который пользователи смогут использовать для поиска и установки ваших плагинов — создав marketplace.json файл и сохранив его в .github/plugin/ каталоге репозитория. Вы также можете хранить файл marketplace.json в локальной файловой системе. Например, сохранение файла как /PATH/TO/my-marketplace/.github/plugin/marketplace.json позволяет добавить его в CLI с помощью следующей команды:

copilot plugin marketplace add /PATH/TO/my-marketplace

Дополнительные сведения см. в разделе Создание маркетплейса плагинов для интерфейс командной строки GitHub Copilot.

Пример файла marketplace.json

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "[email protected]"
  },
  "metadata": {
    "description": "Curated plugins for our team",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "frontend-design",
      "description": "Create a professional-looking GUI ...",
      "version": "2.1.0",
      "source": "./plugins/frontend-design"
    },
    {
      "name": "security-checks",
      "description": "Check for potential security vulnerabilities ...",
      "version": "1.3.0",
      "source": "./plugins/security-checks"
    }
  ]
}

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "[email protected]"
  },
  "metadata": {
    "description": "Curated plugins for our team",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "frontend-design",
      "description": "Create a professional-looking GUI ...",
      "version": "2.1.0",
      "source": "./plugins/frontend-design"
    },
    {
      "name": "security-checks",
      "description": "Check for potential security vulnerabilities ...",
      "version": "1.3.0",
      "source": "./plugins/security-checks"
    }
  ]
}

marketplace.json Поля

Поля верхнего уровня

Поля ввода плагинов (объекты внутри plugins массива)

Типы источников подключаемого модуля

source Поле в записи подключаемого GitHub модуля принимает относительную строку пути или объект, описывающий репозиторий или источник URL-адреса Git:

{
    "source": {
        "source": "github",
        "repo": "owner/repo",
        "ref": "v1.0.0",
        "path": "plugins/my-plugin"
    }
}

github url Оба типа источников принимают необязательное sha поле для закрепления установок в точной фиксации в дополнение к (или вместоref) :

{
    "source": {
        "source": "github",
        "repo": "owner/repo",
        "sha": "a94a8fe5ccb19ba61c4c0873d391e987982fbbd3",
        "path": "plugins/my-plugin"
    }
}

sha должно быть полной 40-символьной фиксацией SHA. Закрепление к sha воспроизводимым установкам, которые являются иммунными для принудительной отправки или перемещения тегов или ветвей.

Расположения файлов

Порядок загрузки и приоритет

Если вы устанавливаете несколько плагинов, возможно, что некоторые кастомные агенты, навыки, MCP-серверы или инструменты, предоставляемые через MCP-серверы, имеют дублирующиеся имена. В такой ситуации CLI определяет, какой компонент использовать, исходя из порядка приоритета.

• Агенты и навыки используют приоритет «первый-найденный-выигрышный».

  Если у вас есть кастомный агент или навык проектного уровня с тем же именем или идентификатором, что и в плагине, который вы устанавливаете, агент или навык в плагине молча игнорируются. Плагин не может отменять конфигурации на уровне проекта или личные настройки. Пользовательские агенты дедуплифицируются с помощью их идентификатора, который выводится из имени файла (например, если файл имеет имя reviewer.agent.md, идентификатор агента — reviewer). Навыки дедуплифицируются по полю имени внутри SKILL.md файла.

• Серверы MCP используют приоритет последних побед.

  Если вы установите плагин, который определяет MCP-сервер с тем же именем сервера, что и уже установленный вами MCP-сервер, определение плагина имеет приоритет. Вы можете использовать --additional-mcp-config опцию командной строки, чтобы переопределить конфигурацию MCP-сервера с таким же названием, установленную через плагин. Если два или более подключаемых модулей объявляют сервер MCP с одинаковым именем, интерфейс командной строки использует версию из подключаемого модуля, загруженного последней, и отображает предупреждение об именовании каждого предыдущего подключаемого модуля, определяемого им.

• Встроенные инструменты и агенты всегда присутствуют и не могут быть переопределены пользовательскими компонентами.

Следующая схема иллюстрирует правила порядка загрузки и приоритета.

┌──────────────────────────────────────────────────────────────────┐
│  BUILT-IN - HARDCODED, ALWAYS PRESENT                            │
│  • tools: bash, view, apply_patch, glob, rg, task, ...           │
│  • agents: explore, task, code-review, general-purpose, research │
└────────────────────────┬─────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  CUSTOM AGENTS - FIRST LOADED IS USED (dedup by ID)                 │
  │  1. ~/.copilot/agents/           (user, .github convention)         │
  │  2. <project>/.github/agents/    (project)                          │
  │  3. <parents>/.github/agents/    (inherited, monorepo)              │
  │  4. <project>/.claude/agents/    (project)                          │
  │  5. <parents>/.claude/agents/    (inherited, monorepo)              │
  │  6. PLUGIN: agents/ dirs         (plugin, by install order)         │
  │  7. Remote org/enterprise agents (remote, via API)                  │
  └──────────────────────┬──────────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  AGENT SKILLS - FIRST LOADED IS USED (dedup by name)                │
  │  1. <project>/.github/skills/        (project)                      │
  │  2. <project>/.agents/skills/        (project)                      │
  │  3. <project>/.claude/skills/        (project)                      │
  │  4. <parents>/.github/skills/ etc.   (inherited)                    │
  │  5. ~/.copilot/skills/               (personal-copilot)             │
  │  6. ~/.agents/skills/                (personal-agents)              │
  │  7. PLUGIN: skills/ dirs             (plugin)                       │
  │  8. COPILOT_SKILLS_DIRS env + config (custom)                       │
  │  --- then commands (.claude/commands/), skills override commands ---│
  └──────────────────────┬──────────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  MCP SERVERS - LAST LOADED IS USED (dedup by server name)           │
  │  1. ~/.copilot/mcp-config.json       (lowest priority)              │
  │  2. PLUGIN: MCP configs              (plugins)                      │
  │  3. --additional-mcp-config flag     (highest priority)             │
  └─────────────────────────────────────────────────────────────────────┘

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

• О стандартах плагинов, управляемых корпоративным предприятием
• интерфейс командной строки GitHub Copilot
• Справочник команды GitHub Copilot CLI
• GitHub Copilot CLI программный справочник