Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Навык Aggrega

Навык Aggrega учит AI-ассистента устанавливать и использовать Aggrega. Это папка с именем aggrega, содержащая файл SKILL.md в открытом формате Agent Skills, который многие ассистенты читают из собственной папки навыков и загружают, когда ваш запрос касается Aggrega.

Передать навык ассистенту можно двумя способами. Ассистент, который устанавливает плагины, получает его как часть плагина Aggrega, который также подключает ассистента к MCP-серверу Aggrega, за один шаг: см. Установка плагина. Для любого ассистента, который читает навыки из папки, навык туда может записать двоичный файл aggrega: см. Установка только навыка.

Установка плагина

Репозиторий aggrega-ai/aggrega-skills содержит навык и одновременно является плагином для перечисленных ниже ассистентов. Установка плагина добавляет навык Aggrega и подключает ассистента к MCP-серверу Aggrega, который ассистент затем сам запускает как aggrega mcp, поэтому для этого ассистента не нужны ни aggrega skills install, ни шаги из раздела Подключение MCP-сервера.

Плагин не устанавливает двоичный файл aggrega. Сначала установите его, как описано в разделе Установка двоичного файла, чтобы ассистент нашёл aggrega в PATH, когда будет запускать сервер.

Claude Code

Terminal window
claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills

Внутри Claude Code то же самое делает команда /plugin install aggrega --marketplace aggrega-ai/aggrega-skills.

Codex

Terminal window
codex plugin marketplace add aggrega-ai/aggrega-skills
codex plugin add aggrega@aggrega

Первая команда добавляет репозиторий как маркетплейс плагинов с именем aggrega; вторая устанавливает из него плагин aggrega.

GitHub Copilot

В GitHub Copilot CLI:

Terminal window
copilot plugin marketplace add aggrega-ai/aggrega-skills
copilot plugin install aggrega@aggrega

Visual Studio Code с GitHub Copilot находит плагины, установленные GitHub Copilot CLI, и тоже их использует. Чтобы установить плагин непосредственно из Visual Studio Code, выполните Chat: Install Plugin from Source из палитры команд и укажите адрес репозитория, https://github.com/aggrega-ai/aggrega-skills.

Gemini CLI

Terminal window
gemini extensions install https://github.com/aggrega-ai/aggrega-skills

Gemini CLI устанавливает плагин как одно из своих расширений.

Antigravity

Terminal window
agy plugin install https://github.com/aggrega-ai/aggrega-skills

Cursor

Cursor загружает плагин из папки внутри ~/.cursor/plugins/local/. Поместите туда репозиторий, а затем выполните Developer: Reload Window из палитры команд:

Terminal window
git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega

Kiro

Kiro устанавливает плагин как power. На панели Powers выберите Add Custom Power, затем Import power from GitHub, введите адрес репозитория, https://github.com/aggrega-ai/aggrega-skills, и выберите Install. Kiro запускает и останавливает MCP-сервер плагина вместе с power.

OpenClaw

Terminal window
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills

OpenClaw дважды спрашивает, прежде чем установить плагин из источника, который он сам не проверял. Сначала он останавливается и просит вас проверить источник и снова выполнить команду с --force; затем он просит вашего согласия на то, что приносит плагин, — здесь навык и MCP-сервер, — с помощью --accept-capabilities. Проверив репозиторий, выполните:

Terminal window
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills --force --accept-capabilities

--force также заменяет уже установленный плагин с тем же именем, поэтому сначала проверьте openclaw plugins list, если раньше вы устанавливали плагин с именем aggrega.

Папка, в которой работает сервер

Инструменты Aggrega работают в рабочем пространстве, и на вызов, не указывающий никакого, ответ даётся в рабочем пространстве, которое сервер находит, исходя из папки, в которой он был запущен. Некоторые ассистенты запускают сервер плагина в собственной папке плагина, а не в вашем проекте, — так делает Codex. Навык велит ассистенту, прежде чем работать в проекте, проверить с помощью инструмента config-show, в каком рабочем пространстве отвечает сервер, и там, где они различаются, указывать папку проекта как workspace_root в каждом вызове, который его принимает, — полным путём, поскольку относительный workspace_root читается относительно рабочего пространства, в котором сервер уже отвечает.

Установка только навыка

Чтобы установить навык без плагина, используйте двоичный файл aggrega, который записывает встроенную в него копию. Установите его для ассистентов на вашем компьютере во всех ваших проектах:

Terminal window
aggrega skills install --global

Установите его для одного ассистента в текущем проекте, указав ассистента:

Terminal window
aggrega skills install --agent claude-code

Выведите список ассистентов, для которых его можно установить, с папкой, которую читает каждый из них:

Terminal window
aggrega skills list

Команда установки тоже может добавить его при установке исполняемого файла: соответствующий параметр описан в разделе Добавление навыка ассистента при установке. Установленный таким образом навык не включает подключение к серверу: подключите ассистента к серверу, как описано в разделе Подключение MCP-сервера.

Что навык сообщает вашему ассистенту

Навык объясняет ассистенту, как установить Aggrega, как подключить его к серверу aggrega mcp, как начать рабочее пространство и как выполнять цикл написания — scaffold, validate, build, — описанный в разделе Написание файлов Aggrega. Он не содержит копии ни одной схемы или контракта сущности: за каждым структурным ответом он отсылает ассистента к двоичному файлу — к инструментам MCP, когда сервер подключён, а иначе к командной строке aggrega, — а за значением понятий — к опубликованной документации.

Навык и MCP-сервер выполняют разные задачи, и ассистент работает лучше всего с обоими. Навык — это инструкции, которые читает ассистент; сервер, подключаемый плагином или по разделу Подключение MCP-сервера, — это инструменты, которые он вызывает. Ассистент, который не устанавливает ни одного плагина и которого нет в списке --agent, пропускает навык и всё равно получает доступ к тем же инструментам и справочным материалам через сервер.

Куда он устанавливается

Плагин хранит навык в папке, в которой ассистент хранит свои плагины. aggrega skills install записывает его в другое место: без --global — в папку навыков проекта для ассистента в корне вашего рабочего пространства, где фиксируются навыки проекта; с --global — в пользовательскую папку навыков ассистента в вашем домашнем каталоге, которую ассистент читает в каждом проекте. С --global и без --agent команда ищет ассистентов на вашем компьютере, выводит каждого найденного и то, по чему он найден, а в терминале спрашивает перед записью. aggrega skills приводит папки для каждого ассистента, то, по чему находят каждого из них, и то, что команда отказывается перезаписывать.

Поддержание навыка в актуальном состоянии

Навык, полученный с плагином, обновляется вместе с плагином тем способом, которым ассистент обновляет свои плагины; плагин, клонированный в локальную папку Cursor, обновляется командой git pull в этой папке, после чего выполняется Developer: Reload Window. Плагин подключает сервер, который запускает двоичный файл aggrega из вашего PATH, поэтому инструменты и справочные материалы соответствуют установленному у вас двоичному файлу.

Навык также встроен в двоичный файл aggrega, поэтому копия, которую записывает aggrega skills install, соответствует установленной у вас версии. После обновления Aggrega — команда установщика обновляет двоичный файл на месте — снова выполните ту же команду aggrega skills install, чтобы обновить эту копию до новой версии.