NeboAI
NeboAI
Бастау

SKILL.md анықтамасы

Бұл бетте Nebo оқитын дағдының әр бөлігі көрсетілген: frontmatter өрістері, ол ашатын айнымалылар, қызметкерлер дағдылармен жұмыс істеу үшін пайдаланатын құралдар және скрипттер іске қосылатын орта.

Файл пішімі

SKILL.md — UTF-8 мәтіні. Ол үш сызықшадан тұратын жолдан басталады, одан кейін YAML frontmatter, содан соң үш сызықшадан тұратын жабу жолы келеді. Одан кейінгінің бәрі — дене: қызметкер дағдыны жүктегенде алатын Markdown нұсқаулары. Nebo файлды әріп регистріне қарамай аты бойынша табады.

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

Frontmatter өрістері

Тек name және description міндетті. Түрі қате өріс бүкіл файлды жарамсыз етеді, сондықтан дағды жүктелмейді. Мұнда көрсетілмеген кілттер еленбейді.

ӨрісТүріӘдепкіМағынасы
namestringміндеттіИдентификатор. [a-z0-9-], басында, соңында сызықша немесе қос сызықша жоқ, ең көбі 64 байт. Қалта атауымен сәйкес болсын.
descriptionstringміндеттіДағдының не істейтіні және оны қашан пайдалану керегі. Ең көбі 1 024 байт. Қызметкердің дағдылар тізімінде көрсетіледі және find_skills арқылы бағаланады.
versionstring"1.0.0"Семантикалық нұсқа. Басқа дағдылардың requires ауқымдары арқылы тексеріледі. Тырнақшаға алыңыз.
triggersжолдар тізімі[]Дағдының қашан қолданылатынын сипаттайтын сөздер мен тіркестер. Ең көбі үшеуі дағдылар тізімінде көрінеді; find_skills ішінде бәрі ескеріледі. Олар дағдыны ешқашан өздігінен жүктемейді.
platformжолдар тізімібарлығыmacos, linux, windows. Дағды тек біреуі сәйкес келетін жерде жүктеледі.
capabilitiesжолдар тізімі[]network және storage скрипт құмсалғышын кеңейтеді. «Скрипт құмсалғышы» бөлімін қараңыз.
metadatamap{}secrets және allowed_domains мәндерін қамтиды. Төменде қараңыз.
requires{name, version} тізімі[]Бұл дағды негізделетін басқа дағдылар. name — дағдының қысқа атауы; version — semver ауқымы, әдепкі мәні "*".
plugins{name, version, optional} тізімі[]Бұл дағды пайдаланатын плагиндер. version әдепкі мәні — "*", optional — false.
dependenciesжолдар тізімі[]Міндетті түрде болуы керек дағдылардың қысқа атаулары.
priorityinteger0Басқару тізімдеріндегі дағдылардың ретін белгілейді. Қызметкердің қай дағдыны таңдайтынына әсер етпейді.
authorstring""Көрсету үшін сақталады.
licensestring""Көрсету үшін сақталады.
compatibilitystring""Еркін мәтінді ескертпе, ең көбі 500 байт.
tagsжолдар тізімі[]Көрсету үшін сақталады.
allowed-toolsstring""Бос орынмен бөлінген жол. Сақталады; міндетті түрде орындалмайды.

requires немесе dependencies ішінде аталған дағды жоқ болса немесе ауқымнан тыс болса, не міндетті плагин орнатылмаса, дағды бәрібір жүктеледі және шектеулі деп белгіленеді. Иесі ненің жетіспейтінін көреді.

Құпиялар

Дағды скрипттеріне қажетті тіркелгі деректерін metadata.secrets астында жариялаңыз. Мәндерді иесі береді, ал Nebo оларды сол дағды үшін шифрланған күйде сақтайды.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
КілтМағынасы
keyСкрипт алатын орта айнымалысының атауы. Міндетті.
labelИесіне көрсетілетін атау.
hintМәнді қайдан алуға болатыны.
requiredtrue болғанда мән орнатылмайынша execute дағды скрипттерін іске қосудан бас тартады. Әдепкі мәні — false.

Қызметкер мәнді configure_skill арқылы орнатады. Құпияға мәтінде ${secret.KEY} түрінде сілтеме жасай аласыз, бірақ скрипттер оның орнына орта айнымалысын оқығаны дұрыс.

Үлгі айнымалылары

Қызметкер дағдыны жүктегенде Nebo денедегі осы айнымалыларды ауыстырады. Олар басқа файлдардың ішінде ауыстырылмайды; скрипттер оның орнына орта айнымалыларын оқиды.

АйнымалыМәні
${NEBO_SKILL_DIR}Дағды қалтасының абсолютті жолы.
${NEBO_DATA_DIR}Осы дағдыға арналған жазуға болатын қалта: <data>/appdata/skills/<name>. Алғаш пайдаланғанда жасалады.
${NEBO_USER_NAME}Иесінің аты.
${NEBO_OS}Операциялық жүйе.
${NEBO_ARCH}Процессор архитектурасы.
${plugin.SLUG_BIN}Жарияланған плагиннің бинарлық файлына апаратын жол. Slug бас әріппен жазылады, сызықшалар астыңғы сызыққа ауыстырылады: example-ledger мәні ${plugin.EXAMPLE_LEDGER_BIN} болады.
${secret.KEY}Жарияланған құпияның мәні.
$ARGUMENTSuse_skill құралына берілген args. Денеде $ARGUMENTS жоқ болса, аргументтер оның соңына қосылады.

Дағды құралдары

Қызметкерлер дағдылармен осы құралдар арқылы жұмыс істейді. use_skill әрқашан қолжетімді; қалғандары қызметкерге қажет болғанда жүктеледі.

ҚұралПараметрлерНе істейді
use_skillname, argsДағдыны жүктейді. Ашылған денені, қалта жолын және алғашқы 20 файл атауын қайтарады. Өшірілген дағдыны қайта қосады.
find_skillsqueryАтау, триггер және сипаттама сәйкестіктері бойынша саралап, ең көбі 10 дағды қайтарады.
read_skill_filename, pathДағды қалтасындағы файлды оқиды. path болмаса, файлдар мен олардың өлшемдерін тізіп көрсетеді.
save_skillname, contentТолық SKILL.md файлын пайдаланушы дағдылары қалтасына жазады. Маркетплейс дағдыларын қайта жазу мүмкін емес.
delete_skillnameПайдаланушы дағдысын жояды.
install_skillcodeМаркетплейстегі дағдыны оның SKIL- орнату коды арқылы орнатады.
configure_skillname, key, valueҚұпияны орнатады. key болмаса, дағдыға не қажет екенін көрсетеді.
rate_skillname, rating, reviewМаркетплейстегі дағдыны 1-ден 5-ке дейін бағалайды.
read_skill_reviewsnameМаркетплейстегі дағдының пікірлерін оқиды.
executeskill, script, args, timeoutДағды қалтасындағы скриптті іске қосады. «Скрипт құмсалғышы» бөлімін қараңыз.

Скрипт құмсалғышы

execute құралы дағды қалтасынан бір скриптті іске қосады. Ол орындау ортасын файлға қарап таңдайды.

СкриптОрындау ортасы
.pyPython, бар болса, Nebo-мен бірге жеткізілетін uv арқылы, әйтпесе python3.
.ts, .jsБар болса, Nebo-мен бірге жеткізілетін Bun, әйтпесе node.
bin/<file> немесе binaryТікелей іске қосылады.
.shҚолдау көрсетілмейді.

Әр іске қосу бос ортадан және мына айнымалылардан басталады:

АйнымалыМәні
SKILL_ARGSJSON түріндегі args объектісі.
Әр құпия keyШифры ашылған құпия мәні.
<PLUGIN>_BINЖарияланған әр плагиннің бинарлық файлына апаратын жол. Плагин қалталары 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", []))}))

Скрипт дағды қалтасының уақытша көшірмесінде, әдепкі 30 секундтық күту уақытымен іске қосылады. macOS пен Linux-та ол операциялық жүйенің құмсалғышында жұмыс істейді:

  • Ол тіркелгі деректері қоймаларын, браузер мен кілттер байламы деректерін немесе Nebo-ның өз баптаулары мен дерекқорын оқи алмайды.
  • Ол тек өзінің жұмыс қалтасына және /tmp/nebo ішіне ғана жаза алады. storage мүмкіндігі Nebo-ның деректер қалтасын қосады.
  • Оның желіге қол жеткізуі жоқ. network мүмкіндігі пакет тізілімдеріне және metadata.allowed_domains ішінде көрсетілген домендерге рұқсат береді.

Файлдар мен шектеулер

ЭлементЕреже
РесурстарSKILL.md, manifest.json, signatures.json және нүктеден басталатын файлдардан басқа әр файл.
Орындалатын файлдарscripts/ немесе bin/ ішіндегі файлдар және түбірдегі binary деп аталған файл.
ЖолдарДағды қалтасына қатысты. .. бар немесе қалтадан шығатын жолдар қабылданбайды.
Өшірілген дағдыSKILL.md орнына SKILL.md.disabled файлы бар қалта.
Дағдылар тізіміӘр жазба 250 таңбада қиылады. Бүкіл тізім 8 000 таңбадан асқанда алдымен ортақ дағдылар қысқартылады; қызметкердің өз дағдыларының жазбалары толық қалады.

Маркетплейсте жариялайтын файлдарыңызға қойылатын шектеулер Жариялау бетінде берілген.