Plugin & Skill

Plugin

Apa Itu Plugin?

Plugin adalah modul TypeScript yang memperluas fungsionalitas Neotask saat runtime. Plugin dapat menambahkan saluran pesan baru, alat agen, metode RPC, perintah CLI, layanan latar belakang, dan skill.

Plugin Resmi

Saluran Pesan:

• Microsoft Teams, Matrix, Nostr, Zalo, Feishu/Lark, LINE, Nextcloud Talk, Mattermost, Tlon, Twitch

Fitur:

• Voice Call, Dukungan telepon SIP untuk panggilan suara masuk/keluar
• Memory (LanceDB), Memori jangka panjang dengan pencarian kesamaan vektor
• MCP Native, Integrasi server Model Context Protocol untuk menjembatani alat eksternal

Penyedia Auth:

• Google Antigravity OAuth, Gemini CLI OAuth, Qwen OAuth, Minimax OAuth, VS Code Copilot Proxy

Kemampuan Plugin

Plugin dapat mendaftarkan:

• Metode RPC, Metode WebSocket kustom untuk dipanggil oleh klien
• Handler HTTP, Endpoint HTTP kustom di Gateway
• Alat Agen, Alat baru dengan skema yang diketik yang dapat dipanggil agen
• Perintah CLI, Perintah baris perintah tambahan
• Layanan Latar Belakang, Proses yang berjalan lama yang dikelola oleh Gateway
• Skill, Direktori skill yang dibundel dengan plugin
• Perintah Auto-Reply, Perintah yang dieksekusi tanpa keterlibatan agen AI

Keamanan Plugin

Neotask memeriksa plugin dalam beberapa lapisan sebelum dijalankan:

• Ditandatangani dan diverifikasi. Paket di katalog publik Construct diterbitkan oleh Neotask, diperiksa secara otomatis sebelum dirilis, dan ditandatangani dengan kunci rilis Neotask. Sebelum menginstalnya, Neotask memeriksa tanda tangan dengan kunci yang tertanam di Neotask dan memverifikasi hash SHA-256 unduhan.
• Tanpa skrip instalasi. Paket Construct sudah menyertakan dependensinya, jadi instalasi tidak pernah menjalankan pengelola paket atau skrip instalasi. Saat instalasi plugin lain memakai npm, skrip instalasi dinonaktifkan.
• Dipindai saat instalasi. Plugin yang diinstal dari luar Construct dipindai untuk mencari kode berbahaya, dan temuan kritis memblokir instalasi.
• Lisensi per rilis. Plugin Construct hanya dimuat selama akun Anda memiliki izin yang berlaku untuk rilis tersebut. Rilis yang dicabut tidak dimuat.
• Persetujuan untuk tindakan agen. Panggilan alat oleh agen, termasuk alat yang ditambahkan plugin, diperiksa terhadap kebijakan persetujuan Anda, dan tindakan yang memerlukan persetujuan Anda akan menunggunya. Perangkat lunak yang ingin diinstal agen di luar resep instalasi bawaan Neotask selalu menampilkan perintah persisnya dan menunggu persetujuan Anda.
• Sandbox opsional. Anda dapat menjalankan alat agen di kontainer Docker yang terisolasi, bukan langsung di komputer Anda. Sandbox nonaktif secara default; lihat Keamanan untuk mengaktifkannya.

Plugin native berjalan di dalam proses Gateway, jadi plugin yang Anda instal dari luar Construct adalah kode yang Anda pilih untuk dijalankan. Gunakan plugins.allow untuk menentukan plugin yang boleh dimuat.

Skill

Apa Itu Skill?

Skill adalah kemampuan modular yang mengajarkan alur kerja baru kepada agen. Setiap skill adalah file markdown (SKILL.md) dengan instruksi yang diinjeksikan ke dalam konteks agen saat relevan.

Lokasi Skill (Urutan Prioritas)

1. Skill workspace, <workspace>/skills/ (prioritas tertinggi)
2. Skill yang dikelola, ~/.neotask/skills/
3. Skill bawaan, Dikirimkan bersama Neotask
4. Skill plugin, Skill yang dikemas dengan plugin yang diinstal
5. Direktori tambahan, Jalur yang dikonfigurasi tambahan (prioritas terendah)

Ketika beberapa skill memiliki nama yang sama, lokasi dengan prioritas tertinggi menang.

Fitur Skill

• Dapat dipanggil pengguna, Picu skill langsung dengan perintah slash (misalnya, /docker-build)
• Dapat dipanggil model, Skill yang dapat dipanggil agen sendiri saat relevan
• Pengiriman perintah, Skill yang memetakan ke alat tertentu
• Pembatasan persyaratan, Skill hanya dimuat ketika persyaratannya terpenuhi (binari yang diperlukan, kunci konfigurasi, variabel lingkungan, plugin)

Membuat Skill

Buat file SKILL.md dengan frontmatter YAML yang mendefinisikan metadata dan instruksi skill:

Bidang frontmatter:

• name, Pengenal skill
• description, Apa yang dilakukan skill
• homepage, Tautan ke dokumentasi
• user-invocable, Apakah pengguna dapat memicunya secara langsung
• disable-model-invocation, Mencegah agen memanggilnya secara otonom
• command-dispatch, Alat untuk mengiriman ke
• metadata.neotask.requires, Prasyarat (bins, config, env, plugins)

Isi: Instruksi Markdown yang mengajarkan agen cara menggunakan skill, termasuk contoh dan panduan.

Katalog Skill

Jelajahi skill yang tersedia di katalog skill.

Kategori Skill

Skill mencakup berbagai kemampuan: