{"meta":{"title":"Создание плагина для GitHub Copilot CLI","intro":"Создайте плагин для обмена настройками в удобном для установки пакете.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/how-tos","title":"Инструкции"},{"href":"/ru/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/ru/copilot/how-tos/copilot-cli/customize-copilot","title":"Настройка Copilot CLI"},{"href":"/ru/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating","title":"Плагины: создайте плагин"}],"documentType":"article"},"body":"# Создание плагина для GitHub Copilot CLI\n\nСоздайте плагин для обмена настройками в удобном для установки пакете.\n\n## Введение\n\nПлагины — это пакеты, расширяющие функциональность Copilot CLI. См [. раздел AUTOTITLE](/ru/copilot/concepts/agents/about-plugins).\n\n> \\[!NOTE]\n> Помощь по использованию плагинов можно найти `copilot plugin [SUBCOMMAND] --help` в терминале.\n\n## Структура плагинов\n\nПлагин состоит из каталога с определённой структурой. Минимум он должен содержать `plugin.json` манифест-файл в корне каталога. Он также может содержать любую комбинацию агентов, навыков, хуков и конфигураций серверов MCP.\n\n### Пример структуры плагина\n\n```text\nmy-plugin/\n├── plugin.json           # Required manifest\n├── agents/               # Custom agents (optional)\n│   └── helper.agent.md\n├── skills/               # Skills (optional)\n│   └── deploy/\n│       └── SKILL.md\n├── hooks.json            # Hook configuration (optional)\n└── .mcp.json             # MCP server config (optional)\n```\n\n## Создание плагина\n\n1. Создайте папку для вашего плагина.\n\n2. Добавьте `plugin.json` файл манифеста в корень каталога.\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Для подробностей полного набора полей, которые вы можете включить в этот файл, смотрите [Ссылка на плагин GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference#pluginjson).\n\n1. Добавьте некоторые компоненты в плагин, создавая соответствующие файлы и каталоги для агентов, навыков, хуков и конфигураций MCP-серверов.\n\n   Рассмотрим пример.\n\n   1. Добавьте агента, создав `NAME.agent.md` файл в подкаталоге `agents` .\n\n      ```markdown copy\n      ---\n      name: my-agent\n      description: Helps with specific tasks\n      tools: [\"bash\", \"edit\", \"view\"]\n      ---\n\n      You are a specialized assistant that...\n      ```\n\n   2. Добавьте навык, создав `skills/NAME` подкаталог вашей папки плагинов, где `NAME` находится название вашего навыка. Затем в этой подкаталоге создайте `SKILL.md` файл, который определяет навык.\n\n      Например, чтобы создать навык «развернуть», создайте `skills/deploy/SKILL.md`:\n\n      ```markdown copy\n      ---\n      name: deploy\n      description: Deploy the current project to...\n      ---\n\n      Instructions for the skill...\n      ```\n\n2. Установите плагин локально, чтобы тестировать его по ходу разработки.\n\n   Например, где `./my-plugin` находится путь к вашему каталогу плагинов, введите:\n\n   ```shell copy\n   copilot plugin install ./my-plugin\n   ```\n\n3. Проверьте, что плагин успешно загрузился, просмотрев список установленных плагинов:\n\n   ```shell copy\n   copilot plugin list\n   ```\n\n   Или вы можете начать новую интерактивную сессию и войти:\n\n   ```copilot copy\n   /plugin list\n   ```\n\n4. Убедитесь, что агенты, навыки, крючки и конфигурации MCP-серверов, которые вы определили, загружены правильно.\n\n   Например, в интерактивной сессии, чтобы проверить, загружены ли пользовательские агенты, определённые в плагине, введите:\n\n   ```copilot copy\n   /agent\n   ```\n\n   Чтобы проверить, что навыки, определённые в плагине, загружены, введите:\n\n   ```copilot copy\n   /skills list\n   ```\n\n5. Используйте функционал, предоставленный компонентами вашего плагина, чтобы убедиться, что каждый компонент работает как следует.\n\n6. По мере необходимости развивайте плагины.\n\n   > \\[!IMPORTANT]\n   > Когда вы устанавливаете плагин, его компоненты кэшуются, и CLI читает данные из кэша для следующих сессий. Чтобы восстановить изменения, внесённые в локальный плагин, установите его снова:\n   >\n   > ```shell copy\n   > copilot plugin install ./my-plugin\n   > ```\n\n7. После завершения тестирования вы можете удалить локальную версию плагина, введя в:\n\n   ```shell copy\n   copilot plugin uninstall NAME\n   ```\n\n   > \\[!NOTE]\n   > Чтобы удалить плагин, используйте имя плагина, указанное в `name` поле файла манифеста `plugin.json` плагина, а не путь к папке плагина.\n\n## Распространение вашего плагина\n\nЧтобы распространять плагин, вы можете добавить его на маркетплейс. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace).\n\n## Дополнительные материалы\n\n* [Поиск и установка плагинов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)\n* [Ссылка на плагин GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference)"}