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

A skill do Aggrega

A skill do Aggrega ensina um assistente de IA a instalar e utilizar o Aggrega. É uma pasta chamada aggrega que contém um ficheiro SKILL.md no formato aberto Agent Skills, que muitos assistentes leem a partir de uma pasta de skills própria e carregam quando o pedido diz respeito ao Aggrega.

Há duas formas de a disponibilizar a um assistente. Um assistente que instala plugins recebe-a como parte do plugin do Aggrega, que também liga o assistente ao servidor MCP do Aggrega, num único passo: consulte Instalar o plugin. Qualquer assistente que leia skills de uma pasta pode ter a skill escrita aí pelo binário aggrega: consulte 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. A instalação do plugin adiciona a skill do Aggrega e liga o assistente ao servidor MCP do Aggrega, que o próprio assistente inicia depois como aggrega mcp, pelo que nem aggrega skills install nem os passos de Ligar 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

No 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 utiliza. Para instalar o plugin a partir do próprio Visual Studio Code, execute Chat: Install Plugin from Source na paleta de comandos e indique 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 das suas extensões.

Antigravity

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

Cursor

O Cursor carrega um plugin a partir de uma pasta dentro de ~/.cursor/plugins/local/. Coloque aí o repositório 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, introduza 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 juntamente 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 não reviu ele próprio. Primeiro, para e pede que se reveja a origem e se volte a executar o comando com --force; depois, pede consentimento para aquilo que o plugin traz — neste caso, a skill e um servidor MCP — com --accept-capabilities. Depois de rever o repositório, execute:

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

--force também substitui um plugin com o mesmo nome que já esteja instalado, pelo que convém verificar primeiro openclaw plugins list caso já tenha sido instalado antes um chamado aggrega.

A pasta em que o servidor trabalha

As ferramentas do Aggrega trabalham num workspace, e uma chamada que não indique 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 projeto — o Codex fá-lo. A skill indica ao assistente que verifique em que workspace o servidor responde, com a ferramenta config-show, antes de trabalhar num projeto, e que indique a pasta do projeto como workspace_root em cada chamada que o aceite, quando as duas 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, utilize o binário aggrega, que escreve a cópia nele incorporada. Instale-a para os assistentes do computador, em todos os projetos:

Terminal window
aggrega skills install --global

Instale-a para um assistente no projeto atual, indicando o assistente:

Terminal window
aggrega skills install --agent claude-code

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

Terminal window
aggrega skills list

O comando de instalação também a pode adicionar, enquanto instala o binário: Adicionar a skill do assistente durante a instalação indica a opção. Instalada desta forma, a skill vem sem a ligação ao servidor: ligue o assistente ao servidor como descreve Ligar o servidor MCP.

O que a skill diz ao assistente

A skill indica ao assistente como instalar o Aggrega, como o ligar ao servidor aggrega mcp, como iniciar um workspace e como executar o ciclo de criação — scaffold, validate, build — que Criar ficheiros do Aggrega descreve. Não contém nenhuma cópia de qualquer schema ou contrato de entidade: remete o assistente para o binário em cada resposta estrutural — as ferramentas MCP onde o servidor está ligado, a linha de comandos aggrega nos restantes casos — e para a documentação publicada quanto ao significado das coisas.

A skill e o servidor MCP fazem trabalhos diferentes, e um assistente funciona melhor com ambos. A skill são instruções que o assistente lê; o servidor, que o plugin ou Ligar o servidor MCP liga, são as ferramentas que chama. Um assistente que não instala nenhum plugin e não está na lista de --agent dispensa a skill e chega, mesmo assim, às mesmas ferramentas e ao mesmo material de referência através do servidor.

Onde é instalada

O plugin guarda a skill na pasta em que o assistente guarda os seus plugins. aggrega skills install escreve-a noutro local: sem --global, na pasta de skills de projeto do assistente, na raiz do workspace, onde se faz commit das skills do projeto; com --global, na pasta de skills por utilizador do assistente, no diretório pessoal, que o assistente lê em todos os projetos. Com --global e sem --agent, o comando procura os assistentes no computador, imprime cada um dos que encontrou e o que o encontrou e, num terminal, pede confirmação antes de escrever. aggrega skills indica as pastas de cada assistente, o que encontra cada um e o que o comando se recusa a substituir.

Manter a skill atualizada

Uma skill que veio com o plugin é atualizada com o plugin, através da forma própria do assistente de atualizar os seus plugins; um plugin clonado na pasta local do Cursor é atualizado com git pull nessa pasta, seguido de Developer: Reload Window. O plugin liga o servidor que o binário aggrega do PATH executa, pelo que as ferramentas e o material de referência acompanham o binário instalado.

A skill também está incorporada no binário aggrega, pelo que a cópia que aggrega skills install escreve corresponde à versão instalada. Depois de atualizar o Aggrega — o comando do instalador atualiza o binário no próprio local —, volte a executar o mesmo comando aggrega skills install para levar essa cópia à nova versão.