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.
| Kora | Mba'éichagua | Ijypykuéva | He'iséva |
|---|---|---|---|
name | string | tekotevẽ | 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. |
description | string | tekotevẽ | 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. |
version | string | "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 lista | opavave | macos, linux, windows. Katupyry ojehupi peteĩ ojojahápe añoite. |
capabilities | ñe'ẽjoaju lista | [] | network ha storage ombotuichave script sandbox. Ehecha Script sandbox. |
metadata | map | {} | 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ã. |
priority | integer | 0 | Omohenda katupyry ñemboguata lista-kuérape. Noñeme'ẽi mba'e katupyrýpa oiporavo peteĩ mba'apohára. |
author | string | "" | Oñeñongatu ojehechauka hag̃ua. |
license | string | "" | Oñeñongatu ojehechauka hag̃ua. |
compatibility | string | "" | Jehaipy sãso, 500 byte peve. |
tags | ñe'ẽjoaju lista | [] | Oñeñongatu ojehechauka hag̃ua. |
allowed-tools | string | "" | 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 | Clave | He'iséva |
|---|---|
key | Variable de entorno réra script ohupytýva. Tekotevẽ. |
label | Téra ojehechaukáva járape. |
hint | Moõpa ojehupyty valor. |
required | true 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.
| Variable | Valor |
|---|---|
${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. |
$ARGUMENTS | args 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.
| Tembiporu | Parámetro-kuéra | Mba'épa ojapo |
|---|---|---|
use_skill | name, args | Ohupi peteĩ katupyry. Ome'ẽjey rete omyasãimava, ñongatuha rape ha 20 marandurenda réra peteĩha. Omyendyjey peteĩ katupyry oñembogue vaekue. |
find_skills | query | Ome'ẽjey 10 katupyry peve oñemohendáva réra, mbopu'ãha ha ñemyesakã ojojávare. |
read_skill_file | name, path | Omoñe'ẽ peteĩ marandurenda katupyry ñongatuhápe. path'ỹre, ohechauka marandurenda-kuéra ha itamaño. |
save_skill | name, content | Ohai peteĩ SKILL.md henyhẽva puruhára katupyry ñongatuhápe. Katupyry ñemuhagua ndaikatúi ojehaijey hi'ári. |
delete_skill | name | Oipe'a peteĩ katupyry puruhára mba'éva. |
install_skill | code | Omohenda peteĩ katupyry ñemuhagua ikódigo ñemohenda SKIL- rupive. |
configure_skill | name, key, value | Omoĩ peteĩ secreto. key'ỹre, ohechauka mba'épa katupyry oikotevẽ. |
rate_skill | name, rating, review | Ome'ẽ peteĩ katupyry ñemuhaguápe puntaje 1 guive 5 peve. |
read_skill_reviews | name | Omoñe'ẽ peteĩ katupyry ñemuhagua ñehesa'ỹijo-kuéra. |
execute | skill, script, args, timeout | Omomba'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.
| Script | Runtime |
|---|---|
.py | Python, uv Nebo ogueraháva rupive oĩ jave, ndaupéichairõ python3. |
.ts, .js | Bun Nebo ogueraháva oĩ jave, ndaupéichairõ node. |
bin/<file> térã binary | Omba'apo pya'e. |
.sh | Noñeipytyvõi. |
Peteĩteĩ jeporu oñepyrũ peteĩ entorno nandi ha ko'ã variable ndive:
| Variable | Valor |
|---|---|
SKILL_ARGS | Objeto args JSON ramo. |
Peteĩteĩ secreto key | Secreto valor oñemosãmava código-gui. |
<PLUGIN>_BIN | Peteĩ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'akastorageombojoapy Nebo datos ñongatuha. - Ndorekói ñandutí jeike. Pu'aka
networkomoneĩ paquete registro ha dominio ojehechaukávametadata.allowed_domains-pe.
Marandurenda ha ijapyra
| Mba'e | Léi |
|---|---|
| Mba'erepy-kuéra | Opa marandurenda, ndaha'éiramo SKILL.md, manifest.json, signatures.json ha dotfile. |
| Ejecutable-kuéra | Marandurenda oĩva scripts/ térã bin/ guýpe, ha peteĩ marandurenda raíz-pe héra binary. |
| Rape-kuéra | Katupyry ñongatuha rehe. Rape oguerekóva .. térã osẽva ñongatuhágui oñemboyke. |
| Katupyry oñemboguéva | Peteĩ ñongatuha oguerekóva SKILL.md.disabled SKILL.md rendaguépe. |
| Katupyry lista | Peteĩ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.