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.
| Chan | Tip | Pa defo | Siyifikasyon |
|---|---|---|---|
name | string | obligatwa | Idantifyan. [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. |
description | string | obligatwa | Sa 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. |
version | string | "1.0.0" | Vèsyon semantik. Entèval requires lòt konpetans yo verifye l. Mete l ant gimè. |
triggers | lis 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. |
platform | lis chèn karaktè | tout | macos, linux, windows. Konpetans lan chaje sèlman kote youn koresponn. |
capabilities | lis chèn karaktè | [] | network ak storage elaji espas izole eskript la. Gade Espas izole eskript. |
metadata | map | {} | Kenbe secrets ak allowed_domains. Gade anba a. |
requires | lis {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 "*". |
plugins | lis {name, version, optional} | [] | Plugin konpetans sa a sèvi ak yo. version pa defo se "*", optional pa defo se false. |
dependencies | lis chèn karaktè | [] | Non kout konpetans ki dwe la. |
priority | integer | 0 | Mete konpetans yo nan lòd nan lis jesyon yo. Sa pa chanje ki konpetans yon anplwaye chwazi. |
author | string | "" | Anrejistre pou afichaj. |
license | string | "" | Anrejistre pou afichaj. |
compatibility | string | "" | Nòt tèks lib, 500 okte pou pi plis. |
tags | lis chèn karaktè | [] | Anrejistre pou afichaj. |
allowed-tools | string | "" | 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 | Kle | Siyifikasyon |
|---|---|
key | Non varyab anviwònman eskript la resevwa. Obligatwa. |
label | Non ki parèt devan pwopriyetè a. |
hint | Kote pou jwenn valè a. |
required | Lè 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.
| Varyab | Valè |
|---|---|
${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. |
$ARGUMENTS | args 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.
| Zouti | Paramèt | Sa li fè |
|---|---|---|
use_skill | name, args | Chaje 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_skills | query | Retounen jiska 10 konpetans ki klase daprè koresponn non, deklanchè ak deskripsyon. |
read_skill_file | name, path | Li yon fichye nan dosye konpetans lan. San path, li bay lis fichye yo ak gwosè yo. |
save_skill | name, content | Ekri yon SKILL.md konplè nan dosye konpetans itilizatè a. Yo pa ka ekri sou konpetans makètplas. |
delete_skill | name | Efase yon konpetans itilizatè. |
install_skill | code | Enstale yon konpetans makètplas avèk kòd enstalasyon SKIL- li. |
configure_skill | name, key, value | Defini yon sekrè. San key, li montre sa konpetans lan bezwen. |
rate_skill | name, rating, review | Bay yon konpetans makètplas nòt soti 1 rive 5. |
read_skill_reviews | name | Li revizyon yon konpetans makètplas. |
execute | skill, script, args, timeout | Lanse 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.
| Eskript | Anviwònman egzekisyon |
|---|---|
.py | Python, atravè uv ki enkli nan Nebo lè li la, sinon python3. |
.ts, .js | Bun ki enkli nan Nebo lè li la, sinon node. |
bin/<file> oswa binary | Lanse dirèkteman. |
.sh | Pa sipòte. |
Chak egzekisyon kòmanse ak yon anviwònman vid ak varyab sa yo:
| Varyab | Valè |
|---|---|
SKILL_ARGS | Objè args la an JSON. |
Chak key sekrè | Valè sekrè a dechifre. |
<PLUGIN>_BIN | Chemen 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. Kapasitestoragela ajoute dosye done Nebo a. - Li pa gen aksè rezo. Kapasite
networkla pèmèt rejis pake yo ak domèn ki nan lismetadata.allowed_domains.
Fichye ak limit
| Eleman | Règ |
|---|---|
| Resous | Tout fichye apa SKILL.md, manifest.json, signatures.json ak fichye ki kòmanse ak pwen. |
| Egzekitab | Fichye ki anba scripts/ oswa bin/, ak yon fichye nan rasin lan ki rele binary. |
| Chemen | Relatif ak dosye konpetans lan. Yo rejte chemen ki gen .. oswa ki soti deyò dosye a. |
| Konpetans dezaktive | Yon dosye ki gen SKILL.md.disabled olye SKILL.md. |
| Lis konpetans | Chak 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.