NeboAI
NeboAI
စတင်ပါ

ကျွမ်းကျင်မှုများ

ကျွမ်းကျင်မှုတစ်ခုသည် ဝန်ထမ်းတစ်ဦးကို အလုပ်အမျိုးအစားတစ်ခုကို ကောင်းစွာ လုပ်နည်း သင်ပေးသည်။ ၎င်းကို SKILL.md ဖိုင်ပါသော ဖိုင်တွဲအဖြစ် ရေးပါ- ဝန်ထမ်းက ကျွမ်းကျင်မှုကို ရွေးရန် သုံးသော ဖော်ပြချက်တိုနှင့် ကျွမ်းကျင်မှု load ပြီးနောက် လိုက်နာရမည့် ညွှန်ကြားချက်များ။ ကျွမ်းကျင်မှုများသည် ကုဒ် မလိုဘဲ ဘော့တစ်ခုပေါ်ရှိ ဝန်ထမ်းတိုင်း သုံးနိုင်သည်။

ကျွမ်းကျင်မှုဆိုသည်မှာ

ကျွမ်းကျင်မှုတစ်ခုသည် ကျွမ်းကျင်မှု၏ name နှင့် အမည်တူသော ဖိုင်တွဲတစ်ခု ဖြစ်သည်။ ဖိုင်တွဲတွင် SKILL.md ဖိုင်နှင့် ညွှန်ကြားချက်များက ရည်ညွှန်းသော အခြားဖိုင်များ (ကိုးကားစာရွက်စာတမ်းများ၊ template များ သို့မဟုတ် script များ) ကို ထည့်ထားနိုင်သည်။

SKILL.md တွင် အပိုင်းနှစ်ပိုင်း ရှိသည်။ --- စာကြောင်းများကြားရှိ YAML frontmatter တွင် အမည်နှင့် ဖော်ပြချက် ပါသည်။ ၎င်းနောက်ရှိ Markdown body တွင် ညွှန်ကြားချက်များ ပါသည်။

ဝန်ထမ်းများ ကျွမ်းကျင်မှုများကို သုံးပုံ

ဝန်ထမ်းတစ်ဦးသည် ကျွမ်းကျင်မှုတစ်ခုနှင့် အဆင့်သုံးဆင့်ဖြင့် အလုပ်လုပ်သည်။

  1. ရွေးချယ်ခြင်း။ အလှည့်တိုင်းတွင် ဝန်ထမ်းသည် ၎င်းသုံးနိုင်သော ကျွမ်းကျင်မှုများစာရင်းကို မြင်ရသည်- ကျွမ်းကျင်မှုတစ်ခုစီ၏ အမည်၊ ဖော်ပြချက်နှင့် trigger သုံးခုအထိ။ ဖော်ပြချက်သည် ဝန်ထမ်းက ဆုံးဖြတ်ရန် ဖတ်သည့်အရာ ဖြစ်သောကြောင့် ကျွမ်းကျင်မှု ဘာလုပ်သည်နှင့် မည်သည့်အခါ သုံးရမည်ကို ပြောအောင် ရေးပါ။
  2. Load လုပ်ခြင်း။ ဝန်ထမ်းက ကျွမ်းကျင်မှု၏အမည်ဖြင့် use_skill tool ကို ခေါ်သည်။ Tool သည် ညွှန်ကြားချက်များ၊ ကျွမ်းကျင်မှုဖိုင်တွဲ၏ path နှင့် ၎င်း၏ဖိုင်အမည်များကို ပြန်ပေးသည်။ ဤသည်မှာ ဝန်ထမ်းတစ်ဦး ကျွမ်းကျင်မှုကို ဖတ်သည့် တစ်ခုတည်းသောနည်းလမ်း ဖြစ်သည်။
  3. အလုပ်လုပ်ခြင်း။ ဝန်ထမ်းသည် ညွှန်ကြားချက်များကို လိုက်နာသည်။ ၎င်းသည် အထောက်အကူဖိုင်များကို read_skill_file ဖြင့် ဖတ်ပြီး ပါဝင်သော script များကို execute ဖြင့် run သည်။

Trigger များသည် ကျွမ်းကျင်မှုကို ကိုယ်တိုင် ဘယ်တော့မှ load မလုပ်ပါ။ ဝန်ထမ်းကသာ အမြဲ ရွေးချယ်သည်။ စာရင်း ရှည်လာသောအခါ ဝန်ထမ်းက find_skills ဖြင့် ရှာနိုင်သည်။

သင့်ပထမဆုံး ကျွမ်းကျင်မှုကို ရေးပါ

ကျွမ်းကျင်မှုအမည်ဖြင့် ဖိုင်တွဲတစ်ခု ဖန်တီးပြီး ၎င်းထဲတွင် ဖိုင်တစ်ခု ထည့်ပါ။

meeting-notes/
└── SKILL.md
---
name: meeting-notes
description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript.
---

# Meeting notes

1. List the decisions that were made.
2. List action items as "owner — task — due date".
3. List open questions that need a follow-up.

Keep each list short. If the transcript names no owner for an item, write "unassigned".

ဖိုင်တွဲကို ဘော့တစ်ခု၏ အသုံးပြုသူ ကျွမ်းကျင်မှုဖိုင်တွဲထဲ ထည့်ပါ (ကျွမ်းကျင်မှုများ ရှိရာနေရာ ကို ကြည့်ပါ)။ Nebo သည် ဖိုင်တွဲအသစ်ကို တစ်စက္ကန့်ခန့်အတွင်း သတိပြုမိပြီး ထိုဘော့ပေါ်ရှိ ဝန်ထမ်းတိုင်း ကျွမ်းကျင်မှုကို သုံးနိုင်သည်။

ဝန်ထမ်းတစ်ဦးကလည်း သင့်အတွက် ကျွမ်းကျင်မှုတစ်ခု ရေးပေးနိုင်သည်။ တစ်ခု သိမ်းရန် ပြောပါက ၎င်းသည် save_skill ကို ခေါ်ပြီး တူညီသော အသုံးပြုသူ ကျွမ်းကျင်မှုဖိုင်တွဲထဲသို့ ဖိုင်တွဲကို ရေးသည်။

Loader က ကျင့်သုံးသော စည်းမျဉ်းများ

ဤစည်းမျဉ်းများထဲမှ တစ်ခုကို ချိုးဖောက်သော ကျွမ်းကျင်မှုသည် load မဖြစ်ပါ။ Nebo က သတိပေးချက်ကို log တွင် မှတ်ပြီး ၎င်းကို ကျော်သည်။

စည်းမျဉ်းအသေးစိတ်
ဖိုင်သည် --- ဖြင့် စရမည်Frontmatter သည် ဖိုင်၏ ပထမဆုံးအရာ ဖြစ်ရမည်။ ဖိုင်သည် UTF-8 ဖြစ်ရမည်။
name မဖြစ်မနေ လိုအပ်သည်စာလုံးအသေး၊ ဂဏန်းနှင့် hyphen များသာ။ ရှေ့ သို့မဟုတ် နောက်တွင် hyphen မပါရ၊ နှစ်ခုဆက် hyphen မပါရ၊ အများဆုံး 64 byte။
description မဖြစ်မနေ လိုအပ်သည်အများဆုံး 1,024 byte။
Field များ type မှန်ရမည်YAML type မှားသော field တစ်ခုက ဖိုင်တစ်ခုလုံးကို ပျက်စေသည်။ ဗားရှင်းများကို "1.0.0" ကဲ့သို့ quote ဖြင့် ရေးပါ။
platform ကိုက်ညီရမည်ပါရှိပါက ကျွမ်းကျင်မှုသည် ဖော်ပြထားသော operating system များပေါ်တွင်သာ load ဖြစ်သည်။

Nebo မသိသော frontmatter key များကို လျစ်လျူရှုသည်။ Body တွင် အရွယ်အစား ကန့်သတ်ချက် မရှိသော်လည်း ညွှန်ကြားချက် တိုလေ အလုပ်အတွက် နေရာ ပိုကျန်လေ ဖြစ်သည်။ ရှည်လျားသော အကြောင်းအရာကို ဝန်ထမ်း လိုအပ်သည့်အခါ ဖတ်မည့် ဖိုင်များထဲသို့ ရွှေ့ပါ။

ဖိုင်များ ထည့်ရန်

ဖိုင်တွဲထဲရှိ SKILL.md နှင့် dotfile များမှလွဲ၍ မည်သည့်ဖိုင်ကိုမဆို ဝန်ထမ်း သုံးနိုင်သည်။ ဖိုင်တွဲအမည်များကို သင် ရွေးနိုင်သည်။ Nebo သည် references/ သို့မဟုတ် assets/ ကို အထူးအဓိပ္ပာယ် မပေးပါ။ scripts/ သို့မဟုတ် bin/ အောက်ရှိ ဖိုင်များကို run နိုင်သည်။

invoice-check/
├── SKILL.md              # required
├── references/
│   └── policy.md         # read with read_skill_file
└── scripts/
    └── totals.py         # run with execute

ဖိုင်များကို references/policy.md ကဲ့သို့ ဖိုင်တွဲအတွင်းရှိ path ဖြင့် ရည်ညွှန်းပါ။ ဝန်ထမ်းက ၎င်းတို့ကို read_skill_file ဖြင့် ဖတ်ပြီး ၎င်းသည် ဖိုင်တွဲအပြင်သို့ ထွက်သော path မှန်သမျှကို ငြင်းပယ်သည်။ Script များသည် sandbox ထဲတွင် execute tool ဖြင့် run သည်။ SKILL.md ကိုးကားချက် တွင် runtime များ၊ environment variable များ၊ secret များနှင့် network access ကို ဖော်ပြထားသည်။

ကျွမ်းကျင်မှုများ ရှိရာနေရာ

ဘော့တစ်ခုသည် နေရာများစွာမှ ကျွမ်းကျင်မှုများကို စုဆောင်းသည်။ ရင်းမြစ်နှစ်ခုက အမည်တူ ကျွမ်းကျင်မှုကို ပေးသောအခါ ဤစာရင်းတွင် နောက်ကျသော ရင်းမြစ်က အနိုင်ရသည်။

ရင်းမြစ်တည်နေရာအသုံးပြုနိုင်သူ
မူလပါဝင်သည်Nebo ထဲသို့ compile လုပ်ထားသည်ဝန်ထမ်းတိုင်း
စျေးကွက်<data>/nebo/skills/<slug>/<version>/ဝန်ထမ်းတိုင်း
Pluginထည့်သွင်းထားသော Plugin ၏ skills/ ဖိုင်တွဲဝန်ထမ်းတိုင်း
အသုံးပြုသူ<data>/user/skills/<name>/ဝန်ထမ်းတိုင်း
ဝန်ထမ်း packageထည့်သွင်းထားသော ဝန်ထမ်း package အတွင်းရှိ skills/ထိုဝန်ထမ်းသာ
သင်ယူထားသည်<data>/learned/skills/<employee>/<name>/ထိုဝန်ထမ်းသာ

<data> သည် macOS တွင် ~/Library/Application Support/Nebo၊ Windows တွင် %APPDATA%\Nebo နှင့် Linux တွင် ~/.local/share/nebo ဖြစ်သည်။ NEBO_HOME environment variable က ၎င်းကို အစားထိုးသည်။ ဝန်ထမ်းတစ်ဦးတွင် ကိုယ်ပိုင်ကျွမ်းကျင်မှုနှင့် အမည်တူ မျှဝေကျွမ်းကျင်မှု ရှိသောအခါ ကိုယ်ပိုင်ကျွမ်းကျင်မှုက အနိုင်ရသည်။

Nebo သည် ဤဖိုင်တွဲများကို စောင့်ကြည့်ပြီး ပြောင်းလဲထားသော ကျွမ်းကျင်မှုကို တစ်စက္ကန့်အကြာတွင် ပြန် load လုပ်သည်။ ကျွမ်းကျင်မှုကို မဖျက်ဘဲ ပိတ်ရန် ၎င်း၏ဖိုင်ကို SKILL.md.disabled ဟု အမည်ပြောင်းပါ။

ကျွမ်းကျင်မှုများသည် tool များကို မဟုတ်ဘဲ အလုပ်ကို ဖော်ပြသည်။ ပြေစာများ ချိန်ညှိခြင်းကဲ့သို့ တာဝန်တစ်ခုကို အခြေခံ၍ ကျွမ်းကျင်မှုကို ရေးပြီး ပိုင်ရှင်ပေးထားသော မည်သည့်ချိတ်ဆက်မှုကိုမဆို ဝန်ထမ်းအား သုံးခွင့်ပေးပါ။ ကျွမ်းကျင်မှုတစ်ခုက Plugin တစ်ခုကို အမှန်တကယ် လိုအပ်သောအခါ plugins field ဖြင့် ကြေညာပါ။

နောက်တစ်ဆင့်