NeboAI
NeboAI
Mulakan

Rujukan SKILL.md

Halaman ini menyenaraikan setiap bahagian kemahiran yang dibaca oleh Nebo: medan frontmatter, pemboleh ubah yang dikembangkannya, alat yang digunakan pekerja untuk bekerja dengan kemahiran, dan persekitaran tempat skrip berjalan.

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.

MedanJenisLalaiMaksud
namestringwajibPengecam. [a-z0-9-], tiada tanda sempang di awal, di akhir atau berganda, paling banyak 64 bait. Padankan dengan nama folder.
descriptionstringwajibApa yang dilakukan oleh kemahiran dan bila menggunakannya. Paling banyak 1,024 bait. Dipaparkan dalam senarai kemahiran pekerja dan diberi skor oleh find_skills.
versionstring"1.0.0"Versi semantik. Disemak oleh julat requires kemahiran lain. Letakkan dalam tanda petik.
triggerssenarai 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.
platformsenarai rentetansemuamacos, linux, windows. Kemahiran hanya dimuatkan di tempat yang sepadan.
capabilitiessenarai rentetan[]network dan storage meluaskan kotak pasir skrip. Lihat Kotak pasir skrip.
metadatamap{}Mengandungi secrets dan allowed_domains. Lihat di bawah.
requiressenarai {name, version}[]Kemahiran lain yang menjadi asas kemahiran ini. name ialah nama pendek kemahiran; version ialah julat semver, lalai "*".
pluginssenarai {name, version, optional}[]Plugin yang digunakan oleh kemahiran ini. version lalai kepada "*", optional kepada false.
dependenciessenarai rentetan[]Nama pendek kemahiran yang mesti ada.
priorityinteger0Menyusun kemahiran dalam senarai pengurusan. Ia tidak menjejaskan kemahiran yang dipilih oleh pekerja.
authorstring""Disimpan untuk paparan.
licensestring""Disimpan untuk paparan.
compatibilitystring""Nota teks bebas, paling banyak 500 bait.
tagssenarai rentetan[]Disimpan untuk paparan.
allowed-toolsstring""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
KunciMaksud
keyNama pemboleh ubah persekitaran yang diterima oleh skrip. Wajib.
labelNama yang dipaparkan kepada pemilik.
hintTempat untuk mendapatkan nilai.
requiredApabila 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 ubahNilai
${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.
$ARGUMENTSargs 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.

AlatParameterFungsinya
use_skillname, argsMemuatkan kemahiran. Mengembalikan badan yang dikembangkan, laluan folder, dan 20 nama fail pertama. Mendayakan semula kemahiran yang dinyahdayakan.
find_skillsqueryMengembalikan sehingga 10 kemahiran yang disusun mengikut padanan nama, pencetus dan perihalan.
read_skill_filename, pathMembaca fail dalam folder kemahiran. Tanpa path, menyenaraikan fail dan saiznya.
save_skillname, contentMenulis SKILL.md yang lengkap ke folder kemahiran pengguna. Kemahiran pasaran tidak boleh ditulis ganti.
delete_skillnameMemadam kemahiran pengguna.
install_skillcodeMemasang kemahiran pasaran daripada kod pemasangan SKIL-nya.
configure_skillname, key, valueMenetapkan rahsia. Tanpa key, menunjukkan apa yang diperlukan oleh kemahiran.
rate_skillname, rating, reviewMenilai kemahiran pasaran dari 1 hingga 5.
read_skill_reviewsnameMembaca ulasan kemahiran pasaran.
executeskill, script, args, timeoutMenjalankan 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.

SkripMasa jalan
.pyPython, melalui uv terbungkus Nebo jika ada, jika tidak python3.
.ts, .jsBun terbungkus Nebo jika ada, jika tidak node.
bin/<file> atau binaryDijalankan secara terus.
.shTidak disokong.

Setiap larian bermula dengan persekitaran kosong dan pemboleh ubah ini:

Pemboleh ubahNilai
SKILL_ARGSObjek args sebagai JSON.
Setiap key rahsiaNilai rahsia yang telah dinyahsulit.
<PLUGIN>_BINLaluan 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. Keupayaan storage menambah folder data Nebo.
  • Ia tidak mempunyai akses rangkaian. Keupayaan network membenarkan pendaftaran pakej dan domain yang disenaraikan dalam metadata.allowed_domains.

Fail dan had

ItemPeraturan
SumberSetiap fail kecuali SKILL.md, manifest.json, signatures.json dan fail bertitik.
Fail boleh lakuFail di bawah scripts/ atau bin/, dan fail akar bernama binary.
LaluanRelatif kepada folder kemahiran. Laluan dengan .. atau yang terlepas keluar dari folder akan ditolak.
Kemahiran yang dinyahdayakanFolder dengan SKILL.md.disabled dan bukannya SKILL.md.
Senarai kemahiranSetiap 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.