NeboAI
NeboAI
Începe

Referință SKILL.md

Această pagină listează fiecare parte a unei abilități pe care Nebo o citește: câmpurile de frontmatter, variabilele pe care le extinde, instrumentele cu care angajații lucrează cu abilitățile și mediul în care rulează scripturile.

Formatul fișierului

SKILL.md este text UTF-8. Începe cu o linie de trei cratime, urmată de frontmatter YAML, apoi de o linie de închidere cu trei cratime. Tot ce urmează este corpul: instrucțiunile Markdown pe care angajatul le primește când încarcă abilitatea. Nebo găsește fișierul după nume, indiferent de majuscule.

---
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 ...

Câmpuri de frontmatter

Doar name și description sunt obligatorii. Un câmp cu tipul greșit invalidează întregul fișier, așa că abilitatea nu se încarcă. Cheile care nu sunt listate aici sunt ignorate.

CâmpTipImplicitSemnificație
namestringobligatoriuIdentificator. [a-z0-9-], fără cratimă la început, la sfârșit sau dublă, cel mult 64 de octeți. Trebuie să corespundă cu numele folderului.
descriptionstringobligatoriuCe face abilitatea și când se folosește. Cel mult 1.024 de octeți. Afișată în lista de abilități a angajatului și punctată de find_skills.
versionstring"1.0.0"Versiune semantică. Verificată de intervalele requires ale altor abilități. Pune-o între ghilimele.
triggerslistă de șiruri[]Cuvinte și expresii care descriu când se aplică abilitatea. Până la trei apar în lista de abilități; toate contează în find_skills. Nu încarcă niciodată singure o abilitate.
platformlistă de șiruritoatemacos, linux, windows. Abilitatea se încarcă doar acolo unde una se potrivește.
capabilitieslistă de șiruri[]network și storage lărgesc sandboxul pentru scripturi. Vezi Sandboxul pentru scripturi.
metadatamap{}Conține secrets și allowed_domains. Vezi mai jos.
requireslistă de {name, version}[]Alte abilități pe care se bazează această abilitate. name este numele scurt al abilității; version este un interval semver, implicit "*".
pluginslistă de {name, version, optional}[]Pluginurile pe care le folosește această abilitate. version are implicit valoarea "*", optional are false.
dependencieslistă de șiruri[]Numele scurte ale abilităților care trebuie să fie prezente.
priorityinteger0Ordonează abilitățile în listele de administrare. Nu influențează ce abilitate alege un angajat.
authorstring""Stocat pentru afișare.
licensestring""Stocat pentru afișare.
compatibilitystring""Notă liberă, de cel mult 500 de octeți.
tagslistă de șiruri[]Stocat pentru afișare.
allowed-toolsstring""Un șir separat prin spații. Stocat; nu este impus.

Când o abilitate numită în requires sau dependencies lipsește ori este în afara intervalului, sau un plugin necesar nu este instalat, abilitatea se încarcă totuși și este marcată ca degradată. Proprietarul vede ce lipsește.

Secrete

Declară datele de acces de care au nevoie scripturile unei abilități sub metadata.secrets. Proprietarul furnizează valorile, iar Nebo le stochează criptate pentru acea abilitate.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
CheieSemnificație
keyNumele variabilei de mediu pe care o primește scriptul. Obligatoriu.
labelNumele afișat proprietarului.
hintDe unde se obține valoarea.
requiredCând este true, execute refuză să ruleze scripturile abilității până când valoarea este setată. Implicit false.

Un angajat setează o valoare cu configure_skill. Poți face referire la un secret în corpul textului ca ${secret.KEY}, deși scripturile ar trebui să citească în schimb variabila de mediu.

Variabile de șablon

Nebo înlocuiește aceste variabile în corp când un angajat încarcă abilitatea. Ele nu sunt înlocuite în alte fișiere; scripturile citesc în schimb variabile de mediu.

VariabilăValoare
${NEBO_SKILL_DIR}Calea absolută a folderului abilității.
${NEBO_DATA_DIR}Un folder cu drept de scriere pentru această abilitate: <data>/appdata/skills/<name>. Creat la prima utilizare.
${NEBO_USER_NAME}Numele proprietarului.
${NEBO_OS}Sistemul de operare.
${NEBO_ARCH}Arhitectura procesorului.
${plugin.SLUG_BIN}Calea binarului unui plugin declarat. Slugul este scris cu majuscule, cu cratimele înlocuite de liniuțe de subliniere: example-ledger devine ${plugin.EXAMPLE_LEDGER_BIN}.
${secret.KEY}Valoarea unui secret declarat.
$ARGUMENTSargs transmise către use_skill. Când corpul nu conține $ARGUMENTS, argumentele sunt adăugate după el.

Instrumente pentru abilități

Angajații lucrează cu abilitățile prin aceste instrumente. use_skill este disponibil întotdeauna; celelalte se încarcă atunci când un angajat are nevoie de ele.

InstrumentParametriCe face
use_skillname, argsÎncarcă o abilitate. Returnează corpul extins, calea folderului și primele 20 de nume de fișiere. Reactivează o abilitate dezactivată.
find_skillsqueryReturnează până la 10 abilități ordonate după potrivirile cu numele, declanșatoarele și descrierea.
read_skill_filename, pathCitește un fișier din folderul abilității. Fără path, listează fișierele și dimensiunile lor.
save_skillname, contentScrie un SKILL.md complet în folderul de abilități al utilizatorului. Abilitățile din magazin nu pot fi suprascrise.
delete_skillnameȘterge o abilitate a utilizatorului.
install_skillcodeInstalează o abilitate din magazin pe baza codului de instalare SKIL-.
configure_skillname, key, valueSetează un secret. Fără key, arată de ce are nevoie abilitatea.
rate_skillname, rating, reviewEvaluează o abilitate din magazin de la 1 la 5.
read_skill_reviewsnameCitește recenziile unei abilități din magazin.
executeskill, script, args, timeoutRulează un script din folderul unei abilități. Vezi Sandboxul pentru scripturi.

Sandboxul pentru scripturi

Instrumentul execute rulează un script din folderul unei abilități. Alege mediul de rulare în funcție de fișier.

ScriptMediu de rulare
.pyPython, prin uv inclus în Nebo, când există, altfel python3.
.ts, .jsBun inclus în Nebo, când există, altfel node.
bin/<file> sau binaryRulat direct.
.shNu este suportat.

Fiecare rulare pornește cu un mediu gol și cu aceste variabile:

VariabilăValoare
SKILL_ARGSObiectul args ca JSON.
Fiecare key de secretValoarea decriptată a secretului.
<PLUGIN>_BINCalea binarului fiecărui plugin declarat. Folderele pluginurilor sunt adăugate și la 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", []))}))

Scriptul rulează într-o copie temporară a folderului abilității, cu un timp de așteptare implicit de 30 de secunde. Pe macOS și Linux rulează într-un sandbox al sistemului de operare:

  • Nu poate citi depozitele de date de acces, datele browserului și ale keychainului sau setările și baza de date proprii ale Nebo.
  • Poate scrie doar în folderul său de lucru și în /tmp/nebo. Capabilitatea storage adaugă folderul de date al Nebo.
  • Nu are acces la rețea. Capabilitatea network permite registrele de pachete și domeniile listate în metadata.allowed_domains.

Fișiere și limite

ElementRegulă
ResurseFiecare fișier, cu excepția SKILL.md, manifest.json, signatures.json și a fișierelor care încep cu punct.
ExecutabileFișierele din scripts/ sau bin/ și un fișier rădăcină numit binary.
CăiRelative la folderul abilității. Căile cu .. sau care ies din folder sunt respinse.
Abilitate dezactivatăUn folder cu SKILL.md.disabled în loc de SKILL.md.
Lista de abilitățiFiecare intrare este tăiată la 250 de caractere. Când întreaga listă depășește 8.000 de caractere, abilitățile comune sunt scurtate primele; abilitățile proprii ale unui angajat își păstrează intrările complete.

Limitele pentru fișierele pe care le publici în magazin se află pe pagina Publicare.