Плагины и Marketplace

Плагины — это пакеты расширений для Kodik. Они могут добавлять skills, слеш-команды, правила поведения агента, хуки жизненного цикла, профили субагентов и MCP-серверы. Устанавливать плагины и находить новые можно через встроенный Marketplace.

Открытие Marketplace

Откройте Marketplace командой Ctrl+Shift+X или из Командной палитры (Ctrl+Shift+P → «Kodik: Open Marketplace»). В Marketplace можно искать плагины, просматривать описания и устанавливать их в один клик.

Что могут предоставлять плагины

Плагин может включать любую комбинацию следующих компонентов:

Компонент	Описание	Подробнее
Skills	Специализированные рабочие процессы и компетенции для агента	Skills
Слеш-команды	Пользовательские команды, вызываемые через / в чате	Слеш-команды
Правила	Файлы правил, управляющие поведением агента в рамках проекта	Правила
Хуки	Shell-команды, привязанные к событиям жизненного цикла	Хуки
Профили субагентов	Определения специализированных субагентов	Субагенты
MCP-серверы	Дополнительные инструменты и ресурсы через протокол MCP	MCP

Пространство имён

Все компоненты, поставляемые плагинами, автоматически получают пространство имён по идентификатору плагина:

• Skill my-workflow из плагина acme виден как acme:my-workflow.
• Команда deploy из плагина acme вызывается как /acme:deploy.

Это позволяет нескольким плагинам предоставлять компоненты с одинаковыми именами без конфликтов.

Включение и отключение плагинов

После установки плагин включён по умолчанию. Вы можете отключить его через настройки плагина в Marketplace или в разделе настроек Kodik. Отключённый плагин не вносит никаких компонентов в сессию агента, пока снова не будет включён.

Для MCP-серверов это означает, что записи из .mcp.json плагина исчезают из настроек и из списка инструментов агента, пока плагин отключён. Отдельные пользовательские и проектные MCP-серверы при этом не затрагиваются.

MCP-серверы, поставляемые плагином, принадлежат пакету плагина. В настройках используйте Uninstall plugin, чтобы удалить их вместе с плагином; отдельные MCP-серверы плагина не удаляются через обычные элементы управления MCP-серверами.

Удаление плагина удаляет установленные файлы и очищает сохранённую в Kodik политику этого плагина. Секретные значения конфигурации плагина, например защищённые поля MCP user config, сохранённые в secure storage, также удаляются.

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

Структура плагина на диске

Установленные плагины располагаются в ~/.kodik/plugins. Каждый плагин занимает отдельную поддиректорию с манифестом .kodik-plugin/plugin.json. Компоненты плагина хранятся в стандартных поддиректориях:

<plugin-id>/
  .kodik-plugin/
    plugin.json          # манифест плагина
  .mcp.json              # конфигурации MCP-серверов
  skills/<skill-dir>/    # skills (каждый в своей директории)
  commands/<cmd>.md      # слеш-команды
  rules/<rule>.md        # правила
  agents/<agent>.md      # профили субагентов
  hooks/hooks.json       # хуки

До открытия первого рабочего окна Kodik переносит существующие установки из ~/.kodik/Plugins в строчную директорию ~/.kodik/plugins. Существующие lowercase-плагины остаются авторитетными; точные дубликаты объединяются, а конфликты и оригиналы после cross-home переноса сохраняются в ~/.kodik/.migration/global-assets-v1/. После зафиксированного перехода uppercase-плагины, MCP-серверы, хуки и assets неактивны; содержимое, созданное там позднее, нужно переустановить или перенести в lowercase-владельца. Kodik не переходит по символическим ссылкам внутри путей, принадлежащих плагину.

Связанные разделы

• Skills — создание и использование skills
• Хуки — хуки жизненного цикла
• MCP — протокол MCP и серверы
• Субагенты — специализированные субагенты