NeboAI
NeboAI
Mulakan

Kemahiran

Kemahiran mengajar pekerja cara melakukan satu jenis kerja dengan baik. Anda menulisnya sebagai folder dengan fail SKILL.md: perihalan ringkas yang digunakan pekerja untuk memilih kemahiran, dan arahan yang diikutinya sebaik sahaja kemahiran dimuatkan. Kemahiran tidak memerlukan kod, dan setiap pekerja pada bot boleh menggunakannya.

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.

  1. 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.
  2. Muatkan. Pekerja memanggil alat use_skill dengan nama kemahiran. Alat itu mengembalikan arahan, laluan folder kemahiran, dan nama failnya. Inilah satu-satunya cara pekerja membaca kemahiran.
  3. Bekerja. Pekerja mengikut arahan. Ia membaca fail sokongan dengan read_skill_file dan menjalankan skrip terbungkus dengan execute.

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.

PeraturanButiran
Fail bermula dengan ---Frontmatter mestilah perkara pertama dalam fail. Fail mestilah UTF-8.
name adalah wajibHuruf kecil, digit dan tanda sempang sahaja; tiada tanda sempang di awal atau di akhir; tiada tanda sempang berganda; paling banyak 64 bait.
description adalah wajibPaling banyak 1,024 bait.
Medan mempunyai jenis yang betulMedan dengan jenis YAML yang salah menggagalkan keseluruhan fail. Letakkan versi dalam tanda petik, seperti "1.0.0".
platform sepadanJika 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.

SumberLokasiSiapa boleh menggunakannya
Terbina dalamDikompil ke dalam NeboSetiap pekerja
Pasaran<data>/nebo/skills/<slug>/<version>/Setiap pekerja
PluginFolder skills/ bagi plugin yang dipasangSetiap pekerja
Pengguna<data>/user/skills/<name>/Setiap pekerja
Pakej pekerjaskills/ di dalam pakej pekerja yang dipasangPekerja 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