Настройка Aggrega с помощью ИИ-ассистента
ИИ-ассистент, который может выполнять команды на вашей машине, — агент для программирования в терминале или редакторе — может настроить Aggrega за вас: установить двоичный файл aggrega, добавить себе навык Aggrega и подключиться к MCP-серверу Aggrega. Ассистент, который устанавливает плагины, выполняет два последних шага за один, устанавливая плагин Aggrega; любой другой добавляет навык и подключает сервер по очереди. Вставьте в него приведённый ниже промпт, и он пройдёт эти шаги; промпт велит ему согласовать с вами любую установку, прежде чем что-либо устанавливать.
Когда всё готово, у ассистента есть два способа работать с Aggrega. Навык — это папка с файлом SKILL.md, которую ассистент загружает, когда ваш запрос касается Aggrega: навык объясняет ассистенту, как устроен цикл написания, и велит брать любой ответ о схеме или файле из двоичного файла, а не из памяти. MCP-сервер, aggrega mcp, даёт ассистенту инструменты Aggrega — scaffold, validate, build и остальные — и справочные материалы, на которые они опираются. Навык и плагин описаны в разделе Навык Aggrega, сервер — в разделе Подключение MCP-сервера, а то, что ассистент получает через него, — в разделе Что ваш ассистент может делать с Aggrega.
После настройки страница Начало работы, каждое пошаговое руководство в разделе Импорт и страница каждого запускаемого примера, который собирается с помощью Aggrega, приводят задачу, которой они обучают, в виде промпта для вставки в ассистента рядом с командами.
Промпт
Настройте для меня Aggrega шаг за шагом и на каждом шаге сообщайте, что вы запустили.
1. Запустите `aggrega version`. Если команда не найдена, спросите меня, прежде чем устанавливать Aggrega, а затем установите его для моего пользователя официальным установщиком: в Linux или macOS — `curl -fsSL https://aggrega.ai/install.sh | sh`, в Windows в PowerShell — `irm https://aggrega.ai/install.ps1 | iex`. Снова запустите `aggrega version`. Если установщик вывел строку, которую нужно добавить в мой `PATH`, покажите её мне.2. Если `https://aggrega.ai/docs/ai-assistants/skill/` указывает способ установить в вас плагин Aggrega, спросите меня, прежде чем его устанавливать, а затем установите его этим способом или скажите мне, что сделать, если это шаг, который я выполняю в вашем интерфейсе. Плагин добавляет навык Aggrega и подключает вас к MCP-серверу Aggrega. Иначе запустите `aggrega skills install --help` и найдите свой идентификатор в выведенном списке. Спросите меня, нужен ли мне навык в этом проекте или во всех проектах, а затем запустите `aggrega skills install --agent <your identifier>`, добавив `--global` для всех проектов. Если вас нет в списке, пропустите установку навыка и сообщите об этом.3. Если вы установили плагин, вы уже подключены к MCP-серверу Aggrega. Иначе подключитесь к MCP-серверу Aggrega, то есть к команде `aggrega mcp`, тем способом, которым вы добавляете MCP-сервер, как описано для вас на `https://aggrega.ai/docs/ai-assistants/mcp-server/`. Если для загрузки плагина или сервера нужен перезапуск или перезагрузка, скажите мне, что сделать.4. После подключения вызовите инструмент `describe-capabilities` без аргументов и кратко изложите, что он перечисляет.Промпт одинаков на каждом языке, на котором опубликована документация: переведены только его предложения, а каждая команда, флаг, адрес и имя инструмента в нём остаются в точности такими, как написаны, поэтому ассистент читает одни и те же инструкции, с какого бы языка вы его ни скопировали.
Установщик загружает последний выпуск, проверяет его по опубликованным для этого выпуска дайджестам SHA-256 и устанавливает его только для вашего пользователя, без прав администратора; в разделе Установка двоичного файла описано, что он делает и как вместо этого установить вручную.
Что различается от ассистента к ассистенту
Три части промпта зависят от ассистента: способ, которым он устанавливает плагин Aggrega, если он устанавливает плагины; иначе — идентификатор, который он передаёт в --agent при установке навыка, и способ добавления сервера. Ассистент определяет их по промпту, но если вы их знаете, можно вписать их в промпт.
| Ассистент | Установка плагина | Установка навыка без плагина |
|---|---|---|
| Claude Code | claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills | aggrega skills install --agent claude-code |
| Codex | codex plugin marketplace add aggrega-ai/aggrega-skills, затем codex plugin add aggrega@aggrega | aggrega skills install --agent codex |
| GitHub Copilot CLI | copilot plugin marketplace add aggrega-ai/aggrega-skills, затем copilot plugin install aggrega@aggrega | aggrega skills install --agent github-copilot |
| Gemini CLI | gemini extensions install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent gemini-cli |
| Antigravity | agy plugin install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent antigravity или --agent antigravity-cli для Antigravity CLI |
| Cursor | git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega, затем Developer: Reload Window | aggrega skills install --agent cursor |
Visual Studio Code с GitHub Copilot, Kiro и OpenClaw тоже устанавливают плагин; в разделе Установка плагина приведён способ для каждого ассистента, а также то, что OpenClaw спрашивает перед установкой. Идентификаторы, которые принимает --agent, и папка, в которую записывает каждый из них, перечислены в aggrega skills и выводятся командой aggrega skills install --help. То, как каждый ассистент добавляет сервер, — собственной командой или записью в своих настройках либо в файле со списком серверов, — описано для каждого клиента в разделе Подключение MCP-сервера.
Когда часть промпта неприменима
- Ассистент, который устанавливает плагин, пропускает подключение сервера: его подключил плагин. Плагин не устанавливает двоичный файл, поэтому шаг 1 по-прежнему нужен. Если ассистент запускает сервер плагина вне вашего проекта — Codex запускает его в собственной папке плагина, — навык велит ему указать серверу папку вашего проекта, как описано в разделе Папка, в которой работает сервер.
- Ассистент, который не устанавливает ни одного плагина и которого нет в списке
--agent, пропускает установку навыка. После подключения он всё равно получает доступ к инструментам Aggrega через MCP-сервер, а сервер при подключении передаёт ему собственные указания. - Ассистент, который не может выполнять команды, — чат-приложение без доступа к вашему терминалу — не может следовать промпту. Установите двоичный файл, как описано в разделе Установка, и подключите приложение сами, как описано в разделе Подключение MCP-сервера. О Claude Desktop см. раздел Claude Desktop ниже.
- Серверу, который запускает для вас кто-то другой и к которому вы обращаетесь по HTTPS, не нужны ни двоичный файл, ни плагин, ни навык. Вместо этого укажите адрес в клиенте ассистента, как описано в разделе Сервер, доступный по HTTPS.
Claude Desktop
Claude Desktop подключается к Aggrega через пакет расширения, который входит в каждый выпуск, и этот пакет запускает aggrega, установленный на вашем компьютере. Настройте и то и другое на своём компьютере сами:
- Установите
aggregaв PowerShell в Windows с помощьюirm https://aggrega.ai/install.ps1 | iexили в терминале в macOS или Linux с помощьюcurl -fsSL https://aggrega.ai/install.sh | sh. В разделе Установка двоичного файла описано, что делает установщик. - Установите пакет расширения, задайте его Workspace folder и перезапустите Claude Desktop, как описано в разделе Claude Desktop на странице «Подключение MCP-сервера».
Сеанс Claude Desktop может выполнять свои команды в облачном контейнере, а не на вашем компьютере, поэтому приведённый выше промпт, вставленный в него, действует на контейнер. Там aggrega устанавливается и запускается из оболочки сеанса, как только сетевая политика контейнера разрешает aggrega.ai, — владелец организации разрешает это в настройках сетевого доступа организации. MCP-сервер Aggrega там не подключён: Claude Desktop добавляет локальный сервер только из настроек своих расширений, а расширение запускает aggrega на вашем компьютере, а не тот, что в контейнере.
aggrega skills install не имеет записи для Claude Desktop, поэтому сеанс Claude Desktop пропускает установку навыка. После установки расширения он получает доступ к инструментам Aggrega через MCP-сервер, а сервер при подключении передаёт ему собственные указания.