Перейти к содержимому

Используйте плагины / Создавайте плагины ​

Установите пакет для своих агентов или подготовьте переносимый пакет Agent Plugins 1.0 с инструкциями и подключением инструментов.

Используйте плагины ​

При наличии Node.js 22 или новее:

bash
npx universal-agent-plugins add context7

CLI предложит совместимые агенты и покажет оставшиеся действия активации. Для предварительного изучения и просмотра плана:

bash
npx universal-agent-plugins info context7
npx universal-agent-plugins add context7 --target codex,cursor --dry-run

Инструкция по нативной установке предлагает исполняемые файлы для macOS, Linux и Windows. Самому нативному менеджеру Node.js не нужен; отдельным плагинам могут требоваться свои среды. Для npm проверьте npx universal-agent-plugins version: пакетный канал может ещё поставлять предыдущий CLI. Автоматический выбор ниже требует 0.1.94; для проверенного выпуска используйте нативный установщик. Пример Project с Git-источником, закреплённым полным SHA, работает и в 0.1.93; короткие имена подписанного Directory в Project требуют актуальную стабильную CLI.

CLI сохраняет явную область проекта и автоматический выбор для install, добавленный в 0.1.94. Также доступны локальный API управления и расширения Pi, Skills и MCP. План добавления пакета в проект:

Для совместимого проверенного пакета используйте короткое имя из подписанного Directory с явной областью Project, если выбранный агент поддерживает все обязательные компоненты (например, agentplugins add context7 --target codex --scope project --dry-run). Для воспроизводимой установки можно вместо этого указать Git-источник с полным SHA коммита. Замените OWNER/REPOSITORY, FULL_COMMIT_SHA и PACKAGE_PATH; для пакета в корне репозитория уберите //PACKAGE_PATH.

Шаблон: github:OWNER/REPOSITORY@FULL_COMMIT_SHA//PACKAGE_PATH. Команда ниже использует реальный исторический коммит GitLab, а не подтверждение текущей проверки в каталоге. Для новой установки скопируйте актуальный проверенный источник из каталога.

bash
npx universal-agent-plugins add github:777genius/universal-agent-plugins@2ddbb99dd190c1792b79904f9875e6322bccd243//plugins/gitlab --target codex --scope project \
  --project-root /path/to/project --dry-run

Выберите существующую папку. Добавление и обслуживание по умолчанию используют пользовательскую область: выбирайте проект явно. В 0.1.94 install без аргумента источника выбирает проект только при обычном файле uap.toml непосредственно в текущей папке. Явная область имеет приоритет, родители не просматриваются. Прочитайте план перед удалением --dry-run. Обнаружение клиентом, доверие, аутентификация и вызовы MCP остаются отдельными проверками после записи файлов.

Полный путь установки · Совместимость и границы проверок

Восстановите сохранённые зависимости ​

Проверьте записи выбранного пользовательского окружения:

bash
npx universal-agent-plugins deps status

Для сохранённой пары uap.toml/uap.lock выполните экспорт из папки обмена:

bash
npx universal-agent-plugins deps export

Скопируйте папку на другой компьютер, установите нужные клиенты и выполните там:

bash
npx universal-agent-plugins deps import
npx universal-agent-plugins install --locked --scope user

Переносятся только проверенные файлы соглашения и lock. Профили, настройки, учётные данные, квитанции и данные плагинов остаются отдельными. Установке нужны точные источники или проверенный кэш. Для проекта добавьте пару в контроль версий и восстанавливайте через явный install --locked --scope project. Подробности переноса и восстановления — в обслуживании.

Создавайте плагины ​

Стандартный пакет начинается с корневого plugin.json; можно добавить skills/<name>/SKILL.md, mcp.json или оба компонента. Файлы можно написать вручную и проверить опубликованным установщиком:

bash
npx universal-agent-plugins validate ./my-plugin
npx universal-agent-plugins add ./my-plugin --target codex --dry-run

Предполагается, что ./my-plugin уже содержит полный пакет. Руководство по созданию показывает минимальный пакет Skill вручную и средства создания шаблонов из исходного кода.

Доступность средств разработки: в текущем npm- и нативном выпуске установщика нет agentplugins author. В исходном коде реализованы шаблоны, статические проверки, явные запуски MCP, циклы разработки, установка зависимостей и обслуживание JSON. Для этих команд нужна сборка из исходного кода. Доказательства для старых выпусков относятся к их версиям и не обещают те же команды в нынешнем установщике.

Статическая проверка не доказывает исполнение, OAuth или активацию. Поддержка транспортов MCP зависит от клиента: например, Codex не поддерживает объявленный MCP SSE. Укажите требования и непроведённые проверки в README пакета.

Спецификация Agent Plugins 1.0

Публичная документация для авторов плагинов и интеграторов.