NeboAI
NeboAI
Eñepyrũ

SKILL.md rehegua

Ko kuatiarogue ohechauka opa pehẽngue peteĩ katupyry reheguáva Nebo omoñe'ẽva: kora frontmatter rehegua, variable omyasãiva, tembiporu mba'apoharakuéra oipurúva omba'apo hag̃ua katupyry ndive, ha entorno omba'apohápe script-kuéra.

Marandurenda formato

SKILL.md ha'e moñe'ẽrã UTF-8. Oñepyrũ peteĩ tysýi mbohapy guion reheguáva ndive, upéi frontmatter YAML, upéi peteĩ tysýi omboty'ýva mbohapy guion ndive. Opa mba'e upe rire ha'e rete: mbo'epy Markdown mba'apohára ohupytýva katupyry ohupi jave. Nebo ojuhu marandurenda héra rupive, letra tuicha térã michĩ rehe oma'ẽ'ỹre.

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

Kora frontmatter rehegua

name ha description añoite tekotevẽ. Peteĩ kora tipo ivaíva ombyai marandurenda tuichakue, upévare katupyry nohupíri. Clave ndojehechaukáiva ko'ápe noñeñangarekói.

KoraMba'éichaguaIjypykuévaHe'iséva
namestringtekotevẽMba'ehechaukaha. [a-z0-9-], ndaipóri guion ñepyrũme, pahápe térã mokõi oñondive, 64 byte peve. Ojojava'erã ñongatuha réra ndive.
descriptionstringtekotevẽMba'épa ojapo katupyry ha araka'épa ojeporu. 1.024 byte peve. Ojehechauka mba'apohára katupyry listápe ha find_skills ome'ẽ chupe puntaje.
versionstring"1.0.0"Peteĩchagua semántica. Ambue katupyry rango requires ohecha. Emoĩ comilla ryepýpe.
triggersñe'ẽjoaju lista[]Ñe'ẽ ha ñe'ẽjoaju omombe'úva araka'épa katupyry oñeikotevẽ. Mbohapy peve ojehechauka katupyry listápe; opavave oñemombe'u find_skills-pe. Araka'eve nohupíri peteĩ katupyry ijeheguíne.
platformñe'ẽjoaju listaopavavemacos, linux, windows. Katupyry ojehupi peteĩ ojojahápe añoite.
capabilitiesñe'ẽjoaju lista[]network ha storage ombotuichave script sandbox. Ehecha Script sandbox.
metadatamap{}Oguereko secrets ha allowed_domains. Ehecha iguýpe.
requires{name, version} lista[]Ambue katupyry ko katupyry ojopyhýva hese. name ha'e katupyry réra mbykymi; version ha'e peteĩ rango semver, ijypykuéva "*".
plugins{name, version, optional} lista[]Plugin ko katupyry oipurúva. version ijypykuéva ha'e "*", optional ha'e false.
dependenciesñe'ẽjoaju lista[]Katupyry réra mbykymi oĩva'erã.
priorityinteger0Omohenda katupyry ñemboguata lista-kuérape. Noñeme'ẽi mba'e katupyrýpa oiporavo peteĩ mba'apohára.
authorstring""Oñeñongatu ojehechauka hag̃ua.
licensestring""Oñeñongatu ojehechauka hag̃ua.
compatibilitystring""Jehaipy sãso, 500 byte peve.
tagsñe'ẽjoaju lista[]Oñeñongatu ojehechauka hag̃ua.
allowed-toolsstring""Peteĩ ñe'ẽjoaju espacio rupi oñemboja'óva. Oñeñongatu; ndojejapokatúi.

Peteĩ katupyry ojehechaukáva requires térã dependencies-pe ndaipóri jave térã oĩ rango okápe, térã peteĩ plugin tekotevẽva noñemohendái jave, katupyry ojehupi avei ha oñemarka degradado ramo. Jára ohecha mba'épa ofalta.

Secreto-kuéra

Emombe'u credencial peteĩ katupyry script-kuéra oikotevẽva metadata.secrets guýpe. Jára ome'ẽ valor-kuéra, ha Nebo oñongatu chupekuéra código-pe upe katupyrýpe g̃uarã.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
ClaveHe'iséva
keyVariable de entorno réra script ohupytýva. Tekotevẽ.
labelTéra ojehechaukáva járape.
hintMoõpa ojehupyty valor.
requiredtrue jave, execute nomomba'apói katupyry script-kuéra valor oñemoĩ peve. Ijypykuéva false.

Peteĩ mba'apohára omoĩ peteĩ valor configure_skill reheve. Ikatu rehenói peteĩ secreto ryepýpe ${secret.KEY} ramo, ha katu umi script omoñe'ẽ va'erã variable de entorno hendaguépe.

Variable plantilla rehegua

Nebo omyengovia ko'ã variable rete-pe peteĩ mba'apohára ohupi jave katupyry. Noñemyengoviái ambue marandurenda ryepýpe; script-kuéra omoñe'ẽ variable de entorno hendaguépe.

VariableValor
${NEBO_SKILL_DIR}Katupyry ñongatuha rape absoluto.
${NEBO_DATA_DIR}Peteĩ ñongatuha ikatúva ojehai ipype ko katupyrýpe g̃uarã: <data>/appdata/skills/<name>. Oñembosako'i ojeporu peteĩha jave.
${NEBO_USER_NAME}Jára réra.
${NEBO_OS}Sistema operativo.
${NEBO_ARCH}Procesador arquitectura.
${plugin.SLUG_BIN}Peteĩ plugin oñemombe'úva binario rape. Slug ojehai letra tuichávape, guion oiko guion guýpe: example-ledger oiko ${plugin.EXAMPLE_LEDGER_BIN}.
${secret.KEY}Peteĩ secreto oñemombe'úva valor.
$ARGUMENTSargs oñemondóva use_skill-pe. Rete ndorekói jave $ARGUMENTS, argumento-kuéra oñembojoapy upe rire.

Katupyry tembiporu

Mba'apoharakuéra omba'apo katupyry ndive ko'ã tembiporu rupive. use_skill oĩ akóinte; ambue ojehupi peteĩ mba'apohára oikotevẽ jave.

TembiporuParámetro-kuéraMba'épa ojapo
use_skillname, argsOhupi peteĩ katupyry. Ome'ẽjey rete omyasãimava, ñongatuha rape ha 20 marandurenda réra peteĩha. Omyendyjey peteĩ katupyry oñembogue vaekue.
find_skillsqueryOme'ẽjey 10 katupyry peve oñemohendáva réra, mbopu'ãha ha ñemyesakã ojojávare.
read_skill_filename, pathOmoñe'ẽ peteĩ marandurenda katupyry ñongatuhápe. path'ỹre, ohechauka marandurenda-kuéra ha itamaño.
save_skillname, contentOhai peteĩ SKILL.md henyhẽva puruhára katupyry ñongatuhápe. Katupyry ñemuhagua ndaikatúi ojehaijey hi'ári.
delete_skillnameOipe'a peteĩ katupyry puruhára mba'éva.
install_skillcodeOmohenda peteĩ katupyry ñemuhagua ikódigo ñemohenda SKIL- rupive.
configure_skillname, key, valueOmoĩ peteĩ secreto. key'ỹre, ohechauka mba'épa katupyry oikotevẽ.
rate_skillname, rating, reviewOme'ẽ peteĩ katupyry ñemuhaguápe puntaje 1 guive 5 peve.
read_skill_reviewsnameOmoñe'ẽ peteĩ katupyry ñemuhagua ñehesa'ỹijo-kuéra.
executeskill, script, args, timeoutOmomba'apo peteĩ script peteĩ katupyry ñongatuhágui. Ehecha Script sandbox.

Script sandbox

Tembiporu execute omomba'apo peteĩ script peteĩ katupyry ñongatuhágui. Oiporavo runtime marandurenda rupive.

ScriptRuntime
.pyPython, uv Nebo ogueraháva rupive oĩ jave, ndaupéichairõ python3.
.ts, .jsBun Nebo ogueraháva oĩ jave, ndaupéichairõ node.
bin/<file> térã binaryOmba'apo pya'e.
.shNoñeipytyvõi.

Peteĩteĩ jeporu oñepyrũ peteĩ entorno nandi ha ko'ã variable ndive:

VariableValor
SKILL_ARGSObjeto args JSON ramo.
Peteĩteĩ secreto keySecreto valor oñemosãmava código-gui.
<PLUGIN>_BINPeteĩteĩ plugin oñemombe'úva binario rape. Plugin ñongatuha oñembojoapy avei PATH-pe.
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 omba'apo peteĩ katupyry ñongatuha kópia sapy'aguápe, timeout ijypykuéva 30 segundo ndive. macOS ha Linux-pe omba'apo peteĩ sandbox sistema operativo reheguápe:

  • Ndaikatúi omoñe'ẽ credencial ñongatuha, navegador ha keychain datos, térã Nebo ñemboheko ha base de datos tee.
  • Ikatu ohai ijeheguíne iñongatuha omba'apohápe ha /tmp/nebo-pe añoite. Pu'aka storage ombojoapy Nebo datos ñongatuha.
  • Ndorekói ñandutí jeike. Pu'aka network omoneĩ paquete registro ha dominio ojehechaukáva metadata.allowed_domains-pe.

Marandurenda ha ijapyra

Mba'eLéi
Mba'erepy-kuéraOpa marandurenda, ndaha'éiramo SKILL.md, manifest.json, signatures.json ha dotfile.
Ejecutable-kuéraMarandurenda oĩva scripts/ térã bin/ guýpe, ha peteĩ marandurenda raíz-pe héra binary.
Rape-kuéraKatupyry ñongatuha rehe. Rape oguerekóva .. térã osẽva ñongatuhágui oñemboyke.
Katupyry oñemboguévaPeteĩ ñongatuha oguerekóva SKILL.md.disabled SKILL.md rendaguépe.
Katupyry listaPeteĩteĩ entrada oñekytĩ 250 carácter-pe. Lista tuichakue ohasa jave 8.000 carácter, katupyry oñemboja'opáva oñemombykyve raẽ; peteĩ mba'apohára katupyry tee oñongatu hentrada henyhẽva.

Marandurenda removerakuãva ñemuhápe ijapyra oĩ kuatiarogue Ñemoherakuã-pe.