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

Umiejętność Aggrega

Umiejętność Aggrega uczy asystenta AI instalować Aggrega i z niego korzystać. Jest to folder o nazwie aggrega zawierający plik SKILL.md w otwartym formacie Agent Skills, który wielu asystentów odczytuje z własnego folderu umiejętności i wczytuje, gdy żądanie dotyczy Aggrega.

Umiejętność można przekazać asystentowi na dwa sposoby. Asystent, który instaluje wtyczki, otrzymuje ją jako część wtyczki Aggrega, która jednocześnie łączy asystenta z serwerem MCP Aggrega, w jednym kroku: zob. Instalacja wtyczki. W przypadku każdego asystenta, który odczytuje umiejętności z folderu, plik binarny aggrega może zapisać tam umiejętność: zob. Instalacja samej umiejętności.

Instalacja wtyczki

Repozytorium aggrega-ai/aggrega-skills zawiera umiejętność i jest też wtyczką dla wymienionych poniżej asystentów. Instalacja wtyczki dodaje umiejętność Aggrega i łączy asystenta z serwerem MCP Aggrega, który asystent następnie sam uruchamia jako aggrega mcp, więc dla tego asystenta nie są potrzebne ani aggrega skills install, ani kroki ze strony Połączenie z serwerem MCP.

Wtyczka nie instaluje pliku binarnego aggrega. Należy go najpierw zainstalować, jak opisuje sekcja Instalacja pliku binarnego, aby asystent znalazł aggrega w PATH podczas uruchamiania serwera.

Claude Code

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

W Claude Code to samo wykonuje polecenie /plugin install aggrega --marketplace aggrega-ai/aggrega-skills.

Codex

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

Pierwsze polecenie dodaje repozytorium jako marketplace wtyczek o nazwie aggrega; drugie instaluje z niego wtyczkę aggrega.

GitHub Copilot

W GitHub Copilot CLI:

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

Visual Studio Code z GitHub Copilot znajduje wtyczki zainstalowane przez GitHub Copilot CLI i również z nich korzysta. Aby zainstalować wtyczkę bezpośrednio z Visual Studio Code, należy uruchomić Chat: Install Plugin from Source z palety poleceń i podać adres repozytorium, https://github.com/aggrega-ai/aggrega-skills.

Gemini CLI

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

Gemini CLI instaluje wtyczkę jako jedno ze swoich rozszerzeń.

Antigravity

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

Cursor

Cursor wczytuje wtyczkę z folderu w ~/.cursor/plugins/local/. Należy umieścić tam repozytorium, a następnie uruchomić Developer: Reload Window z palety poleceń:

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

Kiro

Kiro instaluje wtyczkę jako power. W panelu Powers należy wybrać Add Custom Power, a następnie Import power from GitHub, wpisać adres repozytorium, https://github.com/aggrega-ai/aggrega-skills, i wybrać Install. Kiro uruchamia i zatrzymuje serwer MCP wtyczki razem z power.

OpenClaw

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

OpenClaw dwukrotnie pyta o zgodę, zanim zainstaluje wtyczkę ze źródła, którego sam nie zweryfikował. Najpierw zatrzymuje się i prosi o przejrzenie źródła oraz ponowne uruchomienie polecenia z --force; następnie prosi o zgodę na to, co wnosi wtyczka — tutaj umiejętność i serwer MCP — za pomocą --accept-capabilities. Po przejrzeniu repozytorium należy uruchomić:

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

--force zastępuje też zainstalowaną już wtyczkę o tej samej nazwie, dlatego jeśli wcześniej zainstalowano wtyczkę o nazwie aggrega, należy najpierw sprawdzić openclaw plugins list.

Folder, w którym pracuje serwer

Narzędzia Aggrega działają w obszarze roboczym, a wywołanie, które żadnego nie wskazuje, otrzymuje odpowiedź w obszarze roboczym, który serwer znajduje na podstawie folderu, w którym go uruchomiono. Niektórzy asystenci uruchamiają serwer wtyczki we własnym folderze wtyczki, a nie w projekcie — tak robi Codex. Umiejętność nakazuje asystentowi sprawdzić za pomocą narzędzia config-show, w którym obszarze roboczym odpowiada serwer, zanim zacznie pracę w projekcie, a gdy się one różnią, podawać folder projektu jako workspace_root w każdym wywołaniu, które go przyjmuje — pełną ścieżką, ponieważ względny workspace_root jest odczytywany względem obszaru roboczego, w którym serwer już odpowiada.

Instalacja samej umiejętności

Aby zainstalować umiejętność bez wtyczki, należy użyć pliku binarnego aggrega, który zapisuje wbudowaną w niego kopię. Instalacja dla asystentów na komputerze, we wszystkich projektach użytkownika:

Terminal window
aggrega skills install --global

Instalacja dla jednego asystenta w bieżącym projekcie, ze wskazaniem asystenta:

Terminal window
aggrega skills install --agent claude-code

Lista asystentów, dla których można ją zainstalować, wraz z folderem odczytywanym przez każdego z nich:

Terminal window
aggrega skills list

Polecenie instalacyjne również może ją dodać podczas instalacji pliku binarnego: odpowiednią opcję podaje sekcja Dodawanie umiejętności asystenta podczas instalacji. Zainstalowana w ten sposób umiejętność nie obejmuje połączenia z serwerem: należy połączyć asystenta z serwerem, jak opisuje strona Połączenie z serwerem MCP.

Co umiejętność przekazuje asystentowi

Umiejętność informuje asystenta, jak zainstalować Aggrega, jak połączyć go z serwerem aggrega mcp, jak rozpocząć obszar roboczy i jak prowadzić pętlę tworzenia — scaffold, validate, build — opisaną w sekcji Tworzenie plików Aggrega. Nie zawiera kopii żadnego schematu ani kontraktu encji: po każdą odpowiedź dotyczącą struktury odsyła asystenta do pliku binarnego — do narzędzi MCP, gdy serwer jest połączony, a w przeciwnym razie do wiersza poleceń aggrega — a po znaczenie poszczególnych elementów do opublikowanej dokumentacji.

Umiejętność i serwer MCP pełnią różne zadania, a asystent działa najlepiej z obydwoma. Umiejętność to instrukcje, które asystent czyta; serwer, podłączany przez wtyczkę lub zgodnie z sekcją Połączenie serwera MCP, to narzędzia, które asystent wywołuje. Asystent, który nie instaluje żadnej wtyczki i którego nie ma na liście --agent, pomija umiejętność, a mimo to dociera do tych samych narzędzi i materiałów referencyjnych przez serwer.

Gdzie jest instalowana

Wtyczka przechowuje umiejętność w folderze, w którym asystent przechowuje swoje wtyczki. aggrega skills install zapisuje ją gdzie indziej: bez --global — w projektowym folderze umiejętności asystenta w katalogu głównym obszaru roboczego, gdzie zatwierdzane są umiejętności projektu; z --global — w folderze umiejętności asystenta przypisanym do użytkownika w katalogu domowym, który asystent odczytuje w każdym projekcie. Z --global i bez --agent polecenie wyszukuje asystentów na komputerze, wypisuje każdego znalezionego asystenta oraz to, co go wykryło, a w terminalu pyta przed zapisem. aggrega skills podaje foldery każdego asystenta, to, co wykrywa każdego z nich, oraz to, czego polecenie odmawia nadpisania.

Utrzymywanie aktualności umiejętności

Umiejętność dostarczona z wtyczką jest aktualizowana razem z wtyczką, w sposób, w jaki asystent aktualizuje swoje wtyczki; wtyczkę sklonowaną do lokalnego folderu Cursor aktualizuje się poleceniem git pull w tym folderze, a następnie Developer: Reload Window. Wtyczka łączy serwer uruchamiany przez plik binarny aggrega z PATH, więc narzędzia i materiały referencyjne odpowiadają zainstalowanemu plikowi binarnemu.

Umiejętność jest też wbudowana w plik binarny aggrega, więc kopia zapisywana przez aggrega skills install odpowiada zainstalowanej wersji. Po aktualizacji Aggrega — polecenie instalatora aktualizuje plik binarny w miejscu — należy ponownie uruchomić to samo polecenie aggrega skills install, aby zaktualizować tę kopię do nowej wersji.