Файл пішімі
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 міндетті. Түрі қате өріс бүкіл файлды жарамсыз етеді, сондықтан дағды жүктелмейді. Мұнда көрсетілмеген кілттер еленбейді.
| Өріс | Түрі | Әдепкі | Мағынасы |
|---|---|---|---|
name | string | міндетті | Идентификатор. [a-z0-9-], басында, соңында сызықша немесе қос сызықша жоқ, ең көбі 64 байт. Қалта атауымен сәйкес болсын. |
description | string | міндетті | Дағдының не істейтіні және оны қашан пайдалану керегі. Ең көбі 1 024 байт. Қызметкердің дағдылар тізімінде көрсетіледі және find_skills арқылы бағаланады. |
version | string | "1.0.0" | Семантикалық нұсқа. Басқа дағдылардың requires ауқымдары арқылы тексеріледі. Тырнақшаға алыңыз. |
triggers | жолдар тізімі | [] | Дағдының қашан қолданылатынын сипаттайтын сөздер мен тіркестер. Ең көбі үшеуі дағдылар тізімінде көрінеді; find_skills ішінде бәрі ескеріледі. Олар дағдыны ешқашан өздігінен жүктемейді. |
platform | жолдар тізімі | барлығы | macos, linux, windows. Дағды тек біреуі сәйкес келетін жерде жүктеледі. |
capabilities | жолдар тізімі | [] | network және storage скрипт құмсалғышын кеңейтеді. «Скрипт құмсалғышы» бөлімін қараңыз. |
metadata | map | {} | secrets және allowed_domains мәндерін қамтиды. Төменде қараңыз. |
requires | {name, version} тізімі | [] | Бұл дағды негізделетін басқа дағдылар. name — дағдының қысқа атауы; version — semver ауқымы, әдепкі мәні "*". |
plugins | {name, version, optional} тізімі | [] | Бұл дағды пайдаланатын плагиндер. version әдепкі мәні — "*", optional — false. |
dependencies | жолдар тізімі | [] | Міндетті түрде болуы керек дағдылардың қысқа атаулары. |
priority | integer | 0 | Басқару тізімдеріндегі дағдылардың ретін белгілейді. Қызметкердің қай дағдыны таңдайтынына әсер етпейді. |
author | string | "" | Көрсету үшін сақталады. |
license | string | "" | Көрсету үшін сақталады. |
compatibility | string | "" | Еркін мәтінді ескертпе, ең көбі 500 байт. |
tags | жолдар тізімі | [] | Көрсету үшін сақталады. |
allowed-tools | string | "" | Бос орынмен бөлінген жол. Сақталады; міндетті түрде орындалмайды. |
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 | Мәнді қайдан алуға болатыны. |
required | true болғанда мән орнатылмайынша 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} | Жарияланған құпияның мәні. |
$ARGUMENTS | use_skill құралына берілген args. Денеде $ARGUMENTS жоқ болса, аргументтер оның соңына қосылады. |
Дағды құралдары
Қызметкерлер дағдылармен осы құралдар арқылы жұмыс істейді. use_skill әрқашан қолжетімді; қалғандары қызметкерге қажет болғанда жүктеледі.
| Құрал | Параметрлер | Не істейді |
|---|---|---|
use_skill | name, args | Дағдыны жүктейді. Ашылған денені, қалта жолын және алғашқы 20 файл атауын қайтарады. Өшірілген дағдыны қайта қосады. |
find_skills | query | Атау, триггер және сипаттама сәйкестіктері бойынша саралап, ең көбі 10 дағды қайтарады. |
read_skill_file | name, path | Дағды қалтасындағы файлды оқиды. path болмаса, файлдар мен олардың өлшемдерін тізіп көрсетеді. |
save_skill | name, content | Толық SKILL.md файлын пайдаланушы дағдылары қалтасына жазады. Маркетплейс дағдыларын қайта жазу мүмкін емес. |
delete_skill | name | Пайдаланушы дағдысын жояды. |
install_skill | code | Маркетплейстегі дағдыны оның SKIL- орнату коды арқылы орнатады. |
configure_skill | name, key, value | Құпияны орнатады. key болмаса, дағдыға не қажет екенін көрсетеді. |
rate_skill | name, rating, review | Маркетплейстегі дағдыны 1-ден 5-ке дейін бағалайды. |
read_skill_reviews | name | Маркетплейстегі дағдының пікірлерін оқиды. |
execute | skill, script, args, timeout | Дағды қалтасындағы скриптті іске қосады. «Скрипт құмсалғышы» бөлімін қараңыз. |
Скрипт құмсалғышы
execute құралы дағды қалтасынан бір скриптті іске қосады. Ол орындау ортасын файлға қарап таңдайды.
| Скрипт | Орындау ортасы |
|---|---|
.py | Python, бар болса, Nebo-мен бірге жеткізілетін uv арқылы, әйтпесе python3. |
.ts, .js | Бар болса, Nebo-мен бірге жеткізілетін Bun, әйтпесе node. |
bin/<file> немесе binary | Тікелей іске қосылады. |
.sh | Қолдау көрсетілмейді. |
Әр іске қосу бос ортадан және мына айнымалылардан басталады:
| Айнымалы | Мәні |
|---|---|
SKILL_ARGS | JSON түріндегі 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 таңбадан асқанда алдымен ортақ дағдылар қысқартылады; қызметкердің өз дағдыларының жазбалары толық қалады. |
Маркетплейсте жариялайтын файлдарыңызға қойылатын шектеулер Жариялау бетінде берілген.