NeboAI
NeboAI
Kòmanse

Referans SKILL.md

Paj sa a bay lis chak pati yon konpetans Nebo li: chan antèt yo, varyab li ranplase yo, zouti anplwaye yo sèvi pou travay ak konpetans, ak anviwònman kote eskript yo mache.

Fòma fichye

SKILL.md se tèks UTF-8. Li kòmanse ak yon liy twa tirè, apre sa antèt YAML la, apre sa yon liy fèmti twa tirè. Tout sa ki vini apre se kò a: enstriksyon Markdown anplwaye a resevwa lè li chaje konpetans lan. Nebo jwenn fichye a pa non li san gade majiskil oswa miniskil.

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

Chan antèt

Se sèlman name ak description ki obligatwa. Yon chan ki gen move tip fè tout fichye a echwe, kidonk konpetans lan pa chaje. Kle ki pa nan lis isit la pa konte.

ChanTipPa defoSiyifikasyon
namestringobligatwaIdantifyan. [a-z0-9-], san tirè nan kòmansman, nan fen oswa de tirè youn dèyè lòt, 64 okte pou pi plis. Fè l menm ak non dosye a.
descriptionstringobligatwaSa konpetans lan fè ak ki lè pou sèvi avè l. 1 024 okte pou pi plis. Li parèt nan lis konpetans anplwaye a e find_skills ba l nòt.
versionstring"1.0.0"Vèsyon semantik. Entèval requires lòt konpetans yo verifye l. Mete l ant gimè.
triggerslis chèn karaktè[]Mo ak fraz ki dekri ki lè konpetans lan aplike. Jiska twa parèt nan lis konpetans lan; yo tout konte nan find_skills. Yo pa janm chaje yon konpetans pou kont yo.
platformlis chèn karaktètoutmacos, linux, windows. Konpetans lan chaje sèlman kote youn koresponn.
capabilitieslis chèn karaktè[]network ak storage elaji espas izole eskript la. Gade Espas izole eskript.
metadatamap{}Kenbe secrets ak allowed_domains. Gade anba a.
requireslis {name, version}[]Lòt konpetans konpetans sa a bati sou yo. name se non kout konpetans lan; version se yon entèval semver, pa defo "*".
pluginslis {name, version, optional}[]Plugin konpetans sa a sèvi ak yo. version pa defo se "*", optional pa defo se false.
dependencieslis chèn karaktè[]Non kout konpetans ki dwe la.
priorityinteger0Mete konpetans yo nan lòd nan lis jesyon yo. Sa pa chanje ki konpetans yon anplwaye chwazi.
authorstring""Anrejistre pou afichaj.
licensestring""Anrejistre pou afichaj.
compatibilitystring""Nòt tèks lib, 500 okte pou pi plis.
tagslis chèn karaktè[]Anrejistre pou afichaj.
allowed-toolsstring""Yon chèn karaktè separe pa espas. Anrejistre; yo pa aplike l.

Lè yon konpetans ki nonmen nan requires oswa dependencies manke oswa li deyò entèval la, oswa yon plugin obligatwa pa enstale, konpetans lan chaje kanmenm e li make kòm degrade. Pwopriyetè a wè sa ki manke.

Sekrè

Deklare idantifyan eskript yon konpetans bezwen anba metadata.secrets. Pwopriyetè a bay valè yo, e Nebo anrejistre yo chifre pou konpetans sa a.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
KleSiyifikasyon
keyNon varyab anviwònman eskript la resevwa. Obligatwa.
labelNon ki parèt devan pwopriyetè a.
hintKote pou jwenn valè a.
requiredLè li true, execute refize lanse eskript konpetans lan toutotan valè a pa defini. Pa defo false.

Yon anplwaye mete yon valè ak configure_skill. Ou ka fè referans ak yon sekrè nan kò a kòm ${secret.KEY}, men script yo ta dwe li varyab anviwònman an pito.

Varyab modèl

Nebo ranplase varyab sa yo nan kò a lè yon anplwaye chaje konpetans lan. Yo pa ranplase andedan lòt fichye; eskript yo li varyab anviwònman pito.

VaryabValè
${NEBO_SKILL_DIR}Chemen absoli dosye konpetans lan.
${NEBO_DATA_DIR}Yon dosye kote yo ka ekri pou konpetans sa a: <data>/appdata/skills/<name>. Li kreye premye fwa yo sèvi avè l.
${NEBO_USER_NAME}Non pwopriyetè a.
${NEBO_OS}Sistèm operasyon an.
${NEBO_ARCH}Achitekti pwosesè a.
${plugin.SLUG_BIN}Chemen binè yon plugin ki deklare. Slug la ekri an majiskil, ak tirè yo vin soulinyen: example-ledger vin ${plugin.EXAMPLE_LEDGER_BIN}.
${secret.KEY}Valè yon sekrè ki deklare.
$ARGUMENTSargs yo pase bay use_skill. Lè kò a pa gen $ARGUMENTS, agiman yo ajoute apre l.

Zouti konpetans

Anplwaye yo travay ak konpetans atravè zouti sa yo. use_skill toujou disponib; lòt yo chaje lè yon anplwaye bezwen yo.

ZoutiParamètSa li fè
use_skillname, argsChaje yon konpetans. Retounen kò a ak varyab yo ranplase, chemen dosye a ak 20 premye non fichye yo. Li reaktive yon konpetans ki te dezaktive.
find_skillsqueryRetounen jiska 10 konpetans ki klase daprè koresponn non, deklanchè ak deskripsyon.
read_skill_filename, pathLi yon fichye nan dosye konpetans lan. San path, li bay lis fichye yo ak gwosè yo.
save_skillname, contentEkri yon SKILL.md konplè nan dosye konpetans itilizatè a. Yo pa ka ekri sou konpetans makètplas.
delete_skillnameEfase yon konpetans itilizatè.
install_skillcodeEnstale yon konpetans makètplas avèk kòd enstalasyon SKIL- li.
configure_skillname, key, valueDefini yon sekrè. San key, li montre sa konpetans lan bezwen.
rate_skillname, rating, reviewBay yon konpetans makètplas nòt soti 1 rive 5.
read_skill_reviewsnameLi revizyon yon konpetans makètplas.
executeskill, script, args, timeoutLanse yon eskript ki nan dosye yon konpetans. Gade Espas izole eskript.

Espas izole eskript

Zouti execute la lanse yon eskript nan dosye yon konpetans. Li chwazi anviwònman egzekisyon an daprè fichye a.

EskriptAnviwònman egzekisyon
.pyPython, atravè uv ki enkli nan Nebo lè li la, sinon python3.
.ts, .jsBun ki enkli nan Nebo lè li la, sinon node.
bin/<file> oswa binaryLanse dirèkteman.
.shPa sipòte.

Chak egzekisyon kòmanse ak yon anviwònman vid ak varyab sa yo:

VaryabValè
SKILL_ARGSObjè args la an JSON.
Chak key sekrèValè sekrè a dechifre.
<PLUGIN>_BINChemen binè chak plugin ki deklare. Dosye plugin yo ajoute nan PATH tou.
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", []))}))

Eskript la mache nan yon kopi tanporè dosye konpetans lan, ak yon delè pa defo 30 segonn. Sou macOS ak Linux li mache nan yon espas izole sistèm operasyon an:

  • Li pa ka li magazen idantifyan, done navigatè ak trouso kle, ni paramèt ak baz done pa Nebo.
  • Li ka ekri sèlman nan dosye travay li ak /tmp/nebo. Kapasite storage la ajoute dosye done Nebo a.
  • Li pa gen aksè rezo. Kapasite network la pèmèt rejis pake yo ak domèn ki nan lis metadata.allowed_domains.

Fichye ak limit

ElemanRèg
ResousTout fichye apa SKILL.md, manifest.json, signatures.json ak fichye ki kòmanse ak pwen.
EgzekitabFichye ki anba scripts/ oswa bin/, ak yon fichye nan rasin lan ki rele binary.
ChemenRelatif ak dosye konpetans lan. Yo rejte chemen ki gen .. oswa ki soti deyò dosye a.
Konpetans dezaktiveYon dosye ki gen SKILL.md.disabled olye SKILL.md.
Lis konpetansChak antre koupe a 250 karaktè. Lè tout lis la depase 8 000 karaktè, yo redui konpetans pataje yo an premye; pwòp konpetans yon anplwaye kenbe antre konplè yo.

Limit pou fichye ou pibliye sou makètplas la nan paj Piblikasyon an.