Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Навичка Aggrega

Навичка Aggrega навчає AI-асистента встановлювати й використовувати Aggrega. Це тека з назвою aggrega, що містить файл SKILL.md у відкритому форматі Agent Skills, який багато асистентів читають із власної теки навичок і завантажують, коли ваш запит стосується Aggrega.

Є два способи надати навичку асистентові. Асистент, який встановлює плагіни, отримує її як частину плагіна Aggrega, що також підключає асистента до MCP-сервера Aggrega, за один крок: див. Встановлення плагіна. Для будь-якого асистента, який читає навички з теки, навичку туди може записати двійковий файл aggrega: див. Встановлення лише навички.

Встановлення плагіна

Репозиторій aggrega-ai/aggrega-skills містить навичку і водночас є плагіном для наведених нижче асистентів. Встановлення плагіна додає навичку Aggrega і підключає асистента до MCP-сервера Aggrega, який асистент потім сам запускає як aggrega mcp, тож для цього асистента не потрібні ні aggrega skills install, ні кроки з розділу Підключення сервера MCP.

Плагін не встановлює двійковий файл aggrega. Спершу встановіть його, як описано в розділі Встановлення двійкового файлу, щоб асистент знайшов aggrega у PATH, коли запускатиме сервер.

Claude Code

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

У самому Claude Code те саме робить команда /plugin install aggrega --marketplace aggrega-ai/aggrega-skills.

Codex

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

Перша команда додає репозиторій як маркетплейс плагінів з назвою aggrega; друга встановлює з нього плагін aggrega.

GitHub Copilot

У GitHub Copilot CLI:

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

Visual Studio Code з GitHub Copilot знаходить плагіни, встановлені GitHub Copilot CLI, і теж їх використовує. Щоб встановити плагін безпосередньо з Visual Studio Code, виконайте Chat: Install Plugin from Source з палітри команд і вкажіть адресу репозиторію, https://github.com/aggrega-ai/aggrega-skills.

Gemini CLI

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

Gemini CLI встановлює плагін як одне зі своїх розширень.

Antigravity

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

Cursor

Cursor завантажує плагін із теки всередині ~/.cursor/plugins/local/. Помістіть туди репозиторій, а потім виконайте Developer: Reload Window з палітри команд:

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

Kiro

Kiro встановлює плагін як power. На панелі Powers виберіть Add Custom Power, потім Import power from GitHub, введіть адресу репозиторію, https://github.com/aggrega-ai/aggrega-skills, і виберіть Install. Kiro запускає й зупиняє MCP-сервер плагіна разом із power.

OpenClaw

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

OpenClaw двічі запитує, перш ніж встановити плагін із джерела, яке він сам не перевірив. Спершу він зупиняється й просить вас переглянути джерело та знову виконати команду з --force; потім він просить вашої згоди на те, що приносить плагін, — тут навичку й MCP-сервер, — за допомогою --accept-capabilities. Переглянувши репозиторій, виконайте:

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

--force також замінює вже встановлений плагін з такою самою назвою, тож спершу перевірте openclaw plugins list, якщо раніше ви встановлювали плагін з назвою aggrega.

Тека, у якій працює сервер

Інструменти Aggrega працюють у робочому просторі, і на виклик, що не вказує жодного, відповідь надається в робочому просторі, який сервер знаходить, виходячи з теки, у якій його запущено. Деякі асистенти запускають сервер плагіна у власній теці плагіна, а не у вашому проєкті, — так робить Codex. Навичка велить асистентові, перш ніж працювати в проєкті, перевірити за допомогою інструмента config-show, у якому робочому просторі відповідає сервер, і там, де вони відрізняються, вказувати теку проєкту як workspace_root у кожному виклику, що його приймає, — повним шляхом, оскільки відносний workspace_root читається відносно робочого простору, у якому сервер уже відповідає.

Встановлення лише навички

Щоб встановити навичку без плагіна, скористайтеся двійковим файлом aggrega, який записує вбудовану в нього копію. Установіть її для асистентів на вашому комп’ютері в усіх ваших проєктах:

Terminal window
aggrega skills install --global

Установіть її для одного асистента в проєкті, у якому ви перебуваєте, назвавши асистента:

Terminal window
aggrega skills install --agent claude-code

Перелічіть асистентів, для яких її можна встановити, разом із текою, яку читає кожен із них:

Terminal window
aggrega skills list

Команда встановлення теж може додати її під час встановлення двійкового файлу: відповідний параметр наведено в розділі Додавання навички асистента під час встановлення. Встановлена в такий спосіб навичка не містить підключення до сервера: підключіть асистента до сервера, як описано в розділі Підключення сервера MCP.

Що навичка повідомляє вашому асистентові

Навичка пояснює асистентові, як установити Aggrega, як під’єднати його до сервера aggrega mcp, як почати робочий простір і як виконувати цикл створення — scaffold, validate, build, — описаний у розділі Створення файлів Aggrega. Вона не містить копії жодної схеми чи контракту сутності: по кожну структурну відповідь вона відсилає асистента до двійкового файлу — до інструментів MCP, коли сервер під’єднано, а інакше до командного рядка aggrega, — а щодо значення речей — до опублікованої документації.

Навичка і MCP-сервер виконують різні завдання, і асистент працює найкраще з обома. Навичка — це інструкції, які читає асистент; сервер, який під’єднує плагін або який під’єднують за розділом Під’єднання MCP-сервера, — це інструменти, які він викликає. Асистент, який не встановлює жодного плагіна і якого немає в списку --agent, пропускає навичку й однаково отримує доступ до тих самих інструментів і довідкових матеріалів через сервер.

Куди її встановлено

Плагін зберігає навичку в теці, у якій асистент зберігає свої плагіни. aggrega skills install записує її деінде: без --global — до проєктної теки навичок асистента в корені вашого робочого простору, де фіксуються навички проєкту; з --global — до користувацької теки навичок асистента у вашому домашньому каталозі, яку асистент читає в кожному проєкті. З --global і без --agent команда шукає асистентів на вашому комп’ютері, виводить кожного знайденого та те, за чим його знайдено, а в терміналі запитує перед записом. aggrega skills наводить теки для кожного асистента, те, за чим знаходять кожного з них, і те, що команда відмовляється перезаписувати.

Підтримання навички в актуальному стані

Навичка, що надійшла з плагіном, оновлюється разом із плагіном у той спосіб, у який асистент оновлює свої плагіни; плагін, клонований до локальної теки Cursor, оновлюється командою git pull у цій теці, після чого виконується Developer: Reload Window. Плагін підключає сервер, який запускає двійковий файл aggrega з вашого PATH, тож інструменти й довідкові матеріали відповідають встановленому у вас двійковому файлу.

Навичку також вбудовано в двійковий файл aggrega, тому копія, яку записує aggrega skills install, відповідає встановленій у вас версії. Після оновлення Aggrega — команда інсталятора оновлює двійковий файл на місці — знову виконайте ту саму команду aggrega skills install, щоб оновити цю копію до нової версії.