NeboAI
NeboAI
Aloita

SKILL.md-viite

Tällä sivulla on jokainen taidon osa, jonka Nebo lukee: esittelyosan kentät, muuttujat, jotka se laajentaa, työkalut, joilla työntekijät käyttävät taitoja, ja ympäristö, jossa skriptit suoritetaan.

Tiedostomuoto

SKILL.md on UTF-8-tekstiä. Se alkaa rivillä, jossa on kolme yhdysmerkkiä, sitten tulee YAML-esittelyosa ja sen jälkeen sulkeva kolmen yhdysmerkin rivi. Kaikki sen jälkeen on runkoa: Markdown-ohjeet, jotka työntekijä saa ladatessaan taidon. Nebo löytää tiedoston nimen perusteella kirjainkoosta riippumatta.

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

Esittelyosan kentät

Vain name ja description ovat pakollisia. Väärän tyypin kenttä hylkää koko tiedoston, jolloin taito ei lataudu. Avaimet, joita ei ole lueteltu tässä, ohitetaan.

KenttäTyyppiOletusMerkitys
namestringpakollinenTunniste. [a-z0-9-], ei yhdysmerkkiä alussa tai lopussa eikä kahta peräkkäin, enintään 64 tavua. Vastaa kansion nimeä.
descriptionstringpakollinenMitä taito tekee ja milloin sitä käytetään. Enintään 1 024 tavua. Näytetään työntekijän taitoluettelossa, ja find_skills pisteyttää sen.
versionstring"1.0.0"Semanttinen versio. Muiden taitojen requires-välit tarkistavat sen. Laita se lainausmerkkeihin.
triggersmerkkijonolista[]Sanat ja ilmaukset, jotka kuvaavat, milloin taito on käytössä. Enintään kolme näkyy taitoluettelossa; kaikki lasketaan find_skills-haussa. Ne eivät koskaan lataa taitoa itsestään.
platformmerkkijonolistakaikkimacos, linux, windows. Taito latautuu vain, jos jokin niistä täsmää.
capabilitiesmerkkijonolista[]network ja storage laajentavat skriptien hiekkalaatikkoa. Katso Skriptien hiekkalaatikko.
metadatamap{}Sisältää kentät secrets ja allowed_domains. Katso alla.
requireslista muotoa {name, version}[]Muut taidot, joiden varaan tämä taito rakentuu. name on taidon lyhyt nimi; version on semver-väli, oletuksena "*".
pluginslista muotoa {name, version, optional}[]Laajennukset, joita tämä taito käyttää. version on oletuksena "*", optional false.
dependenciesmerkkijonolista[]Taitojen lyhyet nimet, joiden on oltava saatavilla.
priorityinteger0Järjestää taidot hallintaluetteloissa. Ei vaikuta siihen, minkä taidon työntekijä valitsee.
authorstring""Tallennetaan näyttämistä varten.
licensestring""Tallennetaan näyttämistä varten.
compatibilitystring""Vapaamuotoinen huomautus, enintään 500 tavua.
tagsmerkkijonolista[]Tallennetaan näyttämistä varten.
allowed-toolsstring""Välilyönnein eroteltu merkkijono. Tallennetaan; ei valvota.

Kun requires- tai dependencies-kentässä nimetty taito puuttuu tai on välin ulkopuolella, tai vaadittua laajennusta ei ole asennettu, taito latautuu silti ja merkitään heikennetyksi. Omistaja näkee, mitä puuttuu.

Salaisuudet

Ilmoita taidon skriptien tarvitsemat tunnistetiedot kohdassa metadata.secrets. Omistaja antaa arvot, ja Nebo tallentaa ne salattuina kyseiselle taidolle.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
AvainMerkitys
keyYmpäristömuuttujan nimi, jonka skripti saa. Pakollinen.
labelOmistajalle näytettävä nimi.
hintMistä arvon saa.
requiredKun arvo on true, execute kieltäytyy suorittamasta taidon skriptejä, kunnes arvo on asetettu. Oletus false.

Työntekijä asettaa arvon komennolla configure_skill. Voit viitata salaisuuteen sisällössä muodossa ${secret.KEY}, mutta skriptien kannattaa lukea ympäristömuuttuja.

Mallimuuttujat

Nebo korvaa nämä muuttujat rungossa, kun työntekijä lataa taidon. Niitä ei korvata muissa tiedostoissa; skriptit lukevat sen sijaan ympäristömuuttujia.

MuuttujaArvo
${NEBO_SKILL_DIR}Taidon kansion absoluuttinen polku.
${NEBO_DATA_DIR}Taidolle kirjoitettava kansio: <data>/appdata/skills/<name>. Luodaan ensimmäisellä käyttökerralla.
${NEBO_USER_NAME}Omistajan nimi.
${NEBO_OS}Käyttöjärjestelmä.
${NEBO_ARCH}Suoritinarkkitehtuuri.
${plugin.SLUG_BIN}Ilmoitetun laajennuksen binäärin polku. Slug kirjoitetaan isoin kirjaimin ja yhdysmerkit alaviivoina: example-ledger muuttuu muotoon ${plugin.EXAMPLE_LEDGER_BIN}.
${secret.KEY}Ilmoitetun salaisuuden arvo.
$ARGUMENTSuse_skill-työkalulle välitetyt args. Kun rungossa ei ole $ARGUMENTS-muuttujaa, argumentit lisätään sen perään.

Taitotyökalut

Työntekijät käyttävät taitoja näillä työkaluilla. use_skill on aina käytettävissä; muut latautuvat, kun työntekijä tarvitsee niitä.

TyökaluParametritMitä se tekee
use_skillname, argsLataa taidon. Palauttaa laajennetun rungon, kansion polun ja ensimmäiset 20 tiedostonimeä. Ottaa käytöstä poistetun taidon uudelleen käyttöön.
find_skillsqueryPalauttaa enintään 10 taitoa järjestettynä nimen, laukaisimen ja kuvauksen osumien mukaan.
read_skill_filename, pathLukee tiedoston taidon kansiosta. Ilman path-arvoa luettelee tiedostot ja niiden koot.
save_skillname, contentKirjoittaa kokonaisen SKILL.md-tiedoston käyttäjän taitokansioon. Kaupan taitoja ei voi korvata.
delete_skillnamePoistaa käyttäjän taidon.
install_skillcodeAsentaa kaupan taidon sen SKIL--asennuskoodilla.
configure_skillname, key, valueAsettaa salaisuuden. Ilman key-arvoa näyttää, mitä taito tarvitsee.
rate_skillname, rating, reviewArvioi kaupan taidon asteikolla 1–5.
read_skill_reviewsnameLukee kaupan taidon arvostelut.
executeskill, script, args, timeoutSuorittaa skriptin taidon kansiosta. Katso Skriptien hiekkalaatikko.

Skriptien hiekkalaatikko

execute-työkalu suorittaa yhden skriptin taidon kansiosta. Se valitsee suoritusympäristön tiedoston perusteella.

SkriptiSuoritusympäristö
.pyPython Nebon mukana tulevan uv:n kautta, jos sellainen on, muuten python3.
.ts, .jsNebon mukana tuleva Bun, jos sellainen on, muuten node.
bin/<file> tai binarySuoritetaan suoraan.
.shEi tueta.

Jokainen suoritus alkaa tyhjällä ympäristöllä ja näillä muuttujilla:

MuuttujaArvo
SKILL_ARGSargs-objekti JSONina.
Jokainen salaisuuden keySalauksesta purettu salaisuuden arvo.
<PLUGIN>_BINJokaisen ilmoitetun laajennuksen binäärin polku. Laajennusten kansiot lisätään myös PATH-muuttujaan.
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", []))}))

Skripti suoritetaan taidon kansion väliaikaisessa kopiossa, oletusaikakatkaisuna 30 sekuntia. macOS:ssä ja Linuxissa se toimii käyttöjärjestelmän hiekkalaatikossa:

  • Se ei voi lukea tunnistetietovarastoja, selaimen ja avainnipun tietoja eikä Nebon omia asetuksia ja tietokantaa.
  • Se voi kirjoittaa vain työkansioonsa ja kansioon /tmp/nebo. storage-kyky lisää Nebon datakansion.
  • Sillä ei ole verkkoyhteyttä. network-kyky sallii pakettirekisterit ja kohdassa metadata.allowed_domains luetellut verkkotunnukset.

Tiedostot ja rajat

KohdeSääntö
ResurssitKaikki tiedostot paitsi SKILL.md, manifest.json, signatures.json ja pistetiedostot.
Suoritettavat tiedostotKansioiden scripts/ tai bin/ tiedostot sekä juurikansion tiedosto nimeltä binary.
PolutSuhteessa taidon kansioon. Polut, joissa on .. tai jotka johtavat kansiosta ulos, hylätään.
Käytöstä poistettu taitoKansio, jossa on SKILL.md.disabled tiedoston SKILL.md sijaan.
TaitoluetteloJokainen merkintä katkaistaan 250 merkkiin. Kun koko luettelo ylittää 8 000 merkkiä, jaettuja taitoja lyhennetään ensin; työntekijän omat taidot säilyttävät koko merkintänsä.

Kauppaan julkaistavien tiedostojen rajat ovat Julkaiseminen-sivulla.