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ä | Tyyppi | Oletus | Merkitys |
|---|---|---|---|
name | string | pakollinen | Tunniste. [a-z0-9-], ei yhdysmerkkiä alussa tai lopussa eikä kahta peräkkäin, enintään 64 tavua. Vastaa kansion nimeä. |
description | string | pakollinen | Mitä 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. |
version | string | "1.0.0" | Semanttinen versio. Muiden taitojen requires-välit tarkistavat sen. Laita se lainausmerkkeihin. |
triggers | merkkijonolista | [] | 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. |
platform | merkkijonolista | kaikki | macos, linux, windows. Taito latautuu vain, jos jokin niistä täsmää. |
capabilities | merkkijonolista | [] | network ja storage laajentavat skriptien hiekkalaatikkoa. Katso Skriptien hiekkalaatikko. |
metadata | map | {} | Sisältää kentät secrets ja allowed_domains. Katso alla. |
requires | lista muotoa {name, version} | [] | Muut taidot, joiden varaan tämä taito rakentuu. name on taidon lyhyt nimi; version on semver-väli, oletuksena "*". |
plugins | lista muotoa {name, version, optional} | [] | Laajennukset, joita tämä taito käyttää. version on oletuksena "*", optional false. |
dependencies | merkkijonolista | [] | Taitojen lyhyet nimet, joiden on oltava saatavilla. |
priority | integer | 0 | Järjestää taidot hallintaluetteloissa. Ei vaikuta siihen, minkä taidon työntekijä valitsee. |
author | string | "" | Tallennetaan näyttämistä varten. |
license | string | "" | Tallennetaan näyttämistä varten. |
compatibility | string | "" | Vapaamuotoinen huomautus, enintään 500 tavua. |
tags | merkkijonolista | [] | Tallennetaan näyttämistä varten. |
allowed-tools | string | "" | 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 | Avain | Merkitys |
|---|---|
key | Ympäristömuuttujan nimi, jonka skripti saa. Pakollinen. |
label | Omistajalle näytettävä nimi. |
hint | Mistä arvon saa. |
required | Kun 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.
| Muuttuja | Arvo |
|---|---|
${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. |
$ARGUMENTS | use_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ökalu | Parametrit | Mitä se tekee |
|---|---|---|
use_skill | name, args | Lataa taidon. Palauttaa laajennetun rungon, kansion polun ja ensimmäiset 20 tiedostonimeä. Ottaa käytöstä poistetun taidon uudelleen käyttöön. |
find_skills | query | Palauttaa enintään 10 taitoa järjestettynä nimen, laukaisimen ja kuvauksen osumien mukaan. |
read_skill_file | name, path | Lukee tiedoston taidon kansiosta. Ilman path-arvoa luettelee tiedostot ja niiden koot. |
save_skill | name, content | Kirjoittaa kokonaisen SKILL.md-tiedoston käyttäjän taitokansioon. Kaupan taitoja ei voi korvata. |
delete_skill | name | Poistaa käyttäjän taidon. |
install_skill | code | Asentaa kaupan taidon sen SKIL--asennuskoodilla. |
configure_skill | name, key, value | Asettaa salaisuuden. Ilman key-arvoa näyttää, mitä taito tarvitsee. |
rate_skill | name, rating, review | Arvioi kaupan taidon asteikolla 1–5. |
read_skill_reviews | name | Lukee kaupan taidon arvostelut. |
execute | skill, script, args, timeout | Suorittaa skriptin taidon kansiosta. Katso Skriptien hiekkalaatikko. |
Skriptien hiekkalaatikko
execute-työkalu suorittaa yhden skriptin taidon kansiosta. Se valitsee suoritusympäristön tiedoston perusteella.
| Skripti | Suoritusympäristö |
|---|---|
.py | Python Nebon mukana tulevan uv:n kautta, jos sellainen on, muuten python3. |
.ts, .js | Nebon mukana tuleva Bun, jos sellainen on, muuten node. |
bin/<file> tai binary | Suoritetaan suoraan. |
.sh | Ei tueta. |
Jokainen suoritus alkaa tyhjällä ympäristöllä ja näillä muuttujilla:
| Muuttuja | Arvo |
|---|---|
SKILL_ARGS | args-objekti JSONina. |
Jokainen salaisuuden key | Salauksesta purettu salaisuuden arvo. |
<PLUGIN>_BIN | Jokaisen 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 kohdassametadata.allowed_domainsluetellut verkkotunnukset.
Tiedostot ja rajat
| Kohde | Sääntö |
|---|---|
| Resurssit | Kaikki tiedostot paitsi SKILL.md, manifest.json, signatures.json ja pistetiedostot. |
| Suoritettavat tiedostot | Kansioiden scripts/ tai bin/ tiedostot sekä juurikansion tiedosto nimeltä binary. |
| Polut | Suhteessa taidon kansioon. Polut, joissa on .. tai jotka johtavat kansiosta ulos, hylätään. |
| Käytöstä poistettu taito | Kansio, jossa on SKILL.md.disabled tiedoston SKILL.md sijaan. |
| Taitoluettelo | Jokainen 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.