Apakah kemahiran
Kemahiran ialah folder yang namanya sepadan dengan name kemahiran itu. Folder itu mengandungi fail SKILL.md dan, secara pilihan, sebarang fail lain yang dirujuk oleh arahan: dokumen rujukan, templat atau skrip.
SKILL.md mempunyai dua bahagian. Frontmatter YAML di antara baris --- membawa nama dan perihalan. Badan Markdown selepasnya membawa arahan.
Cara pekerja menggunakan kemahiran
Pekerja menggunakan kemahiran dalam tiga langkah.
- Pilih. Setiap giliran, pekerja melihat senarai kemahiran yang tersedia kepadanya: nama setiap kemahiran, perihalannya, dan sehingga tiga pencetusnya. Perihalan ialah apa yang dibaca oleh pekerja untuk membuat keputusan, jadi tulis ia untuk menyatakan apa yang dilakukan oleh kemahiran dan bila menggunakannya.
- Muatkan. Pekerja memanggil alat
use_skilldengan nama kemahiran. Alat itu mengembalikan arahan, laluan folder kemahiran, dan nama failnya. Inilah satu-satunya cara pekerja membaca kemahiran. - Bekerja. Pekerja mengikut arahan. Ia membaca fail sokongan dengan
read_skill_filedan menjalankan skrip terbungkus denganexecute.
Pencetus tidak pernah memuatkan kemahiran dengan sendirinya. Pekerja sentiasa membuat pilihan. Apabila senarai menjadi panjang, pekerja boleh mencarinya dengan find_skills.
Tulis kemahiran pertama anda
Cipta folder yang dinamakan sempena kemahiran, dengan satu fail 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 dalam direktori kemahiran pengguna sesebuah bot (lihat Tempat kemahiran disimpan). Nebo menyedari folder baharu dalam kira-kira satu saat, dan setiap pekerja pada bot itu boleh menggunakan kemahiran tersebut.
Pekerja juga boleh menulis kemahiran untuk anda. Minta ia menyimpan satu, dan ia memanggil save_skill, yang menulis folder ke dalam direktori kemahiran pengguna yang sama.
Peraturan yang dikuatkuasakan oleh pemuat
Kemahiran yang melanggar salah satu peraturan ini tidak dimuatkan. Nebo mencatat amaran dan melangkaunya.
| Peraturan | Butiran |
|---|---|
Fail bermula dengan --- | Frontmatter mestilah perkara pertama dalam fail. Fail mestilah UTF-8. |
name adalah wajib | Huruf kecil, digit dan tanda sempang sahaja; tiada tanda sempang di awal atau di akhir; tiada tanda sempang berganda; paling banyak 64 bait. |
description adalah wajib | Paling banyak 1,024 bait. |
| Medan mempunyai jenis yang betul | Medan dengan jenis YAML yang salah menggagalkan keseluruhan fail. Letakkan versi dalam tanda petik, seperti "1.0.0". |
platform sepadan | Jika ada, kemahiran hanya dimuatkan pada sistem pengendalian yang disenaraikan. |
Kunci frontmatter yang tidak dikenali oleh Nebo diabaikan. Badan tiada had saiz, tetapi arahan yang lebih pendek memberi lebih ruang untuk kerja. Pindahkan bahan panjang ke dalam fail yang dibaca oleh pekerja apabila ia memerlukannya.
Tambah fail
Sebarang fail dalam folder selain SKILL.md dan fail bertitik tersedia kepada pekerja. Nama folder terpulang kepada anda; Nebo tidak memberi makna khas kepada references/ atau assets/. Fail di bawah scripts/ atau bin/ boleh dijalankan.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Rujuk fail mengikut laluannya di dalam folder, seperti references/policy.md. Pekerja membacanya dengan read_skill_file, yang menolak sebarang laluan yang keluar dari folder. Skrip berjalan dengan alat execute dalam kotak pasir. Rujukan SKILL.md merangkumi masa jalan, pemboleh ubah persekitaran, rahsia dan akses rangkaian.
Tempat kemahiran disimpan
Bot mengumpul kemahiran dari beberapa tempat. Apabila dua sumber menyediakan kemahiran dengan nama yang sama, sumber yang lebih kemudian dalam senarai ini diutamakan.
| Sumber | Lokasi | Siapa boleh menggunakannya |
|---|---|---|
| Terbina dalam | Dikompil ke dalam Nebo | Setiap pekerja |
| Pasaran | <data>/nebo/skills/<slug>/<version>/ | Setiap pekerja |
| Plugin | Folder skills/ bagi plugin yang dipasang | Setiap pekerja |
| Pengguna | <data>/user/skills/<name>/ | Setiap pekerja |
| Pakej pekerja | skills/ di dalam pakej pekerja yang dipasang | Pekerja itu sahaja |
| Dipelajari | <data>/learned/skills/<employee>/<name>/ | Pekerja itu sahaja |
<data> ialah ~/Library/Application Support/Nebo pada macOS, %APPDATA%\Nebo pada Windows, dan ~/.local/share/nebo pada Linux. Pemboleh ubah persekitaran NEBO_HOME mengatasinya. Apabila pekerja mempunyai kemahirannya sendiri dan kemahiran dikongsi dengan nama yang sama, kemahirannya sendiri diutamakan.
Nebo memerhatikan folder ini dan memuatkan semula kemahiran yang diubah selepas satu saat. Untuk mematikan kemahiran tanpa memadamnya, namakan semula failnya kepada SKILL.md.disabled.
Kemahiran menerangkan kerja, bukan alat. Tulis kemahiran berdasarkan tanggungjawab, seperti menyelaraskan resit, dan biarkan pekerja menggunakan apa jua sambungan yang disediakan oleh pemilik. Apabila kemahiran benar-benar memerlukan plugin, isytiharkannya dengan medan plugins.
Seterusnya
- Rujukan SKILL.md: setiap medan, alat dan pemboleh ubah.
- Contoh: kemahiran lengkap untuk disalin.
- Penerbitan: letakkan kemahiran di pasaran.