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

A skill do Aggrega

A skill do Aggrega ensina um assistente de IA a instalar e usar o Aggrega. Ela é uma pasta chamada aggrega que contém um arquivo SKILL.md no formato aberto Agent Skills, que muitos assistentes leem de uma pasta de skills própria e carregam quando sua solicitação diz respeito ao Aggrega.

Há duas formas de fornecê-la a um assistente. Um assistente que instala plugins a recebe como parte do plugin do Aggrega, que também conecta o assistente ao servidor MCP do Aggrega, em uma única etapa: veja Instalar o plugin. Qualquer assistente que lê skills de uma pasta pode ter a skill gravada ali pelo binário aggrega: veja Instalar apenas a skill.

Instalar o plugin

O repositório aggrega-ai/aggrega-skills contém a skill e também é um plugin para os assistentes abaixo. Instalar o plugin adiciona a skill do Aggrega e conecta o assistente ao servidor MCP do Aggrega, que o próprio assistente então inicia como aggrega mcp, então nem aggrega skills install nem as etapas de Conectar o servidor MCP são necessários para esse assistente.

O plugin não instala o binário aggrega. Instale-o primeiro, como descreve Instalar o binário, para que o assistente encontre aggrega no PATH quando iniciar o servidor.

Claude Code

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

Dentro do Claude Code, o equivalente é /plugin install aggrega --marketplace aggrega-ai/aggrega-skills.

Codex

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

O primeiro comando adiciona o repositório como um marketplace de plugins chamado aggrega; o segundo instala a partir dele o plugin aggrega.

GitHub Copilot

No GitHub Copilot CLI:

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

O Visual Studio Code com o GitHub Copilot encontra os plugins que o GitHub Copilot CLI instalou e também os usa. Para instalar o plugin pelo próprio Visual Studio Code, execute Chat: Install Plugin from Source na paleta de comandos e informe o endereço do repositório, https://github.com/aggrega-ai/aggrega-skills.

Gemini CLI

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

O Gemini CLI instala o plugin como uma de suas extensões.

Antigravity

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

Cursor

O Cursor carrega um plugin de uma pasta dentro de ~/.cursor/plugins/local/. Coloque o repositório ali e depois execute Developer: Reload Window na paleta de comandos:

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

Kiro

O Kiro instala o plugin como um power. No painel Powers, escolha Add Custom Power, depois Import power from GitHub, digite o endereço do repositório, https://github.com/aggrega-ai/aggrega-skills, e escolha Install. O Kiro inicia e para o servidor MCP do plugin junto com o power.

OpenClaw

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

O OpenClaw pergunta duas vezes antes de instalar um plugin de uma origem que ele mesmo não revisou. Primeiro ele para e pede que você revise a origem e execute o comando novamente com --force; depois pede seu consentimento para o que o plugin traz — aqui, a skill e um servidor MCP — com --accept-capabilities. Depois de revisar o repositório, execute:

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

--force também substitui um plugin de mesmo nome que já esteja instalado, então verifique openclaw plugins list antes se você já instalou um chamado aggrega.

A pasta em que o servidor trabalha

As ferramentas do Aggrega trabalham em um workspace, e uma chamada que não indica nenhum é respondida no workspace que o servidor encontra a partir da pasta em que foi iniciado. Alguns assistentes iniciam o servidor de um plugin na própria pasta do plugin, e não no seu projeto — o Codex faz isso. A skill diz ao assistente para verificar em qual workspace o servidor responde, com a ferramenta config-show, antes de trabalhar em um projeto, e para informar a pasta do projeto como workspace_root em cada chamada que o aceita quando os dois forem diferentes — pelo caminho completo, porque um workspace_root relativo é lido a partir do workspace em que o servidor já responde.

Instalar apenas a skill

Para instalar a skill sem o plugin, use o binário aggrega, que grava a cópia embutida nele. Instale-a para os assistentes da sua máquina, em todos os seus projetos:

Terminal window
aggrega skills install --global

Instale-a para um assistente no projeto em que você está, informando o nome do assistente:

Terminal window
aggrega skills install --agent claude-code

Liste os assistentes para os quais ela pode ser instalada, com a pasta que cada um lê:

Terminal window
aggrega skills list

O comando de instalação também pode adicioná-la enquanto instala o binário: Adicionar a skill do assistente durante a instalação informa a opção. Instalada dessa forma, a skill vem sem a conexão com o servidor: conecte o assistente ao servidor como descreve Conectar o servidor MCP.

O que a skill diz ao seu assistente

A skill diz ao assistente como instalar o Aggrega, como conectá-lo ao servidor aggrega mcp, como iniciar um workspace e como executar o ciclo de criação — scaffold, validate, build — que Criar arquivos do Aggrega descreve. Ela não traz nenhuma cópia de nenhum schema ou contrato de entidade: encaminha o assistente ao binário para toda resposta estrutural — as ferramentas MCP onde o servidor está conectado, a linha de comando aggrega nos demais casos — e à documentação publicada para o significado das coisas.

A skill e o servidor MCP fazem trabalhos diferentes, e um assistente funciona melhor com os dois. A skill são instruções que o assistente lê; o servidor, que o plugin ou Conectar o servidor MCP conecta, são as ferramentas que ele chama. Um assistente que não instala nenhum plugin e não está na lista de --agent pula a skill e ainda assim alcança as mesmas ferramentas e o mesmo material de referência pelo servidor.

Onde ela é instalada

O plugin guarda a skill na pasta em que o assistente guarda seus plugins. aggrega skills install a grava em outro lugar: sem --global, na pasta de skills de projeto do assistente, na raiz do seu workspace, onde as skills do projeto são versionadas; com --global, na pasta de skills por usuário do assistente no seu diretório home, que o assistente lê em todos os projetos. Com --global e sem --agent, o comando procura os assistentes na sua máquina, exibe cada um que encontrou e o que o encontrou e, em um terminal, pergunta antes de gravar. aggrega skills informa as pastas de cada assistente, o que encontra cada um e o que o comando se recusa a sobrescrever.

Manter a skill atualizada

Uma skill que veio com o plugin é atualizada junto com o plugin, pela forma própria do assistente de atualizar seus plugins; um plugin clonado na pasta local do Cursor é atualizado com git pull nessa pasta, seguido de Developer: Reload Window. O plugin conecta o servidor que o binário aggrega do seu PATH executa, então as ferramentas e o material de referência acompanham o binário que você tem instalado.

A skill também é embutida no binário aggrega, então a cópia que aggrega skills install grava corresponde à versão que você tem instalada. Depois de atualizar o Aggrega — o comando do instalador atualiza o binário no lugar —, execute novamente o mesmo comando aggrega skills install para levar essa cópia à nova versão.