Дағды деген не
Дағды — аты дағдының name мәнімен сәйкес келетін қалта. Қалтада SKILL.md файлы және қаласаңыз нұсқаулар сілтейтін кез келген басқа файлдар болады: анықтамалық құжаттар, үлгілер немесе скрипттер.
SKILL.md екі бөліктен тұрады. --- жолдарының арасындағы YAML frontmatter атауы мен сипаттаманы қамтиды. Одан кейінгі Markdown денесі нұсқауларды қамтиды.
Қызметкерлер дағдыларды қалай пайдаланады
Қызметкер дағдымен үш қадаммен жұмыс істейді.
- Таңдау. Әр кезекте қызметкер өзіне қолжетімді дағдылар тізімін көреді: әр дағдының аты, сипаттамасы және ең көбі үш триггері. Қызметкер шешім қабылдау үшін сипаттаманы оқиды, сондықтан онда дағдының не істейтінін және оны қашан пайдалану керегін жазыңыз.
- Жүктеу. Қызметкер
use_skillқұралын дағдының атымен шақырады. Құрал нұсқауларды, дағды қалтасының жолын және оның файлдарының атауларын қайтарады. Қызметкер дағдыны оқудың жалғыз жолы — осы. - Жұмыс. Қызметкер нұсқауларды орындайды. Ол қосымша файлдарды
read_skill_fileарқылы оқиды және бірге берілген скрипттердіexecuteарқылы іске қосады.
Триггерлер дағдыны ешқашан өздігінен жүктемейді. Таңдауды әрқашан қызметкер жасайды. Тізім ұзарғанда қызметкер онда 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 құралын шақырады.
Жүктегіш талап ететін ережелер
Осы ережелердің бірін бұзған дағды жүктелмейді. Nebo журналға ескерту жазып, оны өткізіп жібереді.
| Ереже | Толығырақ |
|---|---|
Файл --- деп басталады | Frontmatter файлдағы ең бірінші нәрсе болуы керек. Файл UTF-8 кодтауында болуы керек. |
name міндетті | Тек кіші әріптер, цифрлар және сызықшалар; басында немесе соңында сызықша жоқ; қос сызықша жоқ; ең көбі 64 байт. |
description міндетті | Ең көбі 1 024 байт. |
| Өрістердің түрі дұрыс | YAML түрі қате өріс бүкіл файлды жарамсыз етеді. Нұсқаларды тырнақшаға алыңыз, мысалы, "1.0.0". |
platform сәйкес келеді | Бар болса, дағды тек көрсетілген операциялық жүйелерде жүктеледі. |
Nebo танымайтын frontmatter кілттері еленбейді. Дененің өлшеміне шек жоқ, бірақ қысқа нұсқаулар жұмысқа көбірек орын қалдырады. Ұзақ материалды қызметкер қажет кезде оқитын файлдарға көшіріңіз.
Файлдар қосу
Қалтадағы SKILL.md мен нүктеден басталатын файлдардан басқа кез келген файл қызметкерге қолжетімді. Қалта атауларын өзіңіз таңдайсыз; Nebo references/ немесе assets/ қалталарына ерекше мағына бермейді. scripts/ немесе bin/ ішіндегі файлдарды іске қосуға болады.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Файлдарға олардың қалта ішіндегі жолы арқылы сілтеңіз, мысалы, references/policy.md. Қызметкер оларды қалтадан шығатын кез келген жолды қабылдамайтын read_skill_file арқылы оқиды. Скрипттер execute құралымен құмсалғышта іске қосылады. SKILL.md анықтамалығы орындау орталарын, орта айнымалыларын, құпияларды және желіге қол жеткізуді қамтиды.
Дағдылар қайда сақталады
Бот дағдыларды бірнеше жерден жинайды. Екі көз бірдей атаулы дағды ұсынса, осы тізімде кейінірек тұрған көз басым болады.
| Көзі | Орналасқан жері | Кім пайдалана алады |
|---|---|---|
| Кіріктірілген | Nebo-ға кіріктірілген | Әр қызметкер |
| Маркетплейс | <data>/nebo/skills/<slug>/<version>/ | Әр қызметкер |
| Плагин | Орнатылған плагиннің skills/ қалтасы | Әр қызметкер |
| Пайдаланушы | <data>/user/skills/<name>/ | Әр қызметкер |
| Қызметкер пакеті | Орнатылған қызметкер пакетінің ішіндегі skills/ | Тек сол қызметкер |
| Үйренген | <data>/learned/skills/<employee>/<name>/ | Тек сол қызметкер |
<data> — macOS-та ~/Library/Application Support/Nebo, Windows-та %APPDATA%\Nebo, Linux-та ~/.local/share/nebo. NEBO_HOME орта айнымалысы оны алмастырады. Қызметкердің өз дағдысы мен бірдей атаулы ортақ дағды болса, оның өз дағдысы басым болады.
Nebo осы қалталарды бақылап, өзгерген дағдыны бір секундтан кейін қайта жүктейді. Дағдыны жоймай өшіру үшін оның файлының атын SKILL.md.disabled деп өзгертіңіз.
Дағдылар құралдарды емес, жұмысты сипаттайды. Дағдыны түбіртектерді салыстыру сияқты бір міндеттің төңірегінде жазыңыз да, қызметкерге иесі берген кез келген қосылымды пайдалануға мүмкіндік беріңіз. Дағдыға шынымен плагин қажет болса, оны plugins өрісінде жариялаңыз.
Келесі
- SKILL.md анықтамалығы: әр өріс, құрал және айнымалы.
- Мысалдар: көшіріп алуға болатын толық дағдылар.
- Жариялау: дағдыны маркетплейске шығарыңыз.