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

aggrega skills

Установить навык Aggrega в AI-ассистента

Синтаксис

aggrega skills

Описание

Install the skill that teaches an AI assistant to install and use Aggrega.
A skill is a folder holding a SKILL.md file in the open Agent Skills format,
which many assistants read from a skill folder of their own. The Aggrega skill
tells an assistant how to install Aggrega, how to connect it to the aggrega MCP
server, how to start a workspace, and how to run the authoring loop — scaffold,
validate, build. It carries no copy of any schema: it sends the assistant to
this binary for every structural question and to the published documentation
for every conceptual one.
The skill is built into this binary, so the copy it installs matches the
version you have.

Подкоманды

КомандаОписание
aggrega skills installЗаписать навык Aggrega в папку навыков ИИ-ассистента
aggrega skills listПеречислить навыки, поставляемые с этим исполняемым файлом, и ассистентов, для которых их можно установить

Описание aggrega skills install

Write the Aggrega skill into the skill folder of each assistant named with
--agent, so the assistant knows how to install and use Aggrega.
By default the skill goes into the assistant's project skill folder at the root
of your workspace — the one found from the directory you run the command in, or
named with --workspace-root; a directory no workspace marks is its own root —
which is where a project's own skills are committed. With --global it goes
into the assistant's per-user skill folder in your home directory instead,
where the assistant reads it in every project.
Every folder and file a project installation writes is held to the workspace:
a skill folder reached through a link leading out of it is refused, and
nothing is written.
--agent may be given more than once. Where several of the named assistants read
the same folder, the skill is written there once.
With --global and no --agent, the skill is installed for the assistants found
on this machine: each one whose configuration folder is in your home directory
or whose command is on your PATH, as the table below names them. The command
prints each assistant it found and what found it. At a terminal it then asks
before writing: press Enter to install for those, or type the identifiers of
other assistants to add them. Where standard input is not a terminal it
installs for the assistants found without asking. Where it finds none and is
given none, it writes nothing and says so. A project installation is for the
assistants a project's people use rather than those on one machine, so it
always names them with --agent.
The skill is written as a folder named aggrega holding SKILL.md, and every file
written carries a comment line saying where it comes from. Running the command
again replaces a copy carrying that line, which is how a newer aggrega brings
the skill up to its own version. A file at the target that does not carry it
was not written by this command, so the command refuses, names the file and
writes nothing; move it aside or remove it, then run the command again. Every
target is checked before anything is written, so a refusal leaves every folder
as it was.
The assistants it installs for, the folders each one reads, and what finds each
on this machine — its configuration folder in your home directory, or its
command on your PATH:
--agent assistant project folder per-user folder found by
amp Amp .agents/skills ~/.config/amp/skills ~/.config/amp, amp
antigravity Antigravity .agents/skills ~/.gemini/config/skills ~/.gemini/antigravity, antigravity
antigravity-cli Antigravity CLI .agents/skills ~/.gemini/antigravity-cli/skills ~/.gemini/antigravity-cli
claude-code Claude Code .claude/skills ~/.claude/skills ~/.claude, claude
cline Cline .cline/skills ~/.cline/skills ~/.cline, cline
codex Codex .agents/skills ~/.agents/skills ~/.codex, codex
cursor Cursor .cursor/skills ~/.cursor/skills ~/.cursor, cursor
gemini-cli Gemini CLI .gemini/skills ~/.gemini/skills gemini
github-copilot GitHub Copilot .github/skills ~/.copilot/skills ~/.copilot, copilot
goose Goose .agents/skills ~/.agents/skills ~/.config/goose, goose
opencode OpenCode .opencode/skills ~/.config/opencode/skills ~/.config/opencode, opencode
windsurf Windsurf .devin/skills ~/.codeium/windsurf/skills ~/.codeium/windsurf, windsurf
zed Zed .agents/skills ~/.agents/skills ~/.config/zed, zed
An assistant that is not listed is refused by name. It can still use Aggrega
through its MCP server: connect it to "aggrega mcp" as
https://aggrega.ai/docs/install/ describes.

Флаги aggrega skills install

ФлагПо умолчаниюОписание
--agent[]Ассистент, для которого устанавливается навык, по идентификатору (например, claude-code, codex, cursor или gemini-cli). Можно повторять; справка перечисляет каждый идентификатор и папку, в которую записывает каждый из них. Обязателен без —global; с —global и без указанных ассистентов навык устанавливается для ассистентов, найденных на этой машине.
--globalfalseУстановить в пользовательскую папку навыков каждого ассистента в вашем домашнем каталоге, которую он читает в каждом проекте, вместо папки навыков проекта в корне рабочего пространства.

Описание aggrega skills list

List the skills built into this binary, and the assistants "aggrega skills
install" can write them for, with the project folder and the per-user folder
each assistant reads skills from. It writes nothing.

Что делает команда

aggrega skills install записывает навык Aggrega в папку навыков каждого ИИ-ассистента, названного с помощью --agent, или, с --global и без --agent, каждого ассистента, которого она находит на этой машине. Навык — это папка с файлом SKILL.md в открытом формате Agent Skills: короткий блок frontmatter, называющий навык и указывающий, когда его использовать, а за ним инструкции. Ассистент, читающий навыки, загружает его, когда ваш запрос подходит, и поэтому знает, как установить Aggrega, как подключиться к aggrega mcp, как начать рабочее пространство и как выполнять цикл авторинга, описанный в разделе Написание файлов Aggrega.

Навык не содержит копии какой-либо схемы или контракта сущности. Он велит ассистенту запрашивать у исполняемого файла каждый структурный ответ — через инструменты MCP, если сервер подключён, иначе через командную строку aggrega — и читать опубликованную документацию, чтобы узнать, что что означает. Навык встроен в исполняемый файл, поэтому записываемая копия соответствует установленной у вас версии.

Terminal window
aggrega skills install --agent claude-code
Installed the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggrega

Куда попадает навык

Без --global навык попадает в папку навыков проекта ассистента в корне вашего рабочего пространства — туда, где ассистент ищет навыки проекта и где вы их фиксируете в репозитории. Рабочее пространство — то, которое находит каждая команда: названное --workspace-root или найденное от каталога, в котором вы запускаете команду, поэтому запуск из подпапки всё равно устанавливает навык в корень; каталог, который не отмечает никакое рабочее пространство, является собственным корнем. С --global навык попадает в пользовательскую папку навыков ассистента в вашем домашнем каталоге, которую ассистент читает в каждом проекте. Таблица в описании выше приводит обе папки для каждого ассистента; каждая — это папка, которую называет собственная документация ассистента, а ~ обозначает ваш домашний каталог.

Несколько ассистентов читают общую папку .agents/skills. Если назвать более одного из них, навык записывается туда один раз, а все они перечисляются в одной строке, сообщающей об этом:

Terminal window
aggrega skills install --agent codex --agent zed --global
Installed the aggrega skill for Codex and Zed at /home/you/.agents/skills/aggrega

Ассистенты на этой машине

С --global и без --agent команда устанавливает навык для ассистентов, которых находит на этой машине. Ассистент считается найденным, если его собственная папка конфигурации находится в вашем домашнем каталоге или его команда есть в вашем PATH; столбец found by таблицы в описании выше указывает и то и другое для каждого ассистента. Папка или команда используется только там, где она принадлежит одному этому ассистенту, поэтому её обнаружение никогда не означает другого: общая папка .agents/skills не находит никого, а .gemini, где хранят файлы и Gemini CLI, и Antigravity, не находит ни одного из них — Gemini CLI находится по своей команде gemini, а каждый продукт Antigravity — по собственной папке внутри .gemini. Ассистент, конфигурация которого находится в другом месте системы, находится по своей команде или указывается с помощью --agent.

Команда выводит каждого найденного ассистента и то, по чему он найден, а затем выполняет установку:

Terminal window
aggrega skills install --global
Found Claude Code (claude-code), from the folder /home/you/.claude
Found Codex (codex), from the command /usr/local/bin/codex
Installed the aggrega skill for Claude Code at /home/you/.claude/skills/aggrega
Installed the aggrega skill for Codex at /home/you/.agents/skills/aggrega

В терминале она сначала спрашивает. После строк с найденным она просит вас подтвердить: нажмите Enter, чтобы установить для этих ассистентов, или введите идентификаторы других ассистентов через пробелы или запятые, чтобы добавить их. Если не найдено ни одного, она вместо этого запрашивает идентификаторы, а пустой ответ ничего не записывает. Когда стандартный ввод не является терминалом — в скрипте, у ассистента, запускающего команду за вас, или в собственном инструменте ассистента для этого — она ничего не спрашивает и устанавливает для найденных ассистентов. Если она не находит ни одного и ни один не указан, она ничего не записывает, сообщает об этом и завершается с ненулевым кодом.

Указание любого --agent отменяет поиск: команда устанавливает для указанных вами ассистентов и ни для каких других. Установка в проект, без --global, всегда их указывает: она предназначена для ассистентов, которыми пользуются участники проекта, а этого данная машина сказать не может.

Повторная установка и что отклоняется

Каждый файл, который записывает команда, содержит одну строку комментария сразу после frontmatter, сообщающую, что он получен из навыка, встроенного в исполняемый файл aggrega, и что повторная установка его заменит. По этой строке команда отличает свою копию от вашей:

  • Копия с этой строкой заменяется. Повторный запуск команды после обновления Aggrega обновляет навык до новой версии, а выводимая строка сообщает Replaced, а не Installed.
  • Файл без этой строки отклоняется. SKILL.md, уже находящийся в месте назначения и записанный не командой, принадлежит вам, поэтому команда называет его путь, ничего никуда не записывает и завершается с ненулевым кодом. Переместите файл в сторону или удалите его, затем снова запустите команду. Чтобы сохранить собственные изменения, держите их в навыке с другим именем.
  • Папка, достигаемая через ссылку, ведущую за пределы рабочего пространства, отклоняется. Без --global каждая папка и каждый файл, которые записала бы команда, ограничены рабочим пространством: если папка навыков ассистента или папка на пути к ней является ссылкой, ведущей за пределы рабочего пространства, команда называет ссылку и то, куда она ведёт, ничего никуда не записывает и завершается с ненулевым кодом — это условие, описанное в A path the operation writes leads through a link out of the directory it must stay inside (Путь, в который записывает операция, ведёт через ссылку за пределы каталога, внутри которого он должен оставаться). Через ссылку, остающуюся внутри рабочего пространства, запись выполняется.

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

Неизвестные ассистенты

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

Примеры

Установить навык для Claude Code в этом проекте:

Terminal window
aggrega skills install --agent claude-code

Установить его для Gemini CLI и Cursor во всех ваших проектах:

Terminal window
aggrega skills install --agent gemini-cli --agent cursor --global

Установить его во все ваши проекты для ассистентов на этой машине:

Terminal window
aggrega skills install --global

Обновить установленную копию до исполняемого файла, до которого вы только что обновились:

Terminal window
aggrega skills install --agent claude-code

Список известного

aggrega skills list выводит встроенные в этот исполняемый файл навыки с их описаниями, а затем каждого ассистента, известного aggrega skills install, с его папкой проекта и пользовательской папкой. Ничего не записывает.

Terminal window
aggrega skills list