NeboAI
NeboAI
Magsimula

Reference ng SKILL.md

Nakalista sa page na ito ang bawat bahagi ng skill na binabasa ng Nebo: ang mga frontmatter field, ang mga variable na pinapalawak nito, ang mga tool na ginagamit ng mga empleyado sa mga skill, at ang environment kung saan tumatakbo ang mga script.

Format ng file

Ang SKILL.md ay UTF-8 na text. Nagsisimula ito sa linya ng tatlong gitling, saka YAML frontmatter, saka isang pansarang linya ng tatlong gitling. Lahat ng kasunod niyon ay ang body: mga Markdown instruction na natatanggap ng empleyado kapag nilo-load nito ang skill. Hinahanap ng Nebo ang file ayon sa pangalan nang hindi pinapansin ang laki ng titik.

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

Mga frontmatter field

Ang name at description lang ang kailangan. Ang field na mali ang uri ay nagpapapalya sa buong file, kaya hindi nilo-load ang skill. Binabalewala ang mga key na hindi nakalista rito.

FieldUriDefaultKahulugan
namestringkailanganIdentifier. [a-z0-9-], walang gitling sa simula, sa dulo o magkasunod, hanggang 64 bytes. Itugma sa pangalan ng folder.
descriptionstringkailanganKung ano ang ginagawa ng skill at kailan ito gagamitin. Hanggang 1,024 bytes. Ipinapakita sa listahan ng skill ng empleyado at binibigyan ng score ng find_skills.
versionstring"1.0.0"Semantic version. Sinusuri ng mga requires range ng ibang skill. Lagyan ito ng quote.
triggerslistahan ng mga string[]Mga salita at parirala na naglalarawan kung kailan angkop ang skill. Hanggang tatlo ang lumalabas sa listahan ng skill; lahat ay binibilang sa find_skills. Hindi nila kailanman nilo-load ang skill nang mag-isa.
platformlistahan ng mga stringlahatmacos, linux, windows. Nilo-load lang ang skill kung saan may tumutugma.
capabilitieslistahan ng mga string[]Pinalalawak ng network at storage ang script sandbox. Tingnan ang Sandbox ng script.
metadatamap{}Naglalaman ng secrets at allowed_domains. Tingnan sa ibaba.
requireslistahan ng {name, version}[]Iba pang skill na pinagbabatayan ng skill na ito. Ang name ay ang maikling pangalan ng skill; ang version ay isang semver range, default na "*".
pluginslistahan ng {name, version, optional}[]Mga plugin na ginagamit ng skill na ito. Default ng version ang "*", ng optional ang false.
dependencieslistahan ng mga string[]Mga maikling pangalan ng mga skill na dapat naroon.
priorityinteger0Nag-aayos ng mga skill sa mga management list. Hindi nito naaapektuhan kung aling skill ang pipiliin ng empleyado.
authorstring""Itinatago para sa display.
licensestring""Itinatago para sa display.
compatibilitystring""Malayang tala, hanggang 500 bytes.
tagslistahan ng mga string[]Itinatago para sa display.
allowed-toolsstring""Isang string na pinaghihiwalay ng space. Itinatago; hindi ipinapatupad.

Kapag nawawala o labas sa range ang isang skill na binanggit sa requires o dependencies, o hindi naka-install ang isang kailangang plugin, nilo-load pa rin ang skill at minamarkahang degraded. Nakikita ng may-ari kung ano ang kulang.

Mga secret

Ideklara ang mga credential na kailangan ng mga script ng skill sa ilalim ng metadata.secrets. Ang may-ari ang nagbibigay ng mga value, at iniimbak ito ng Nebo nang naka-encrypt para sa skill na iyon.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
KeyKahulugan
keyPangalan ng environment variable na natatanggap ng script. Kailangan.
labelPangalang ipinapakita sa may-ari.
hintKung saan kukunin ang value.
requiredKapag true, tumatanggi ang execute na patakbuhin ang mga script ng skill hangga't hindi naitatakda ang value. Default ay false.

Nagtatakda ang empleyado ng value gamit ang configure_skill. Puwede kang tumukoy ng secret sa body bilang ${secret.KEY}, pero dapat basahin ng mga script ang environment variable sa halip.

Mga template variable

Pinapalitan ng Nebo ang mga variable na ito sa body kapag nilo-load ng empleyado ang skill. Hindi sila pinapalitan sa loob ng ibang file; environment variable ang binabasa ng mga script.

VariableValue
${NEBO_SKILL_DIR}Absolute path ng folder ng skill.
${NEBO_DATA_DIR}Isang folder na masusulatan para sa skill na ito: <data>/appdata/skills/<name>. Ginagawa sa unang paggamit.
${NEBO_USER_NAME}Ang pangalan ng may-ari.
${NEBO_OS}Ang operating system.
${NEBO_ARCH}Ang architecture ng processor.
${plugin.SLUG_BIN}Path ng binary ng isang idineklarang plugin. Ginagawang uppercase ang slug, at ginagawang underscore ang mga gitling: nagiging ${plugin.EXAMPLE_LEDGER_BIN} ang example-ledger.
${secret.KEY}Ang value ng isang idineklarang secret.
$ARGUMENTSAng args na ipinasa sa use_skill. Kapag walang $ARGUMENTS ang body, idinudugtong ang mga argument pagkatapos nito.

Mga skill tool

Gumagana ang mga empleyado sa mga skill sa pamamagitan ng mga tool na ito. Laging available ang use_skill; nilo-load ang iba kapag kailangan ng empleyado.

ToolMga parameterGinagawa nito
use_skillname, argsNilo-load ang isang skill. Ibinabalik ang pinalawak na body, ang path ng folder, at ang unang 20 pangalan ng file. Ine-enable ulit ang naka-disable na skill.
find_skillsqueryNagbabalik ng hanggang 10 skill na niraranggo ayon sa tugma sa pangalan, trigger at description.
read_skill_filename, pathBinabasa ang isang file sa folder ng skill. Kapag walang path, inililista ang mga file at ang laki nila.
save_skillname, contentIsinusulat ang kumpletong SKILL.md sa user skills folder. Hindi mapapatungan ang mga marketplace skill.
delete_skillnameBinubura ang isang user skill.
install_skillcodeIni-install ang isang marketplace skill mula sa SKIL- install code nito.
configure_skillname, key, valueNagtatakda ng secret. Kapag walang key, ipinapakita kung ano ang kailangan ng skill.
rate_skillname, rating, reviewNire-rate ang isang marketplace skill mula 1 hanggang 5.
read_skill_reviewsnameBinabasa ang mga review ng isang marketplace skill.
executeskill, script, args, timeoutNagpapatakbo ng script mula sa folder ng skill. Tingnan ang Sandbox ng script.

Sandbox ng script

Pinapatakbo ng tool na execute ang isang script mula sa folder ng skill. Pinipili nito ang runtime batay sa file.

ScriptRuntime
.pyPython, sa pamamagitan ng kasamang uv ng Nebo kapag naroon, kung hindi ay python3.
.ts, .jsAng kasamang Bun ng Nebo kapag naroon, kung hindi ay node.
bin/<file> o binaryDirektang pinapatakbo.
.shHindi sinusuportahan.

Nagsisimula ang bawat run sa blangkong environment at sa mga variable na ito:

VariableValue
SKILL_ARGSAng object na args bilang JSON.
Bawat key ng secretAng na-decrypt na value ng secret.
<PLUGIN>_BINPath ng binary ng bawat idineklarang plugin. Idinadagdag din sa PATH ang mga folder ng plugin.
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", []))}))

Tumatakbo ang script sa pansamantalang kopya ng folder ng skill, na may default na timeout na 30 segundo. Sa macOS at Linux, tumatakbo ito sa sandbox ng operating system:

  • Hindi nito mababasa ang mga credential store, data ng browser at keychain, o ang sariling settings at database ng Nebo.
  • Sa working folder nito at sa /tmp/nebo lang ito makakasulat. Idinadagdag ng capability na storage ang data folder ng Nebo.
  • Wala itong network access. Pinapayagan ng capability na network ang mga package registry at ang mga domain na nakalista sa metadata.allowed_domains.

Mga file at limit

ItemPatakaran
Mga resourceBawat file maliban sa SKILL.md, manifest.json, signatures.json at mga dotfile.
Mga executableMga file sa ilalim ng scripts/ o bin/, at isang root file na pinangalanang binary.
Mga pathRelative sa folder ng skill. Tinatanggihan ang mga path na may .. o lumalabas sa folder.
Naka-disable na skillIsang folder na may SKILL.md.disabled sa halip na SKILL.md.
Listahan ng skillPinuputol sa 250 character ang bawat entry. Kapag lumampas sa 8,000 character ang buong listahan, ang mga shared na skill ang unang pinaiikli; buo pa rin ang entry ng sariling mga skill ng empleyado.

Nasa page na Publishing ang mga limit para sa mga file na pina-publish mo sa marketplace.