Format fail
SKILL.md ialah teks UTF-8. Ia bermula dengan baris tiga tanda sempang, kemudian frontmatter YAML, kemudian baris penutup tiga tanda sempang. Semua yang selepas itu ialah badan: arahan Markdown yang diterima oleh pekerja apabila ia memuatkan kemahiran. Nebo mencari fail mengikut nama tanpa mengira huruf besar atau kecil.
---
name: expense-review
description: Check submitted expenses against the company policy and flag anything that needs a receipt or an approval. Use when someone asks to review expenses or a reimbursement request.
version: "1.2.0"
author: Example Co
license: MIT
tags: [finance, expenses]
triggers: [reimbursement, expense report]
platform: [macos, linux, windows]
capabilities: [network]
metadata:
allowed_domains: [api.example.com]
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true
requires:
- name: receipt-capture
version: ">=1.0.0"
plugins:
- name: example-ledger
version: ">=2.0.0"
optional: true
---
# Expense review
Follow the policy in references/policy.md ... Medan frontmatter
Hanya name dan description yang wajib. Medan dengan jenis yang salah menggagalkan keseluruhan fail, jadi kemahiran tidak dimuatkan. Kunci yang tidak disenaraikan di sini diabaikan.
| Medan | Jenis | Lalai | Maksud |
|---|---|---|---|
name | string | wajib | Pengecam. [a-z0-9-], tiada tanda sempang di awal, di akhir atau berganda, paling banyak 64 bait. Padankan dengan nama folder. |
description | string | wajib | Apa yang dilakukan oleh kemahiran dan bila menggunakannya. Paling banyak 1,024 bait. Dipaparkan dalam senarai kemahiran pekerja dan diberi skor oleh find_skills. |
version | string | "1.0.0" | Versi semantik. Disemak oleh julat requires kemahiran lain. Letakkan dalam tanda petik. |
triggers | senarai rentetan | [] | Perkataan dan frasa yang menerangkan bila kemahiran itu berkenaan. Sehingga tiga muncul dalam senarai kemahiran; semuanya dikira dalam find_skills. Ia tidak pernah memuatkan kemahiran dengan sendirinya. |
platform | senarai rentetan | semua | macos, linux, windows. Kemahiran hanya dimuatkan di tempat yang sepadan. |
capabilities | senarai rentetan | [] | network dan storage meluaskan kotak pasir skrip. Lihat Kotak pasir skrip. |
metadata | map | {} | Mengandungi secrets dan allowed_domains. Lihat di bawah. |
requires | senarai {name, version} | [] | Kemahiran lain yang menjadi asas kemahiran ini. name ialah nama pendek kemahiran; version ialah julat semver, lalai "*". |
plugins | senarai {name, version, optional} | [] | Plugin yang digunakan oleh kemahiran ini. version lalai kepada "*", optional kepada false. |
dependencies | senarai rentetan | [] | Nama pendek kemahiran yang mesti ada. |
priority | integer | 0 | Menyusun kemahiran dalam senarai pengurusan. Ia tidak menjejaskan kemahiran yang dipilih oleh pekerja. |
author | string | "" | Disimpan untuk paparan. |
license | string | "" | Disimpan untuk paparan. |
compatibility | string | "" | Nota teks bebas, paling banyak 500 bait. |
tags | senarai rentetan | [] | Disimpan untuk paparan. |
allowed-tools | string | "" | Rentetan yang dipisahkan ruang. Disimpan; tidak dikuatkuasakan. |
Apabila kemahiran yang dinamakan dalam requires atau dependencies tiada atau di luar julat, atau plugin yang wajib tidak dipasang, kemahiran masih dimuatkan dan ditandakan sebagai terdegradasi. Pemilik melihat apa yang tiada.
Rahsia
Isytiharkan kelayakan yang diperlukan oleh skrip kemahiran di bawah metadata.secrets. Pemilik menyediakan nilainya, dan Nebo menyimpannya secara tersulit untuk kemahiran itu.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Kunci | Maksud |
|---|---|
key | Nama pemboleh ubah persekitaran yang diterima oleh skrip. Wajib. |
label | Nama yang dipaparkan kepada pemilik. |
hint | Tempat untuk mendapatkan nilai. |
required | Apabila true, execute enggan menjalankan skrip kemahiran sehingga nilai ditetapkan. Lalai false. |
Pekerja menetapkan nilai dengan configure_skill. Anda boleh merujuk rahsia dalam kandungan sebagai ${secret.KEY}, walaupun skrip sepatutnya membaca pemboleh ubah persekitaran.
Pemboleh ubah templat
Nebo menggantikan pemboleh ubah ini dalam badan apabila pekerja memuatkan kemahiran. Ia tidak digantikan di dalam fail lain; skrip membaca pemboleh ubah persekitaran sebaliknya.
| Pemboleh ubah | Nilai |
|---|---|
${NEBO_SKILL_DIR} | Laluan mutlak folder kemahiran. |
${NEBO_DATA_DIR} | Folder boleh tulis untuk kemahiran ini: <data>/appdata/skills/<name>. Dicipta pada penggunaan pertama. |
${NEBO_USER_NAME} | Nama pemilik. |
${NEBO_OS} | Sistem pengendalian. |
${NEBO_ARCH} | Seni bina pemproses. |
${plugin.SLUG_BIN} | Laluan binari plugin yang diisytiharkan. Slug ditukar kepada huruf besar, dengan tanda sempang sebagai garis bawah: example-ledger menjadi ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | Nilai rahsia yang diisytiharkan. |
$ARGUMENTS | args yang dihantar kepada use_skill. Apabila badan tiada $ARGUMENTS, argumen ditambah selepasnya. |
Alat kemahiran
Pekerja bekerja dengan kemahiran melalui alat ini. use_skill sentiasa tersedia; yang lain dimuatkan apabila pekerja memerlukannya.
| Alat | Parameter | Fungsinya |
|---|---|---|
use_skill | name, args | Memuatkan kemahiran. Mengembalikan badan yang dikembangkan, laluan folder, dan 20 nama fail pertama. Mendayakan semula kemahiran yang dinyahdayakan. |
find_skills | query | Mengembalikan sehingga 10 kemahiran yang disusun mengikut padanan nama, pencetus dan perihalan. |
read_skill_file | name, path | Membaca fail dalam folder kemahiran. Tanpa path, menyenaraikan fail dan saiznya. |
save_skill | name, content | Menulis SKILL.md yang lengkap ke folder kemahiran pengguna. Kemahiran pasaran tidak boleh ditulis ganti. |
delete_skill | name | Memadam kemahiran pengguna. |
install_skill | code | Memasang kemahiran pasaran daripada kod pemasangan SKIL-nya. |
configure_skill | name, key, value | Menetapkan rahsia. Tanpa key, menunjukkan apa yang diperlukan oleh kemahiran. |
rate_skill | name, rating, review | Menilai kemahiran pasaran dari 1 hingga 5. |
read_skill_reviews | name | Membaca ulasan kemahiran pasaran. |
execute | skill, script, args, timeout | Menjalankan skrip dari folder kemahiran. Lihat Kotak pasir skrip. |
Kotak pasir skrip
Alat execute menjalankan satu skrip dari folder kemahiran. Ia memilih masa jalan berdasarkan fail.
| Skrip | Masa jalan |
|---|---|
.py | Python, melalui uv terbungkus Nebo jika ada, jika tidak python3. |
.ts, .js | Bun terbungkus Nebo jika ada, jika tidak node. |
bin/<file> atau binary | Dijalankan secara terus. |
.sh | Tidak disokong. |
Setiap larian bermula dengan persekitaran kosong dan pemboleh ubah ini:
| Pemboleh ubah | Nilai |
|---|---|
SKILL_ARGS | Objek args sebagai JSON. |
Setiap key rahsia | Nilai rahsia yang telah dinyahsulit. |
<PLUGIN>_BIN | Laluan binari setiap plugin yang diisytiharkan. Folder plugin juga ditambah pada PATH. |
import json, os
args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
api_key = os.environ["EXAMPLE_API_KEY"]
print(json.dumps({"checked": len(args.get("items", []))})) Skrip berjalan dalam salinan sementara folder kemahiran, dengan masa tamat lalai 30 saat. Pada macOS dan Linux, ia berjalan dalam kotak pasir sistem pengendalian:
- Ia tidak boleh membaca stor kelayakan, data pelayar dan rantai kunci, atau tetapan dan pangkalan data Nebo sendiri.
- Ia hanya boleh menulis ke folder kerjanya dan
/tmp/nebo. Keupayaanstoragemenambah folder data Nebo. - Ia tidak mempunyai akses rangkaian. Keupayaan
networkmembenarkan pendaftaran pakej dan domain yang disenaraikan dalammetadata.allowed_domains.
Fail dan had
| Item | Peraturan |
|---|---|
| Sumber | Setiap fail kecuali SKILL.md, manifest.json, signatures.json dan fail bertitik. |
| Fail boleh laku | Fail di bawah scripts/ atau bin/, dan fail akar bernama binary. |
| Laluan | Relatif kepada folder kemahiran. Laluan dengan .. atau yang terlepas keluar dari folder akan ditolak. |
| Kemahiran yang dinyahdayakan | Folder dengan SKILL.md.disabled dan bukannya SKILL.md. |
| Senarai kemahiran | Setiap entri dipotong pada 250 aksara. Apabila keseluruhan senarai melebihi 8,000 aksara, kemahiran dikongsi dipendekkan dahulu; kemahiran milik pekerja sendiri mengekalkan entri penuhnya. |
Had untuk fail yang anda terbitkan ke pasaran terdapat pada halaman Penerbitan.