Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

La skill di Aggrega

La skill di Aggrega insegna a un assistente AI a installare e usare Aggrega. È una cartella chiamata aggrega che contiene un file SKILL.md nel formato aperto Agent Skills, che molti assistenti leggono da una propria cartella delle skill e caricano quando la tua richiesta riguarda Aggrega.

Ci sono due modi per fornirla a un assistente. Un assistente che installa plugin la riceve come parte del plugin di Aggrega, che collega anche l’assistente al server MCP di Aggrega, in un solo passaggio: vedi Installare il plugin. Qualsiasi assistente che legge le skill da una cartella può farsi scrivere lì la skill dal binario aggrega: vedi Installare solo la skill.

Installare il plugin

Il repository aggrega-ai/aggrega-skills contiene la skill ed è anche un plugin per gli assistenti elencati sotto. L’installazione del plugin aggiunge la skill di Aggrega e collega l’assistente al server MCP di Aggrega, che l’assistente poi avvia da sé come aggrega mcp, quindi per quell’assistente non servono né aggrega skills install né i passaggi di Collegare il server MCP.

Il plugin non installa il binario aggrega. Installalo prima, come descrive Installare il binario, in modo che l’assistente trovi aggrega nel PATH quando avvia il server.

Claude Code

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

All’interno di Claude Code, l’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

Il primo comando aggiunge il repository come marketplace di plugin chiamato aggrega; il secondo installa da esso il plugin aggrega.

GitHub Copilot

In GitHub Copilot CLI:

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

Visual Studio Code con GitHub Copilot trova i plugin installati da GitHub Copilot CLI e li usa a sua volta. Per installare il plugin da Visual Studio Code stesso, esegui Chat: Install Plugin from Source dalla palette dei comandi e indica l’indirizzo del repository, https://github.com/aggrega-ai/aggrega-skills.

Gemini CLI

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

Gemini CLI installa il plugin come una delle sue estensioni.

Antigravity

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

Cursor

Cursor carica un plugin da una cartella sotto ~/.cursor/plugins/local/. Metti lì il repository, poi esegui Developer: Reload Window dalla palette dei comandi:

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

Kiro

Kiro installa il plugin come power. Nel pannello Powers, scegli Add Custom Power, poi Import power from GitHub, inserisci l’indirizzo del repository, https://github.com/aggrega-ai/aggrega-skills, e scegli Install. Kiro avvia e arresta il server MCP del plugin insieme al power.

OpenClaw

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

OpenClaw chiede conferma due volte prima di installare un plugin da una fonte che non ha verificato esso stesso. Prima si ferma e ti chiede di verificare la fonte e di eseguire di nuovo il comando con --force; poi chiede il tuo consenso a ciò che il plugin porta con sé — in questo caso la skill e un server MCP — con --accept-capabilities. Dopo aver verificato il repository, esegui:

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

--force sostituisce anche un plugin con lo stesso nome già installato, quindi controlla prima openclaw plugins list se in passato ne hai installato uno chiamato aggrega.

La cartella in cui lavora il server

Gli strumenti di Aggrega lavorano in un workspace, e una chiamata che non ne indica nessuno riceve risposta nel workspace che il server trova a partire dalla cartella in cui è stato avviato. Alcuni assistenti avviano il server di un plugin nella cartella del plugin stesso anziché nel tuo progetto — Codex lo fa. La skill dice all’assistente di verificare, con lo strumento config-show, in quale workspace risponde il server prima di lavorare in un progetto, e di indicare la cartella del progetto come workspace_root in ogni chiamata che lo accetta, quando le due differiscono — con il suo percorso completo, perché un workspace_root relativo viene letto a partire dal workspace in cui il server già risponde.

Installare solo la skill

Per installare la skill senza il plugin, usa il binario aggrega, che scrive la copia incorporata al suo interno. Installala per gli assistenti presenti sulla tua macchina, in tutti i tuoi progetti:

Terminal window
aggrega skills install --global

Installala per un solo assistente nel progetto in cui ti trovi, indicando l’assistente:

Terminal window
aggrega skills install --agent claude-code

Elenca gli assistenti per cui può essere installata, con la cartella che ciascuno legge:

Terminal window
aggrega skills list

Anche il comando di installazione può aggiungerla, mentre installa il binario: Aggiungere la skill per l’assistente durante l’installazione indica l’opzione. Installata in questo modo, la skill arriva senza il collegamento al server: collega l’assistente al server come descrive Collegare il server MCP.

Cosa dice la skill al tuo assistente

La skill indica all’assistente come installare Aggrega, come collegarlo al server aggrega mcp, come avviare un workspace e come eseguire il ciclo di scrittura — scaffold, validate, build — descritto in Scrivere file Aggrega. Non contiene alcuna copia di uno schema o di un contratto di entità: rimanda l’assistente al binario per ogni risposta strutturale — gli strumenti MCP dove il server è collegato, altrimenti la riga di comando aggrega — e alla documentazione pubblicata per il significato delle cose.

La skill e il server MCP svolgono compiti diversi, e un assistente lavora meglio con entrambi. La skill è un insieme di istruzioni che l’assistente legge; il server, che il plugin o Collegare il server MCP collega, è l’insieme degli strumenti che chiama. Un assistente che non installa alcun plugin e non è nell’elenco di --agent salta la skill e raggiunge comunque gli stessi strumenti e lo stesso materiale di riferimento tramite il server.

Dove viene installata

Il plugin conserva la skill nella cartella in cui l’assistente conserva i suoi plugin. aggrega skills install la scrive altrove: senza --global, nella cartella delle skill di progetto dell’assistente, alla radice del tuo workspace, dove si fa il commit delle skill del progetto; con --global, nella cartella delle skill per utente dell’assistente nella tua home directory, che l’assistente legge in ogni progetto. Con --global e senza --agent, il comando cerca gli assistenti presenti sulla tua macchina, stampa ciascuno di quelli trovati e cosa lo ha trovato, e in un terminale chiede conferma prima di scrivere. aggrega skills indica le cartelle per ogni assistente, cosa trova ciascuno e cosa il comando si rifiuta di sovrascrivere.

Mantenere aggiornata la skill

Una skill arrivata con il plugin si aggiorna con il plugin, nel modo in cui l’assistente aggiorna i propri plugin; un plugin clonato nella cartella locale di Cursor si aggiorna con git pull in quella cartella, seguito da Developer: Reload Window. Il plugin collega il server eseguito dal binario aggrega nel tuo PATH, quindi gli strumenti e il materiale di riferimento seguono il binario che hai installato.

La skill è anche incorporata nel binario aggrega, quindi la copia che aggrega skills install scrive corrisponde alla versione che hai installato. Dopo aver aggiornato Aggrega — il comando del programma di installazione aggiorna il binario sul posto — esegui di nuovo lo stesso comando aggrega skills install per portare quella copia alla nuova versione.