ဖိုင်ပုံစံ
SKILL.md သည် UTF-8 စာသား ဖြစ်သည်။ ၎င်းသည် hyphen သုံးခုပါ စာကြောင်းဖြင့် စပြီး YAML frontmatter၊ ထို့နောက် hyphen သုံးခုပါ ပိတ်စာကြောင်း လာသည်။ ထို့နောက်ရှိ အရာအားလုံးသည် body ဖြစ်သည်- ဝန်ထမ်းက ကျွမ်းကျင်မှုကို load လုပ်သောအခါ ရရှိသော 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 field များ
name နှင့် description သာ မဖြစ်မနေ လိုအပ်သည်။ Type မှားသော field တစ်ခုက ဖိုင်တစ်ခုလုံးကို ပျက်စေသောကြောင့် ကျွမ်းကျင်မှု load မဖြစ်ပါ။ ဤနေရာတွင် မဖော်ပြထားသော key များကို လျစ်လျူရှုသည်။
| Field | Type | မူလတန်ဖိုး | အဓိပ္ပာယ် |
|---|---|---|---|
name | string | မဖြစ်မနေ | Identifier။ [a-z0-9-]၊ ရှေ့၊ နောက် သို့မဟုတ် နှစ်ခုဆက် hyphen မပါရ၊ အများဆုံး 64 byte။ ဖိုင်တွဲအမည်နှင့် ကိုက်ညီပါစေ။ |
description | string | မဖြစ်မနေ | ကျွမ်းကျင်မှု ဘာလုပ်သည်နှင့် မည်သည့်အခါ သုံးရမည်။ အများဆုံး 1,024 byte။ ဝန်ထမ်း၏ ကျွမ်းကျင်မှုစာရင်းတွင် ပြသပြီး find_skills က အမှတ်ပေးသည်။ |
version | string | "1.0.0" | Semantic version။ အခြားကျွမ်းကျင်မှုများ၏ requires range များက စစ်ဆေးသည်။ Quote ဖြင့် ရေးပါ။ |
triggers | string စာရင်း | [] | ကျွမ်းကျင်မှု မည်သည့်အခါ သက်ဆိုင်သည်ကို ဖော်ပြသော စကားလုံးနှင့် စကားစုများ။ ကျွမ်းကျင်မှုစာရင်းတွင် သုံးခုအထိ ပေါ်ပြီး find_skills တွင် အားလုံး ထည့်တွက်သည်။ ၎င်းတို့သည် ကျွမ်းကျင်မှုကို ကိုယ်တိုင် ဘယ်တော့မှ load မလုပ်ပါ။ |
platform | string စာရင်း | အားလုံး | macos၊ linux၊ windows။ ကျွမ်းကျင်မှုသည် တစ်ခုခု ကိုက်ညီသည့်နေရာတွင်သာ load ဖြစ်သည်။ |
capabilities | string စာရင်း | [] | network နှင့် storage သည် script sandbox ကို ချဲ့ပေးသည်။ Script sandbox ကို ကြည့်ပါ။ |
metadata | map | {} | secrets နှင့် allowed_domains ကို ထည့်ထားသည်။ အောက်တွင် ကြည့်ပါ။ |
requires | {name, version} စာရင်း | [] | ဤကျွမ်းကျင်မှုက အခြေခံသော အခြားကျွမ်းကျင်မှုများ။ name သည် ကျွမ်းကျင်မှုအမည်တို ဖြစ်ပြီး version သည် semver range ဖြစ်ကာ မူလတန်ဖိုး "*"။ |
plugins | {name, version, optional} စာရင်း | [] | ဤကျွမ်းကျင်မှု သုံးသော Plugin များ။ version ၏ မူလတန်ဖိုး "*"၊ optional ၏ မူလတန်ဖိုး false။ |
dependencies | string စာရင်း | [] | ရှိနေရမည့် ကျွမ်းကျင်မှုများ၏ အမည်တို။ |
priority | integer | 0 | စီမံခန့်ခွဲမှုစာရင်းများတွင် ကျွမ်းကျင်မှုများကို အစီအစဉ်ချသည်။ ဝန်ထမ်းက မည်သည့်ကျွမ်းကျင်မှုကို ရွေးသည်ကို မထိခိုက်ပါ။ |
author | string | "" | ပြသရန် သိမ်းဆည်းထားသည်။ |
license | string | "" | ပြသရန် သိမ်းဆည်းထားသည်။ |
compatibility | string | "" | လွတ်လပ်သော မှတ်ချက်၊ အများဆုံး 500 byte။ |
tags | string စာရင်း | [] | ပြသရန် သိမ်းဆည်းထားသည်။ |
allowed-tools | string | "" | Space ဖြင့် ခွဲထားသော string။ သိမ်းဆည်းထားသော်လည်း ကန့်သတ်ခြင်း မပြုပါ။ |
requires သို့မဟုတ် dependencies တွင် အမည်ဖော်ထားသော ကျွမ်းကျင်မှု မရှိ သို့မဟုတ် range အပြင်ဘက်ဖြစ်နေလျှင်၊ သို့မဟုတ် လိုအပ်သော Plugin ကို ထည့်သွင်းမထားလျှင် ကျွမ်းကျင်မှုသည် load ဖြစ်ဆဲဖြစ်ပြီး degraded ဟု မှတ်သားသည်။ ပိုင်ရှင်က ဘာလိုနေသည်ကို မြင်ရသည်။
Secret များ
ကျွမ်းကျင်မှု၏ script များ လိုအပ်သော အထောက်အထားများကို 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 | အဓိပ္ပာယ် |
|---|---|
key | Script လက်ခံရရှိသော environment variable အမည်။ မဖြစ်မနေ လိုအပ်သည်။ |
label | ပိုင်ရှင်အား ပြသမည့်အမည်။ |
hint | တန်ဖိုးကို ရယူရမည့်နေရာ။ |
required | true ဖြစ်သောအခါ တန်ဖိုး မသတ်မှတ်မချင်း execute က ကျွမ်းကျင်မှု၏ script များကို run ရန် ငြင်းဆိုသည်။ မူလတန်ဖိုး false။ |
ဝန်ထမ်းတစ်ဦးသည် configure_skill ဖြင့် တန်ဖိုးတစ်ခု သတ်မှတ်သည်။ body ထဲတွင် လျှို့ဝှက်ချက်ကို ${secret.KEY} အဖြစ် ကိုးကားနိုင်သော်လည်း script များသည် environment variable ကို ဖတ်သင့်သည်။
Template variable များ
ဝန်ထမ်းက ကျွမ်းကျင်မှုကို load လုပ်သောအခါ Nebo က body ထဲရှိ ဤ variable များကို အစားထိုးသည်။ အခြားဖိုင်များအတွင်း အစားမထိုးပါ။ Script များက environment variable များကို ဖတ်သည်။
| Variable | တန်ဖိုး |
|---|---|
${NEBO_SKILL_DIR} | ကျွမ်းကျင်မှုဖိုင်တွဲ၏ absolute path။ |
${NEBO_DATA_DIR} | ဤကျွမ်းကျင်မှုအတွက် ရေးနိုင်သော ဖိုင်တွဲ- <data>/appdata/skills/<name>။ ပထမဆုံးအသုံးပြုချိန်တွင် ဖန်တီးသည်။ |
${NEBO_USER_NAME} | ပိုင်ရှင်၏ အမည်။ |
${NEBO_OS} | Operating system။ |
${NEBO_ARCH} | Processor architecture။ |
${plugin.SLUG_BIN} | ကြေညာထားသော Plugin ၏ binary path။ Slug ကို စာလုံးအကြီးပြောင်းပြီး hyphen များကို underscore အဖြစ် ပြောင်းသည်- example-ledger သည် ${plugin.EXAMPLE_LEDGER_BIN} ဖြစ်လာသည်။ |
${secret.KEY} | ကြေညာထားသော secret ၏ တန်ဖိုး။ |
$ARGUMENTS | use_skill သို့ ပေးသော args။ Body တွင် $ARGUMENTS မပါပါက argument များကို ၎င်းနောက်တွင် ဆက်ထည့်သည်။ |
ကျွမ်းကျင်မှု tool များ
ဝန်ထမ်းများသည် ဤ tool များမှတစ်ဆင့် ကျွမ်းကျင်မှုများနှင့် အလုပ်လုပ်သည်။ use_skill ကို အမြဲ သုံးနိုင်ပြီး အခြားများကို ဝန်ထမ်း လိုအပ်သည့်အခါ load လုပ်သည်။
| Tool | Parameter များ | လုပ်ဆောင်ချက် |
|---|---|---|
use_skill | name, args | ကျွမ်းကျင်မှုတစ်ခုကို load လုပ်သည်။ ချဲ့ထွင်ထားသော body၊ ဖိုင်တွဲ path နှင့် ပထမ ဖိုင်အမည် 20 ကို ပြန်ပေးသည်။ ပိတ်ထားသော ကျွမ်းကျင်မှုကို ပြန်ဖွင့်ပေးသည်။ |
find_skills | query | အမည်၊ trigger နှင့် ဖော်ပြချက် ကိုက်ညီမှုအလိုက် အဆင့်စီထားသော ကျွမ်းကျင်မှု 10 ခုအထိ ပြန်ပေးသည်။ |
read_skill_file | name, path | ကျွမ်းကျင်မှုဖိုင်တွဲထဲရှိ ဖိုင်တစ်ခုကို ဖတ်သည်။ path မပါပါက ဖိုင်များနှင့် ၎င်းတို့၏ အရွယ်အစားကို စာရင်းပြသည်။ |
save_skill | name, content | ပြည့်စုံသော SKILL.md ကို အသုံးပြုသူ ကျွမ်းကျင်မှုဖိုင်တွဲသို့ ရေးသည်။ စျေးကွက်ကျွမ်းကျင်မှုများကို ထပ်ရေး၍ မရပါ။ |
delete_skill | name | အသုံးပြုသူ ကျွမ်းကျင်မှုတစ်ခုကို ဖျက်သည်။ |
install_skill | code | စျေးကွက်ကျွမ်းကျင်မှုတစ်ခုကို ၎င်း၏ SKIL- install code ဖြင့် ထည့်သွင်းသည်။ |
configure_skill | name, key, value | Secret တစ်ခုကို သတ်မှတ်သည်။ key မပါပါက ကျွမ်းကျင်မှု လိုအပ်သည်များကို ပြသသည်။ |
rate_skill | name, rating, review | စျေးကွက်ကျွမ်းကျင်မှုတစ်ခုကို 1 မှ 5 အထိ အဆင့်သတ်မှတ်သည်။ |
read_skill_reviews | name | စျေးကွက်ကျွမ်းကျင်မှုတစ်ခု၏ သုံးသပ်ချက်များကို ဖတ်သည်။ |
execute | skill, script, args, timeout | ကျွမ်းကျင်မှုဖိုင်တွဲမှ script တစ်ခုကို run သည်။ Script sandbox ကို ကြည့်ပါ။ |
Script sandbox
execute tool သည် ကျွမ်းကျင်မှုဖိုင်တွဲမှ script တစ်ခုကို run သည်။ ၎င်းသည် ဖိုင်ကိုကြည့်၍ runtime ကို ရွေးသည်။
| Script | Runtime |
|---|---|
.py | Python၊ Nebo နှင့်အတူပါသော uv ရှိပါက ၎င်းမှတစ်ဆင့်၊ မရှိပါက python3။ |
.ts, .js | Nebo နှင့်အတူပါသော Bun ရှိပါက ၎င်း၊ မရှိပါက node။ |
bin/<file> သို့မဟုတ် binary | တိုက်ရိုက် run သည်။ |
.sh | မပံ့ပိုးပါ။ |
Run တစ်ခုစီသည် ဗလာ environment နှင့် ဤ variable များဖြင့် စတင်သည်-
| Variable | တန်ဖိုး |
|---|---|
SKILL_ARGS | args object ကို JSON အဖြစ်။ |
Secret key တစ်ခုစီ | စာဝှက်ဖြည်ထားသော secret တန်ဖိုး။ |
<PLUGIN>_BIN | ကြေညာထားသော Plugin တစ်ခုစီ၏ binary path။ Plugin ဖိုင်တွဲများကိုလည်း 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", []))})) Script သည် ကျွမ်းကျင်မှုဖိုင်တွဲ၏ ယာယီမိတ္တူထဲတွင် မူလ timeout 30 စက္ကန့်ဖြင့် run သည်။ macOS နှင့် Linux တွင် operating-system sandbox ထဲ၌ run သည်-
- ၎င်းသည် credential store များ၊ browser နှင့် keychain ဒေတာ သို့မဟုတ် Nebo ၏ ကိုယ်ပိုင်ဆက်တင်များနှင့် database ကို မဖတ်နိုင်ပါ။
- ၎င်းသည် ၎င်း၏ working folder နှင့်
/tmp/neboသို့သာ ရေးနိုင်သည်။storageစွမ်းရည်က Nebo ၏ ဒေတာဖိုင်တွဲကို ထပ်ထည့်ပေးသည်။ - ၎င်းတွင် network access မရှိပါ။
networkစွမ်းရည်က package registry များနှင့်metadata.allowed_domainsတွင် ဖော်ပြထားသော domain များကို ခွင့်ပြုသည်။
ဖိုင်များနှင့် ကန့်သတ်ချက်များ
| အကြောင်းအရာ | စည်းမျဉ်း |
|---|---|
| အရင်းအမြစ်များ | SKILL.md၊ manifest.json၊ signatures.json နှင့် dotfile များမှလွဲ၍ ဖိုင်တိုင်း။ |
| Executable များ | scripts/ သို့မဟုတ် bin/ အောက်ရှိ ဖိုင်များနှင့် binary ဟု အမည်ရှိသော root ဖိုင်။ |
| Path များ | ကျွမ်းကျင်မှုဖိုင်တွဲနှင့် နှိုင်းယှဉ်သော path။ .. ပါသော သို့မဟုတ် ဖိုင်တွဲအပြင်ထွက်သော path များကို ငြင်းပယ်သည်။ |
| ပိတ်ထားသော ကျွမ်းကျင်မှု | SKILL.md အစား SKILL.md.disabled ပါသော ဖိုင်တွဲ။ |
| ကျွမ်းကျင်မှုစာရင်း | Entry တစ်ခုစီကို စာလုံး 250 တွင် ဖြတ်သည်။ စာရင်းတစ်ခုလုံး စာလုံး 8,000 ကျော်သောအခါ မျှဝေကျွမ်းကျင်မှုများကို အရင် အတိုချုံ့သည်။ ဝန်ထမ်း၏ ကိုယ်ပိုင်ကျွမ်းကျင်မှုများသည် entry အပြည့်အစုံ ထားရှိသည်။ |
စျေးကွက်သို့ သင်ထုတ်ဝေသော ဖိုင်များအတွက် ကန့်သတ်ချက်များကို ထုတ်ဝေခြင်း စာမျက်နှာတွင် ဖော်ပြထားသည်။