Apa itu skill
Skill adalah folder yang namanya sama dengan name skill. Folder itu berisi file SKILL.md dan, secara opsional, file lain yang dirujuk instruksinya: dokumen referensi, templat, atau skrip.
SKILL.md memiliki dua bagian. Frontmatter YAML di antara baris --- memuat nama dan deskripsi. Isi Markdown setelahnya memuat instruksi.
Cara karyawan menggunakan skill
Karyawan bekerja dengan skill dalam tiga langkah.
- Pilih. Setiap giliran, karyawan melihat daftar skill yang tersedia baginya: nama setiap skill, deskripsinya, dan hingga tiga pemicunya. Deskripsi adalah yang dibaca karyawan untuk memutuskan, jadi tulislah untuk menjelaskan apa fungsi skill dan kapan menggunakannya.
- Muat. Karyawan memanggil alat
use_skilldengan nama skill. Alat itu mengembalikan instruksi, path folder skill, dan nama file-filenya. Inilah satu-satunya cara karyawan membaca skill. - Kerjakan. Karyawan mengikuti instruksi. Ia membaca file pendukung dengan
read_skill_filedan menjalankan skrip bawaan denganexecute.
Pemicu tidak pernah memuat skill dengan sendirinya. Karyawan selalu yang menentukan pilihan. Saat daftarnya panjang, karyawan dapat mencarinya dengan find_skills.
Tulis skill pertama Anda
Buat folder yang dinamai sesuai skill, dengan satu file di dalamnya.
meeting-notes/ └── SKILL.md
--- name: meeting-notes description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript. --- # Meeting notes 1. List the decisions that were made. 2. List action items as "owner — task — due date". 3. List open questions that need a follow-up. Keep each list short. If the transcript names no owner for an item, write "unassigned".
Letakkan folder itu di direktori skill pengguna sebuah bot (lihat Tempat skill disimpan). Nebo mendeteksi folder baru dalam sekitar satu detik, dan setiap karyawan di bot tersebut dapat menggunakan skill itu.
Karyawan juga dapat menulis skill untuk Anda. Minta ia menyimpannya, dan ia memanggil save_skill, yang menulis folder ke direktori skill pengguna yang sama.
Aturan yang diberlakukan pemuat
Skill yang melanggar salah satu aturan ini tidak dimuat. Nebo mencatat peringatan dan melewatinya.
| Aturan | Detail |
|---|---|
File diawali --- | Frontmatter harus menjadi hal pertama di file. File harus berformat UTF-8. |
name wajib | Hanya huruf kecil, angka, dan tanda hubung; tanpa tanda hubung di awal atau akhir; tanpa tanda hubung ganda; paling banyak 64 byte. |
description wajib | Paling banyak 1.024 byte. |
| Kolom memiliki tipe yang benar | Kolom dengan tipe YAML yang salah menggagalkan seluruh file. Beri tanda kutip pada versi, seperti "1.0.0". |
platform cocok | Jika ada, skill hanya dimuat di sistem operasi yang tercantum. |
Kunci frontmatter yang tidak dikenali Nebo diabaikan. Isi tidak memiliki batas ukuran, tetapi instruksi yang lebih singkat menyisakan lebih banyak ruang untuk pekerjaan. Pindahkan materi panjang ke file yang dibaca karyawan saat membutuhkannya.
Tambahkan file
File apa pun di folder selain SKILL.md dan dotfile tersedia bagi karyawan. Nama folder bebas Anda tentukan; Nebo tidak memberi arti khusus pada references/ atau assets/. File di bawah scripts/ atau bin/ dapat dijalankan.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Rujuk file berdasarkan path-nya di dalam folder, seperti references/policy.md. Karyawan membacanya dengan read_skill_file, yang menolak path apa pun yang keluar dari folder. Skrip berjalan dengan alat execute di dalam sandbox. Referensi SKILL.md membahas runtime, variabel lingkungan, rahasia, dan akses jaringan.
Tempat skill disimpan
Bot mengumpulkan skill dari beberapa tempat. Jika dua sumber menyediakan skill dengan nama yang sama, sumber yang lebih akhir di daftar ini yang berlaku.
| Sumber | Lokasi | Siapa yang dapat menggunakannya |
|---|---|---|
| Bawaan | Dikompilasi ke dalam Nebo | Setiap karyawan |
| Marketplace | <data>/nebo/skills/<slug>/<version>/ | Setiap karyawan |
| Plugin | Folder skills/ dari plugin yang terinstal | Setiap karyawan |
| Pengguna | <data>/user/skills/<name>/ | Setiap karyawan |
| Paket karyawan | skills/ di dalam paket karyawan yang terinstal | Hanya karyawan itu |
| Dipelajari | <data>/learned/skills/<employee>/<name>/ | Hanya karyawan itu |
<data> adalah ~/Library/Application Support/Nebo di macOS, %APPDATA%\Nebo di Windows, dan ~/.local/share/nebo di Linux. Variabel lingkungan NEBO_HOME menggantikannya. Jika karyawan memiliki skill sendiri dan skill bersama dengan nama yang sama, skill miliknya sendiri yang berlaku.
Nebo memantau folder-folder ini dan memuat ulang skill yang berubah setelah satu detik. Untuk menonaktifkan skill tanpa menghapusnya, ganti nama file-nya menjadi SKILL.md.disabled.
Skill menjelaskan pekerjaan, bukan alat. Tulis skill berdasarkan suatu tanggung jawab, seperti merekonsiliasi tanda terima, dan biarkan karyawan menggunakan koneksi apa pun yang disediakan pemilik. Jika skill benar-benar membutuhkan plugin, nyatakan dengan kolom plugins.
Berikutnya
- Referensi SKILL.md: setiap kolom, alat, dan variabel.
- Contoh: skill lengkap untuk disalin.
- Penerbitan: tampilkan skill di marketplace.