Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

aggrega skills

Instalowanie umiejętności Aggrega w asystencie AI

Składnia

aggrega skills

Opis

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.

Podpolecenia

PolecenieOpis
aggrega skills installZapisuje umiejętność Aggrega do folderu umiejętności asystenta AI
aggrega skills listWyświetla umiejętności dostarczane z tym plikiem binarnym oraz asystentów, dla których można je zainstalować

Opis 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.

Flagi aggrega skills install

FlagaDomyślnieOpis
--agent[]Asystent, dla którego należy zainstalować umiejętność, według identyfikatora (na przykład claude-code, codex, cursor lub gemini-cli). Można powtarzać; pomoc wymienia każdy identyfikator i folder, do którego każdy z nich zapisuje. Wymagane bez —global; z —global i bez podanego asystenta umiejętność jest instalowana dla asystentów znalezionych na tej maszynie.
--globalfalseInstaluje do folderu umiejętności użytkownika każdego asystenta w katalogu domowym, który asystent czyta w każdym projekcie, zamiast do folderu umiejętności projektu w katalogu głównym obszaru roboczego.

Opis 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.

Działanie

aggrega skills install zapisuje umiejętność Aggrega do folderu umiejętności każdego asystenta AI wskazanego za pomocą --agent lub, z --global i bez --agent, każdego asystenta znalezionego na tej maszynie. Umiejętność to folder zawierający plik SKILL.md w otwartym formacie Agent Skills: krótki blok frontmatter, który podaje nazwę umiejętności i mówi, kiedy jej używać, a po nim instrukcje. Asystent, który czyta umiejętności, ładuje ją, gdy żądanie do niej pasuje, dzięki czemu wie, jak zainstalować Aggrega, jak połączyć się z aggrega mcp, jak rozpocząć obszar roboczy i jak przeprowadzić pętlę tworzenia opisaną na stronie Tworzenie plików Aggrega.

Umiejętność nie zawiera kopii żadnego schematu ani kontraktu encji. Każe asystentowi pytać plik binarny o każdą odpowiedź strukturalną — przez narzędzia MCP, gdy serwer jest połączony, a w przeciwnym razie przez wiersz poleceń aggrega — i czytać opublikowaną dokumentację, aby poznać znaczenie poszczególnych elementów. Umiejętność jest wbudowana w plik binarny, więc zapisywana kopia odpowiada zainstalowanej wersji.

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

Gdzie trafia umiejętność

Bez --global umiejętność trafia do folderu umiejętności projektu asystenta w katalogu głównym obszaru roboczego, gdzie asystent szuka umiejętności projektu i gdzie zatwierdza się je w repozytorium. Obszar roboczy to ten, który znajduje każde polecenie — wskazany przez --workspace-root lub znaleziony od katalogu, w którym uruchamia się polecenie, więc uruchomienie go z podfolderu nadal instaluje w katalogu głównym — a katalog, którego nie oznacza żaden obszar roboczy, jest własnym katalogiem głównym. Z --global trafia do folderu umiejętności użytkownika asystenta w katalogu domowym, który asystent czyta w każdym projekcie. Tabela w opisie powyżej podaje oba foldery dla każdego asystenta; każdy to folder wskazany w dokumentacji danego asystenta, a ~ oznacza katalog domowy.

Kilku asystentów czyta wspólny folder .agents/skills. Wskazanie więcej niż jednego z nich zapisuje umiejętność tam raz i wymienia ich wszystkich w jednym wierszu, który to zgłasza:

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

Asystenci na tej maszynie

Z --global i bez --agent polecenie instaluje umiejętność dla asystentów, których znajdzie na tej maszynie. Asystent jest uznawany za znaleziony, gdy jego własny folder konfiguracji znajduje się w katalogu domowym albo jego polecenie jest w PATH; kolumna found by tabeli w powyższym opisie podaje oba dla każdego asystenta. Folder lub polecenie jest używane tylko tam, gdzie należy wyłącznie do danego asystenta, więc jego znalezienie nigdy nie oznacza innego: współdzielony folder .agents/skills nie znajduje nikogo, a .gemini, w którym pliki przechowują zarówno Gemini CLI, jak i Antigravity, nie znajduje żadnego z nich — Gemini CLI jest znajdowany po poleceniu gemini, a każdy produkt Antigravity po własnym folderze w .gemini. Asystenta, którego konfiguracja znajduje się w innym miejscu systemu, znajduje się po jego poleceniu albo wskazuje za pomocą --agent.

Polecenie wypisuje każdego znalezionego asystenta i to, po czym go znalazło, a następnie instaluje:

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

W terminalu najpierw pyta. Po wierszach wskazujących, co znalazło, prosi o potwierdzenie: naciśnięcie Enter instaluje dla tych asystentów, a wpisanie identyfikatorów innych asystentów, rozdzielonych spacjami lub przecinkami, dodaje ich. Jeśli nie znalazło żadnego, pyta zamiast tego o identyfikatory, a pusta odpowiedź niczego nie zapisuje. Gdy standardowe wejście nie jest terminalem — w skrypcie, u asystenta uruchamiającego polecenie w imieniu użytkownika albo we własnym narzędziu asystenta do tego celu — o nic nie pyta i instaluje dla znalezionych asystentów. Gdy nie znajdzie żadnego i żaden nie zostanie podany, niczego nie zapisuje, informuje o tym i kończy działanie z niezerowym kodem.

Podanie dowolnego --agent pomija wyszukiwanie: polecenie instaluje dla wskazanych asystentów i żadnych innych. Instalacja w projekcie, bez --global, zawsze ich wskazuje: jest przeznaczona dla asystentów, których używają osoby pracujące nad projektem, a tego ta maszyna nie mówi.

Ponowna instalacja i czego polecenie odmawia

Każdy plik zapisywany przez polecenie zawiera jeden wiersz komentarza, tuż po frontmatter, mówiący, że pochodzi z umiejętności wbudowanej w plik binarny aggrega i że ponowna instalacja go zastąpi. Po tym wierszu polecenie odróżnia własną kopię od kopii użytkownika:

  • Kopia zawierająca ten wiersz jest zastępowana. Ponowne uruchomienie polecenia po aktualizacji Aggrega podnosi umiejętność do nowej wersji, a wypisywany wiersz mówi Replaced zamiast Installed.
  • Plik bez tego wiersza jest odrzucany. SKILL.md znajdujący się już w miejscu docelowym, którego polecenie nie zapisało, należy do użytkownika, więc polecenie podaje jego ścieżkę, niczego nigdzie nie zapisuje i kończy działanie z kodem niezerowym. Należy przenieść plik w inne miejsce lub go usunąć, a następnie ponownie uruchomić polecenie. Aby zachować własne zmiany, należy trzymać je w umiejętności o innej nazwie.
  • Folder osiągany przez dowiązanie prowadzące poza obszar roboczy jest odrzucany. Bez --global każdy folder i plik, które polecenie zapisałoby, muszą pozostać w obszarze roboczym: gdy folder umiejętności asystenta albo folder na drodze do niego jest dowiązaniem prowadzącym poza obszar roboczy, polecenie wskazuje dowiązanie i miejsce, do którego prowadzi, niczego nigdzie nie zapisuje i kończy działanie z kodem niezerowym — jest to warunek opisany w A path the operation writes leads through a link out of the directory it must stay inside (Ścieżka zapisywana przez operację prowadzi przez dowiązanie poza katalog, w którym musi pozostać). Przez dowiązanie pozostające w obszarze roboczym zapis jest wykonywany.

Każde miejsce docelowe jest sprawdzane, zanim cokolwiek zostanie zapisane, więc odmowa dla jednego asystenta pozostawia także foldery wszystkich pozostałych asystentów bez zmian. Pliki w folderze umiejętności, których umiejętność nie zapisuje, pozostają nietknięte.

Nieznani asystenci

--agent przyjmuje tylko identyfikatory z tabeli powyżej; każdy z nich to identyfikator, którego otwarte narzędzie wiersza poleceń do umiejętności używa dla tego samego asystenta. Każdy inny identyfikator jest odrzucany z podaniem jego nazwy i listy znanych identyfikatorów. Asystent, którego nie ma na liście, nadal może korzystać z Aggrega: należy połączyć go z serwerem MCP, jak opisuje strona Podłączanie serwera MCP, a uzyska dostęp do tych samych narzędzi i materiałów referencyjnych, na które wskazuje umiejętność.

Przykłady

Instalacja umiejętności dla Claude Code w tym projekcie:

Terminal window
aggrega skills install --agent claude-code

Instalacja dla Gemini CLI i Cursor we wszystkich własnych projektach:

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

Instalacja we wszystkich własnych projektach dla asystentów na tej maszynie:

Terminal window
aggrega skills install --global

Aktualizacja zainstalowanej kopii do pliku binarnego, do którego właśnie dokonano aktualizacji:

Terminal window
aggrega skills install --agent claude-code

Wyświetlanie tego, co zna

aggrega skills list wypisuje umiejętności wbudowane w ten plik binarny wraz z ich opisami, a następnie każdego asystenta znanego aggrega skills install wraz z jego folderem projektu i folderem użytkownika. Niczego nie zapisuje.

Terminal window
aggrega skills list