Используйте плагины / Создавайте плагины
Установите пакет для своих агентов или подготовьте переносимый пакет Agent Plugins 1.0 с инструкциями и подключением инструментов.
Используйте плагины
При наличии Node.js 22 или новее:
npx universal-agent-plugins add context7CLI предложит совместимые агенты и покажет оставшиеся действия активации. Для предварительного изучения и просмотра плана:
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, а не подтверждение текущей проверки в каталоге. Для новой установки скопируйте актуальный проверенный источник из каталога.
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 остаются отдельными проверками после записи файлов.
Полный путь установки · Совместимость и границы проверок
Восстановите сохранённые зависимости
Проверьте записи выбранного пользовательского окружения:
npx universal-agent-plugins deps statusДля сохранённой пары uap.toml/uap.lock выполните экспорт из папки обмена:
npx universal-agent-plugins deps exportСкопируйте папку на другой компьютер, установите нужные клиенты и выполните там:
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 или оба компонента. Файлы можно написать вручную и проверить опубликованным установщиком:
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 пакета.