Menyiapkan Aggrega dengan asisten AI Anda
Asisten AI yang dapat menjalankan perintah di mesin Anda — agen pemrograman di terminal atau editor Anda — dapat menyiapkan Aggrega untuk Anda: memasang biner aggrega, menambahkan skill Aggrega ke dirinya sendiri, dan menghubungkan dirinya ke server MCP Aggrega. Asisten yang memasang plugin melakukan dua langkah terakhir sekaligus, dengan memasang plugin Aggrega; asisten lainnya menambahkan skill dan menghubungkan server satu per satu. Tempelkan prompt di bawah ini ke asisten tersebut, dan asisten akan menjalankan langkah-langkah itu; prompt tersebut memintanya untuk mengonfirmasi kepada Anda sebelum memasang apa pun.
Setelah selesai, asisten memiliki dua cara untuk bekerja dengan Aggrega. Skill adalah folder berisi file SKILL.md yang dimuat asisten ketika permintaan Anda berkaitan dengan Aggrega: skill memberi tahu asisten bagaimana siklus penulisan berjalan dan memintanya mengambil setiap jawaban tentang skema atau file dari biner, bukan dari ingatan. Server MCP, aggrega mcp, memberinya alat-alat Aggrega — scaffold, validate, build, dan lainnya — beserta materi referensi yang menjadi dasar kerja alat-alat tersebut. Skill Aggrega menjelaskan skill dan plugin tersebut, Menghubungkan server MCP menjelaskan servernya, dan Apa yang dapat dilakukan asisten Anda dengan Aggrega menjelaskan apa yang dapat dijangkau asisten melaluinya.
Setelah disiapkan, Memulai, setiap panduan langkah demi langkah di bawah Impor, dan halaman setiap contoh yang dapat dijalankan yang di-build dengan Aggrega memberikan tugas yang diajarkannya sebagai prompt untuk ditempelkan ke asisten, di samping perintah-perintahnya.
Prompt
Siapkan Aggrega untuk saya, satu langkah demi satu langkah, dan beri tahu saya apa yang Anda jalankan di setiap langkah.
1. Jalankan `aggrega version`. Jika perintah tidak ditemukan, tanyakan kepada saya sebelum Anda memasang Aggrega, lalu pasang untuk pengguna saya dengan penginstal resmi: di Linux atau macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, di Windows dalam PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Jalankan `aggrega version` lagi. Jika penginstal mencetak baris untuk ditambahkan ke `PATH` saya, tunjukkan baris itu kepada saya.2. Jika `https://aggrega.ai/docs/ai-assistants/skill/` memberikan cara untuk memasang plugin Aggrega di dalam diri Anda, tanyakan kepada saya sebelum memasangnya, lalu pasang dengan cara itu, atau beri tahu saya apa yang harus dilakukan jika itu adalah langkah yang saya lakukan di antarmuka Anda. Plugin tersebut menambahkan skill Aggrega dan menghubungkan Anda ke server MCP Aggrega. Jika tidak, jalankan `aggrega skills install --help` dan temukan pengidentifikasi Anda sendiri dalam daftar yang dicetaknya. Tanyakan kepada saya apakah saya ingin skill itu di proyek ini atau di setiap proyek, lalu jalankan `aggrega skills install --agent <your identifier>`, dengan menambahkan `--global` untuk setiap proyek. Jika Anda tidak ada dalam daftar, lewati pemasangan skill dan sampaikan hal itu.3. Jika Anda memasang plugin, Anda sudah terhubung ke server MCP Aggrega. Jika tidak, hubungkan diri Anda ke server MCP Aggrega, yaitu perintah `aggrega mcp`, dengan cara Anda menambahkan server MCP, seperti yang dijelaskan `https://aggrega.ai/docs/ai-assistants/mcp-server/` untuk Anda. Jika Anda memerlukan mulai ulang atau muat ulang untuk memuat plugin atau server, beri tahu saya apa yang harus dilakukan.4. Setelah Anda terhubung, panggil tool `describe-capabilities` tanpa argumen dan rangkum apa yang dicantumkannya.Prompt ini sama di setiap bahasa tempat dokumentasi diterbitkan: hanya kalimat-kalimatnya yang diterjemahkan, dan setiap perintah, flag, alamat, dan nama tool di dalamnya tetap persis seperti yang tertulis, sehingga asisten membaca instruksi yang sama dari bahasa mana pun Anda menyalinnya.
Penginstal mengunduh rilis terbaru, memeriksanya terhadap digest SHA-256 yang diterbitkan untuk rilis tersebut, dan memasangnya hanya untuk pengguna Anda, tanpa hak administrator; Memasang biner menjelaskan apa yang dilakukannya dan cara memasang secara manual sebagai gantinya.
Apa yang berbeda dari satu asisten ke asisten lain
Tiga bagian prompt bergantung pada asisten: cara asisten memasang plugin Aggrega, jika asisten memasang plugin; jika tidak, pengidentifikasi yang diteruskannya ke --agent saat memasang skill, dan cara asisten menambahkan server. Asisten menentukan semuanya dari prompt, tetapi jika Anda mengetahuinya, Anda dapat menuliskannya ke dalam prompt.
| Asisten | Memasang plugin | Memasang skill tanpa plugin |
|---|---|---|
| Claude Code | claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills | aggrega skills install --agent claude-code |
| Codex | codex plugin marketplace add aggrega-ai/aggrega-skills, lalu codex plugin add aggrega@aggrega | aggrega skills install --agent codex |
| GitHub Copilot CLI | copilot plugin marketplace add aggrega-ai/aggrega-skills, lalu copilot plugin install aggrega@aggrega | aggrega skills install --agent github-copilot |
| Gemini CLI | gemini extensions install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent gemini-cli |
| Antigravity | agy plugin install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent antigravity, atau --agent antigravity-cli untuk Antigravity CLI |
| Cursor | git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega, lalu Developer: Reload Window | aggrega skills install --agent cursor |
Visual Studio Code dengan GitHub Copilot, Kiro, dan OpenClaw juga memasang plugin; Memasang plugin memberikan caranya untuk setiap asisten, serta apa yang ditanyakan OpenClaw sebelum memasang. Pengidentifikasi yang diterima --agent, dan folder yang ditulis masing-masing, tercantum di aggrega skills dan dicetak oleh aggrega skills install --help. Cara setiap asisten menambahkan server — dengan perintahnya sendiri, atau dengan entri di pengaturannya atau di file daftar server — ada di Menghubungkan server MCP, untuk setiap klien.
Ketika sebagian prompt tidak berlaku
- Asisten yang memasang plugin melewati langkah menghubungkan server: plugin sudah menghubungkannya. Plugin tidak memasang biner, sehingga langkah 1 tetap berlaku. Jika asisten menjalankan server plugin di luar proyek Anda — Codex menjalankannya di folder milik plugin itu sendiri — skill memintanya untuk menyebutkan folder proyek Anda kepada server, seperti yang dijelaskan di Folder tempat server bekerja.
- Asisten yang tidak memasang plugin apa pun dan tidak ada dalam daftar
--agentmelewati pemasangan skill. Asisten tersebut tetap dapat menjangkau alat-alat Aggrega melalui server MCP setelah terhubung, dan server memberinya panduan sendiri saat terhubung. - Asisten yang tidak dapat menjalankan perintah — aplikasi obrolan tanpa akses ke terminal Anda — tidak dapat mengikuti prompt. Pasang biner seperti yang dijelaskan di Instalasi, dan hubungkan aplikasi tersebut sendiri seperti yang dijelaskan di Menghubungkan server MCP. Untuk Claude Desktop, lihat Claude Desktop di bawah.
- Server yang dijalankan orang lain untuk Anda, yang dijangkau melalui HTTPS, tidak memerlukan biner, plugin, maupun skill. Berikan alamatnya kepada klien asisten sebagai gantinya, seperti yang dijelaskan di Server yang dijangkau melalui HTTPS.
Claude Desktop
Claude Desktop terhubung ke Aggrega melalui paket ekstensi yang disertakan di setiap rilis, dan paket itu menjalankan aggrega yang terpasang di komputer Anda. Siapkan keduanya sendiri di komputer Anda:
- Pasang
aggregadi PowerShell pada Windows denganirm https://aggrega.ai/install.ps1 | iex, atau di terminal pada macOS atau Linux dengancurl -fsSL https://aggrega.ai/install.sh | sh. Memasang biner menjelaskan apa yang dilakukan penginstal. - Pasang paket ekstensi, atur Workspace folder-nya, lalu mulai ulang Claude Desktop, seperti yang dijelaskan Claude Desktop di halaman Menghubungkan server MCP.
Sesi Claude Desktop dapat menjalankan perintahnya di kontainer cloud alih-alih di komputer Anda, sehingga prompt di atas, jika ditempelkan ke sesi itu, bekerja pada kontainer. Di sana, aggrega dapat dipasang dan dijalankan dari shell sesi setelah kebijakan jaringan kontainer mengizinkan aggrega.ai — pemilik organisasi mengizinkannya di pengaturan akses jaringan organisasi. Server MCP Aggrega tidak terhubung di sana: Claude Desktop menambahkan server lokal hanya dari pengaturan ekstensinya, dan ekstensi menjalankan aggrega di komputer Anda, bukan yang ada di kontainer.
aggrega skills install tidak memiliki entri Claude Desktop, sehingga sesi Claude Desktop melewati pemasangan skill. Sesi tersebut menjangkau alat-alat Aggrega melalui server MCP setelah ekstensi dipasang, dan server memberinya panduan sendiri saat terhubung.