NeboAI
NeboAI
Malite

Ntụaka SKILL.md

Ibe a na-edepụta akụkụ ọ bụla nke nka Nebo na-agụ: mpaghara frontmatter, mgbanwe ọ na-agbasa, ngwaọrụ ndị ọrụ na-eji arụ ọrụ na nka, na gburugburu script na-agba n'ime ya.

Ụdị faịlụ

SKILL.md bụ ederede UTF-8. Ọ na-amalite site n'ahịrị nwere hyphen atọ, wee frontmatter YAML, wee ahịrị mmechi nwere hyphen atọ. Ihe niile na-esote ya bụ ahụ: ntuziaka Markdown onye ọrụ na-anata mgbe o bulitere nka ahụ. Nebo na-achọta faịlụ ahụ site n'aha ya n'eleghị mkpụrụedemede ukwu ma ọ bụ nta anya.

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

Mpaghara frontmatter

Ọ bụ naanị name na description ka a chọrọ. Mpaghara nwere ụdị na-ezighị ezi na-eme ka faịlụ ahụ dum daa, ya mere nka ahụ anaghị ebulite. A na-eleghara igodo na-adịghị ebe a anya.

MpagharaỤdịNdabaraIhe ọ pụtara
namestringa chọrọ yaNjirimara. [a-z0-9-], enweghị hyphen na mmalite, na njedebe ma ọ bụ hyphen abụọ, ọ karịghị bytes 64. Mee ka o dabara n'aha folda ahụ.
descriptionstringa chọrọ yaIhe nka ahụ na-eme na mgbe a ga-eji ya. Ọ karịghị bytes 1,024. A na-egosi ya na ndepụta nka onye ọrụ ma find_skills na-enye ya akara.
versionstring"1.0.0"Ụdị semantic. Oke requires nke nka ndị ọzọ na-enyocha ya. Tinye ya n'ime akara nkwuputa.
triggersndepụta eriri okwu[]Okwu na nkebi ahịrịokwu na-akọwa mgbe nka ahụ dabara. Ruo atọ na-apụta na ndepụta nka; ha niile na-agụ na find_skills. Ha anaghị ebulite nka n'onwe ha.
platformndepụta eriri okwuniilemacos, linux, windows. Nka ahụ na-ebulite naanị ebe otu dabara.
capabilitiesndepụta eriri okwu[]network na storage na-agbasa sandbox script. Lee Sandbox script.
metadatamap{}Na-ejide secrets na allowed_domains. Lee n'okpuru.
requiresndepụta {name, version}[]Nka ndị ọzọ nka a na-ewulite na ha. name bụ aha mkpirikpi nka ahụ; version bụ oke semver, ndabara "*".
pluginsndepụta {name, version, optional}[]Plugin nka a na-eji. version na-adị "*" site na ndabara, optional na-adị false.
dependenciesndepụta eriri okwu[]Aha mkpirikpi nke nka ndị ga-adịrịrị.
priorityinteger0Na-ahazi usoro nka na ndepụta njikwa. Ọ naghị emetụta nka onye ọrụ na-ahọrọ.
authorstring""A na-echekwa ya maka ngosi.
licensestring""A na-echekwa ya maka ngosi.
compatibilitystring""Ndetu ederede efu, ọ karịghị bytes 500.
tagsndepụta eriri okwu[]A na-echekwa ya maka ngosi.
allowed-toolsstring""Eriri okwu e ji oghere kewaa. A na-echekwa ya; a naghị amanye ya.

Mgbe nka a kpọrọ aha na requires ma ọ bụ dependencies na-efu ma ọ bụ nọ n'èzí oke ahụ, ma ọ bụ e wụnyeghị plugin a chọrọ, nka ahụ ka na-ebulite ma e kaa ya akara dị ka nke na-ezughị oke. Onye nwe ya na-ahụ ihe na-efu.

Ihe nzuzo

Kwupụta nzere script nka chọrọ n'okpuru metadata.secrets. Onye nwe ya na-enye uru ndị ahụ, Nebo na-echekwakwa ha n'ezoro ezo maka nka ahụ.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
IgodoIhe ọ pụtara
keyAha mgbanwe gburugburu script ahụ na-anata. A chọrọ ya.
labelAha a na-egosi onye nwe ya.
hintEbe a ga-esi nweta uru ahụ.
requiredMgbe ọ bụ true, execute na-ajụ ịgba script nka ahụ ruo mgbe e tinyere uru ahụ. Ndabara bụ false.

Onye ọrụ na-edebe uru site na configure_skill. Ị nwere ike ịkpọ ihe nzuzo n'ime ahụ dịka ${secret.KEY}, mana script kwesịrị ịgụ environment variable kama.

Mgbanwe ndebiri

Nebo na-edochi mgbanwe ndị a n'ime ahụ mgbe onye ọrụ bulitere nka ahụ. A naghị edochi ha n'ime faịlụ ndị ọzọ; script na-agụ mgbanwe gburugburu kama.

MgbanweUru
${NEBO_SKILL_DIR}Ụzọ zuru ezu nke folda nka ahụ.
${NEBO_DATA_DIR}Folda enwere ike ide ihe na ya maka nka a: <data>/appdata/skills/<name>. A na-emepụta ya mgbe mbụ e ji ya.
${NEBO_USER_NAME}Aha onye nwe ya.
${NEBO_OS}Sistemụ arụmọrụ.
${NEBO_ARCH}Ụkpụrụ processor.
${plugin.SLUG_BIN}Ụzọ binary nke plugin e kwupụtara. A na-ede slug ahụ na mkpụrụedemede ukwu, ebe hyphen ghọrọ underscore: example-ledger na-aghọ ${plugin.EXAMPLE_LEDGER_BIN}.
${secret.KEY}Uru nke ihe nzuzo e kwupụtara.
$ARGUMENTSargs e nyefere use_skill. Mgbe ahụ ahụ enweghị $ARGUMENTS, a na-agbakwunye arụmụka ndị ahụ mgbe ya gachara.

Ngwaọrụ nka

Ndị ọrụ na-eji ngwaọrụ ndị a arụ ọrụ na nka. use_skill na-adị mgbe niile; ndị ọzọ na-ebulite mgbe onye ọrụ chọrọ ha.

NgwaọrụParamitaIhe ọ na-eme
use_skillname, argsNa-ebulite nka. Na-eweghachi ahụ a gbasara agbasa, ụzọ folda, na aha faịlụ 20 mbụ. Na-agbanyeghachi nka a gbanyụrụ agbanyụ.
find_skillsqueryNa-eweghachi nka ruo 10 e debere n'usoro site n'ndakọrịta aha, ihe mkpalite na nkọwa.
read_skill_filename, pathNa-agụ faịlụ dị na folda nka ahụ. Na-enweghị path, ọ na-edepụta faịlụ ndị ahụ na nha ha.
save_skillname, contentNa-ede SKILL.md zuru ezu na folda nka onye ọrụ. Enweghị ike ide n'elu nka ahịa.
delete_skillnameNa-ehichapụ nka onye ọrụ.
install_skillcodeNa-awụnye nka ahịa site na koodu nwụnye SKIL- ya.
configure_skillname, key, valueNa-etinye ihe nzuzo. Na-enweghị key, ọ na-egosi ihe nka ahụ chọrọ.
rate_skillname, rating, reviewNa-enye nka ahịa akara site na 1 ruo 5.
read_skill_reviewsnameNa-agụ nyocha nka ahịa.
executeskill, script, args, timeoutNa-agba script site na folda nka. Lee Sandbox script.

Sandbox script

Ngwaọrụ execute na-agba otu script site na folda nka. Ọ na-ahọrọ runtime site na faịlụ ahụ.

ScriptRuntime
.pyPython, site na uv e kechiri ọnụ na Nebo mgbe ọ dị, ma ọ bụghị ya python3.
.ts, .jsBun e kechiri ọnụ na Nebo mgbe ọ dị, ma ọ bụghị ya node.
bin/<file> ma ọ bụ binaryGbaa ya ozugbo.
.shA naghị akwado ya.

Ọgba ọ bụla na-amalite site na gburugburu efu na mgbanwe ndị a:

MgbanweUru
SKILL_ARGSIhe args dị ka JSON.
key ihe nzuzo ọ bụlaUru ihe nzuzo e mepere emepe.
<PLUGIN>_BINỤzọ binary nke plugin ọ bụla e kwupụtara. A na-agbakwunyekwa folda plugin na PATH.
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", []))}))

Script ahụ na-agba n'otu oyiri nwa oge nke folda nka ahụ, nwere oge njedebe ndabara nke sekọnd 30. Na macOS na Linux, ọ na-agba n'ime sandbox sistemụ arụmọrụ:

  • Ọ nweghị ike ịgụ ebe nchekwa nzere, data ihe nchọgharị na keychain, ma ọ bụ ntọala na ọdụ data nke Nebo n'onwe ya.
  • Ọ nwere ike ide naanị na folda ọrụ ya na /tmp/nebo. Ikike storage na-agbakwunye folda data nke Nebo.
  • O nweghị ịnweta netwọk. Ikike network na-ekwe ndekọ ngwugwu na ngalaba e depụtara na metadata.allowed_domains.

Faịlụ na oke

IheIwu
AkụrụngwaFaịlụ ọ bụla ma e wepụ SKILL.md, manifest.json, signatures.json na dotfiles.
Ihe a na-agbaFaịlụ dị n'okpuru scripts/ ma ọ bụ bin/, na faịlụ mgbọrọgwụ a kpọrọ binary.
ỤzọỌ dabere na folda nka ahụ. A na-ajụ ụzọ nwere .. ma ọ bụ ndị na-agbapụ n'èzí folda ahụ.
Nka a gbanyụrụ agbanyụFolda nwere SKILL.md.disabled kama SKILL.md.
Ndepụta nkaA na-ebipụ ndenye ọ bụla na mkpụrụedemede 250. Mgbe ndepụta ahụ dum karịrị mkpụrụedemede 8,000, a na-ebu ụzọ mee ka nka a na-ekerịta dị mkpụmkpụ; nka onye ọrụ n'onwe ya na-edebe ndenye ha zuru ezu.

Oke maka faịlụ ị na-ebipụta n'ahịa dị na ibe Mbipụta.