Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

aggrega skills

Instalar a skill do Aggrega num assistente de IA

Sinopse

aggrega skills

Descrição

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.

Subcomandos

ComandoDescrição
aggrega skills installEscreve a skill do Aggrega na pasta de skills de um assistente de IA
aggrega skills listLista as skills que este binário inclui e os assistentes para os quais as pode instalar

Descrição de 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.

Flags de aggrega skills install

FlagPredefiniçãoDescrição
--agent[]Assistente para o qual instalar a skill, por identificador (por exemplo claude-code, codex, cursor ou gemini-cli). Repetível; a ajuda enumera cada identificador e a pasta em que cada um escreve. Obrigatório sem —global; com —global e nenhum indicado, a skill é instalada para os assistentes encontrados nesta máquina.
--globalfalseInstala na pasta de skills por utilizador de cada assistente, no diretório pessoal, que o assistente lê em todos os projetos, em vez de na pasta de skills do projeto na raiz do workspace.

Descrição de 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.

O que faz

aggrega skills install escreve a skill do Aggrega na pasta de skills de cada assistente de IA nomeado com --agent ou, com --global e sem --agent, de cada um que encontra nesta máquina. Uma skill é uma pasta que contém um ficheiro SKILL.md no formato aberto Agent Skills: um breve bloco de frontmatter que nomeia a skill e diz quando a usar, seguido de instruções. Um assistente que lê skills carrega-a quando o pedido corresponde, e fica assim a saber como instalar o Aggrega, como se ligar ao aggrega mcp, como iniciar um espaço de trabalho e como executar o ciclo de autoria descrito em Escrever ficheiros do Aggrega.

A skill não contém qualquer cópia de um schema ou de um contrato de entidade. Indica ao assistente que peça ao binário cada resposta estrutural — as ferramentas MCP onde o servidor está ligado e, caso contrário, a linha de comandos aggrega — e que leia a documentação publicada para saber o que as coisas significam. A skill está incorporada no binário, pelo que a cópia que escreve corresponde à versão instalada.

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

Onde fica a skill

Sem --global, a skill vai para a pasta de skills de projeto do assistente na raiz do workspace, onde o assistente procura as skills do projeto e onde estas são submetidas com commit. O workspace é aquele que todos os comandos encontram — o que --workspace-root indica, ou o encontrado a partir do diretório em que o comando é executado, pelo que executá-lo a partir de uma subpasta instala na mesma na raiz — e um diretório que nenhum workspace marca é a sua própria raiz. Com --global, vai para a pasta de skills por utilizador do assistente no diretório pessoal, que o assistente lê em todos os projetos. A tabela na descrição acima indica ambas as pastas para cada assistente; cada uma é a pasta que a documentação do próprio assistente indica, e ~ representa o diretório pessoal.

Vários assistentes leem a pasta partilhada .agents/skills. Nomear mais do que um deles escreve a skill aí uma única vez e nomeia-os todos na única linha que o reporta:

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

Os assistentes nesta máquina

Com --global e sem --agent, o comando instala a skill para os assistentes que encontra nesta máquina. Um assistente conta como encontrado quando a sua própria pasta de configuração está no diretório pessoal do utilizador, ou o seu comando está no PATH; a coluna found by da tabela na descrição acima indica ambos para cada assistente. Uma pasta ou um comando só é usado quando pertence exclusivamente a esse assistente, pelo que encontrá-lo nunca vale por outro: a pasta partilhada .agents/skills não encontra ninguém, e .gemini, onde tanto o Gemini CLI como o Antigravity guardam ficheiros, não encontra nenhum dos dois — o Gemini CLI é encontrado pelo seu comando gemini, e cada produto Antigravity pela sua própria pasta dentro de .gemini. Um assistente cuja configuração se encontra noutro local do sistema é encontrado pelo seu comando, ou nomeado com --agent.

O comando imprime cada assistente que encontrou e aquilo que o encontrou, e depois instala:

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

Num terminal, pergunta primeiro. Depois das linhas que nomeiam o que encontrou, pede confirmação: prima Enter para instalar para esses, ou escreva os identificadores de outros assistentes, separados por espaços ou vírgulas, para os acrescentar. Quando não encontrou nenhum, pede antes os identificadores, e uma resposta vazia não escreve nada. Quando a entrada padrão não é um terminal — um script, um assistente a executar o comando pelo utilizador, ou a própria ferramenta do assistente para o efeito —, não pergunta nada e instala para os assistentes que encontrou. Quando não encontra nenhum e nenhum lhe é indicado, não escreve nada, informa disso e termina com um código diferente de zero.

Nomear qualquer --agent salta a pesquisa: o comando instala para os assistentes nomeados e para nenhum outro. Uma instalação de projeto, sem --global, nomeia-os sempre: destina-se aos assistentes que as pessoas do projeto usam, o que esta máquina não indica.

Instalar novamente, e o que recusa

Cada ficheiro que o comando escreve tem uma linha de comentário, logo a seguir ao frontmatter, a indicar que provém da skill incorporada no binário aggrega e que instalar novamente o substitui. É por essa linha que o comando distingue a sua própria cópia da do utilizador:

  • Uma cópia com a linha é substituída. Executar novamente o comando depois de atualizar o Aggrega leva a skill para a nova versão, e a linha que imprime diz Replaced em vez de Installed.
  • Um ficheiro sem a linha é recusado. Um SKILL.md já presente no destino que o comando não escreveu pertence ao utilizador, pelo que o comando indica o respetivo caminho, não escreve nada em lado nenhum e termina com um código diferente de zero. Mova o ficheiro para outro lado ou remova-o e, em seguida, execute novamente o comando. Para manter alterações próprias, mantenha-as numa skill com outro nome.
  • Uma pasta alcançada através de uma ligação que leva para fora do workspace é recusada. Sem --global, todas as pastas e ficheiros que o comando escreveria ficam restritos ao workspace: quando a pasta de skills de um assistente, ou uma pasta no caminho até ela, é uma ligação que leva para fora do workspace, o comando indica a ligação e para onde leva, não escreve nada em lado nenhum e termina com um código diferente de zero — a condição descrita em A path the operation writes leads through a link out of the directory it must stay inside (Um caminho que a operação escreve leva, através de uma ligação, para fora do diretório dentro do qual tem de permanecer). Uma ligação que permanece dentro do workspace é seguida na escrita.

Cada destino é verificado antes de qualquer escrita, pelo que uma recusa para um assistente deixa também a pasta de todos os outros assistentes como estava. Os ficheiros na pasta da skill que a skill não escreve são deixados intactos.

Assistentes que não conhece

--agent aceita apenas os identificadores da tabela acima, sendo cada um o identificador que a ferramenta aberta de linha de comandos para skills usa para o mesmo assistente. Qualquer outro identificador é recusado pelo nome, com a lista dos que conhece. Um assistente que não esteja listado pode ainda assim usar o Aggrega: ligue-o ao servidor MCP conforme descrito em Ligar o servidor MCP, e alcança as mesmas ferramentas e o mesmo material de referência para os quais a skill aponta.

Exemplos

Instalar a skill para o Claude Code neste projeto:

Terminal window
aggrega skills install --agent claude-code

Instalá-la para o Gemini CLI e o Cursor em todos os seus projetos:

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

Instalá-la em todos os seus projetos para os assistentes nesta máquina:

Terminal window
aggrega skills install --global

Atualizar uma cópia instalada para o binário para o qual acabou de atualizar:

Terminal window
aggrega skills install --agent claude-code

Listar o que conhece

aggrega skills list imprime as skills incorporadas neste binário com as respetivas descrições e, em seguida, cada assistente que aggrega skills install conhece, com a respetiva pasta de projeto e pasta por utilizador. Não escreve nada.

Terminal window
aggrega skills list