Fájlformátum
A SKILL.md UTF-8 kódolású szöveg. Egy három kötőjelből álló sorral kezdődik, ezt követi a YAML-fejléc, majd egy záró, három kötőjelből álló sor. Minden, ami ezután jön, a törzs: Markdown-utasítások, amelyeket a munkatárs a készség betöltésekor kap meg. A Nebo a fájlt a név alapján találja meg, kis- és nagybetűtől függetlenül.
---
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 ... Fejlécmezők
Csak a name és a description kötelező. Egy hibás típusú mező az egész fájlt érvényteleníti, így a készség nem töltődik be. Az itt fel nem sorolt kulcsokat figyelmen kívül hagyja.
| Mező | Típus | Alapérték | Jelentés |
|---|---|---|---|
name | string | kötelező | Azonosító. [a-z0-9-], nem kezdődhet és nem végződhet kötőjellel, nem lehet benne dupla kötőjel, legfeljebb 64 bájt. Egyezzen a mappa nevével. |
description | string | kötelező | Mit csinál a készség, és mikor kell használni. Legfeljebb 1024 bájt. Megjelenik a munkatárs készséglistájában, és a find_skills pontozza. |
version | string | "1.0.0" | Szemantikus verzió. Más készségek requires tartományai ellenőrzik. Tegye idézőjelbe. |
triggers | karakterláncok listája | [] | Szavak és kifejezések, amelyek leírják, mikor alkalmazható a készség. Legfeljebb három jelenik meg a készséglistában; a find_skills mindet figyelembe veszi. Maguktól soha nem töltenek be készséget. |
platform | karakterláncok listája | mind | macos, linux, windows. A készség csak ott töltődik be, ahol valamelyik egyezik. |
capabilities | karakterláncok listája | [] | A network és a storage kibővíti a szkriptek homokozóját. Lásd: Szkripthomokozó. |
metadata | map | {} | A secrets és az allowed_domains értékeket tartalmazza. Lásd alább. |
requires | {name, version} listája | [] | Más készségek, amelyekre ez a készség épül. A name a készség rövid neve; a version egy semver tartomány, alapértéke "*". |
plugins | {name, version, optional} listája | [] | A készség által használt bővítmények. A version alapértéke "*", az optional értéke false. |
dependencies | karakterláncok listája | [] | Azoknak a készségeknek a rövid neve, amelyeknek jelen kell lenniük. |
priority | integer | 0 | A készségek sorrendje a kezelési listákban. Nem befolyásolja, melyik készséget választja a munkatárs. |
author | string | "" | Megjelenítéshez tárolva. |
license | string | "" | Megjelenítéshez tárolva. |
compatibility | string | "" | Szabad szöveges megjegyzés, legfeljebb 500 bájt. |
tags | karakterláncok listája | [] | Megjelenítéshez tárolva. |
allowed-tools | string | "" | Szóközzel elválasztott karakterlánc. Tárolva; nincs kikényszerítve. |
Ha a requires vagy a dependencies alatt megnevezett készség hiányzik vagy a tartományon kívül esik, illetve egy szükséges bővítmény nincs telepítve, a készség ettől még betöltődik, és korlátozottként jelölődik meg. A tulajdonos látja, mi hiányzik.
Titkos adatok
A készség szkriptjeihez szükséges hitelesítő adatokat a metadata.secrets alatt deklarálja. Az értékeket a tulajdonos adja meg, a Nebo pedig titkosítva tárolja őket az adott készséghez.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Kulcs | Jelentés |
|---|---|
key | A környezeti változó neve, amelyet a szkript megkap. Kötelező. |
label | A tulajdonosnak megjelenített név. |
hint | Honnan szerezhető be az érték. |
required | Ha true, az execute nem futtatja a készség szkriptjeit, amíg az érték nincs beállítva. Alapérték: false. |
Egy munkatárs a configure_skill segítségével állít be értéket. A törzsben titkos értékre ${secret.KEY} formában hivatkozhat, bár a szkripteknek inkább a környezeti változót érdemes olvasniuk.
Sablonváltozók
A Nebo ezeket a változókat a törzsben helyettesíti be, amikor egy munkatárs betölti a készséget. Más fájlokban nem helyettesíti be őket; a szkriptek ehelyett környezeti változókat olvasnak.
| Változó | Érték |
|---|---|
${NEBO_SKILL_DIR} | A készség mappájának abszolút elérési útja. |
${NEBO_DATA_DIR} | A készség írható mappája: <data>/appdata/skills/<name>. Az első használatkor jön létre. |
${NEBO_USER_NAME} | A tulajdonos neve. |
${NEBO_OS} | Az operációs rendszer. |
${NEBO_ARCH} | A processzor architektúrája. |
${plugin.SLUG_BIN} | Egy deklarált bővítmény binárisának elérési útja. A slug nagybetűs, a kötőjelek helyén aláhúzással: az example-ledger ebből lesz: ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | Egy deklarált titkos adat értéke. |
$ARGUMENTS | A use_skill eszköznek átadott args. Ha a törzsben nincs $ARGUMENTS, az argumentumok a törzs után kerülnek. |
Készségeszközök
A munkatársak ezekkel az eszközökkel dolgoznak a készségekkel. A use_skill mindig elérhető; a többi akkor töltődik be, amikor egy munkatársnak szüksége van rá.
| Eszköz | Paraméterek | Mit csinál |
|---|---|---|
use_skill | name, args | Betölt egy készséget. Visszaadja a behelyettesített törzset, a mappa elérési útját és az első 20 fájlnevet. Újra engedélyezi a letiltott készséget. |
find_skills | query | Legfeljebb 10 készséget ad vissza név-, indítószó- és leírásegyezés szerint rangsorolva. |
read_skill_file | name, path | Beolvas egy fájlt a készség mappájából. path nélkül kilistázza a fájlokat és a méretüket. |
save_skill | name, content | Egy teljes SKILL.md fájlt ír a felhasználói készségmappába. A piactéri készségek nem írhatók felül. |
delete_skill | name | Töröl egy felhasználói készséget. |
install_skill | code | Telepít egy piactéri készséget a SKIL- telepítési kódjából. |
configure_skill | name, key, value | Beállít egy titkos adatot. key nélkül megmutatja, mire van szüksége a készségnek. |
rate_skill | name, rating, review | 1-től 5-ig értékel egy piactéri készséget. |
read_skill_reviews | name | Beolvassa egy piactéri készség értékeléseit. |
execute | skill, script, args, timeout | Szkriptet futtat egy készség mappájából. Lásd: Szkripthomokozó. |
Szkripthomokozó
Az execute eszköz egy szkriptet futtat egy készség mappájából. A futtatókörnyezetet a fájl alapján választja ki.
| Szkript | Futtatókörnyezet |
|---|---|
.py | Python, a Nebo csomagolt uv eszközén keresztül, ha van, egyébként python3. |
.ts, .js | A Nebo csomagolt Bun futtatója, ha van, egyébként node. |
bin/<file> vagy binary | Közvetlenül fut. |
.sh | Nem támogatott. |
Minden futtatás üres környezettel és ezekkel a változókkal indul:
| Változó | Érték |
|---|---|
SKILL_ARGS | Az args objektum JSON-ként. |
Minden titkos adat key értéke | A visszafejtett titkos érték. |
<PLUGIN>_BIN | Minden deklarált bővítmény binárisának elérési útja. A bővítménymappák a PATH változóhoz is hozzáadódnak. |
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", []))})) A szkript a készségmappa egy ideiglenes másolatában fut, 30 másodperces alapértelmezett időkorláttal. macOS-en és Linuxon operációsrendszer-szintű homokozóban fut:
- Nem olvashatja a hitelesítőadat-tárolókat, a böngésző- és kulcskarikaadatokat, sem a Nebo saját beállításait és adatbázisát.
- Csak a munkamappájába és a
/tmp/nebomappába írhat. Astorageképesség hozzáadja a Nebo adatmappáját. - Nincs hálózati hozzáférése. A
networkképesség engedélyezi a csomagtárolókat és ametadata.allowed_domainsalatt felsorolt tartományokat.
Fájlok és korlátok
| Elem | Szabály |
|---|---|
| Erőforrások | Minden fájl, kivéve a SKILL.md, manifest.json, signatures.json fájlokat és a pontfájlokat. |
| Futtatható fájlok | A scripts/ vagy bin/ alatti fájlok, valamint egy binary nevű gyökérfájl. |
| Elérési utak | A készségmappához viszonyítva. A .. részt tartalmazó vagy a mappából kivezető útvonalakat elutasítja. |
| Letiltott készség | Egy mappa, amelyben SKILL.md helyett SKILL.md.disabled van. |
| Készséglista | Minden bejegyzés 250 karakternél le van vágva. Ha a teljes lista meghaladja a 8000 karaktert, előbb a közös készségek rövidülnek; a munkatárs saját készségei megtartják a teljes bejegyzésüket. |
A piactérre közzétett fájlok korlátai a Közzététel oldalon találhatók.