Ujuzi ni nini
Ujuzi ni folda ambayo jina lake linalingana na name ya ujuzi. Folda hiyo huwa na faili la SKILL.md na, ukipenda, faili nyingine zozote ambazo maagizo yanazitaja: nyaraka za marejeo, violezo, au hati.
SKILL.md ina sehemu mbili. Frontmatter ya YAML kati ya mistari ya --- hubeba jina na maelezo. Kiini cha Markdown kinachofuata hubeba maagizo.
Jinsi wafanyakazi wanavyotumia ujuzi
Mfanyakazi hufanya kazi na ujuzi kwa hatua tatu.
- Chagua. Kila zamu, mfanyakazi huona orodha ya ujuzi unaopatikana kwake: jina la kila ujuzi, maelezo yake, na hadi vichochezi vyake vitatu. Maelezo ndiyo anayosoma mfanyakazi ili kuamua, kwa hiyo yaandike yaseme ujuzi unafanya nini na wakati wa kuutumia.
- Pakia. Mfanyakazi huita zana ya
use_skillkwa jina la ujuzi. Zana hurudisha maagizo, njia ya folda ya ujuzi, na majina ya faili zake. Hii ndiyo njia pekee ambayo mfanyakazi husoma ujuzi. - Fanya kazi. Mfanyakazi hufuata maagizo. Husoma faili saidizi kwa
read_skill_filena huendesha hati zilizojumuishwa kwaexecute.
Vichochezi kamwe havipakii ujuzi vyenyewe. Mfanyakazi ndiye hufanya uamuzi kila mara. Orodha inapokuwa ndefu, mfanyakazi anaweza kuitafuta kwa find_skills.
Andika ujuzi wako wa kwanza
Unda folda yenye jina la ujuzi, ikiwa na faili moja ndani yake.
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".
Weka folda katika saraka ya ujuzi wa mtumiaji ya boti (tazama Ujuzi huhifadhiwa wapi). Nebo huiona folda mpya ndani ya takriban sekunde moja, na kila mfanyakazi kwenye boti hiyo anaweza kuutumia ujuzi huo.
Mfanyakazi pia anaweza kukuandikia ujuzi. Mwombe auhifadhi, naye ataita save_skill, inayoandika folda katika saraka hiyo hiyo ya ujuzi wa mtumiaji.
Kanuni ambazo kipakiaji hulazimisha
Ujuzi unaovunja mojawapo ya kanuni hizi haupakiwi. Nebo huandika onyo kwenye kumbukumbu na kuuruka.
| Kanuni | Maelezo |
|---|---|
Faili huanza na --- | Frontmatter lazima iwe kitu cha kwanza kwenye faili. Faili lazima liwe UTF-8. |
name inahitajika | Herufi ndogo, tarakimu na vistari pekee; bila kistari mwanzoni wala mwishoni; bila kistari mara mbili; baiti 64 kwa zaidi. |
description inahitajika | Baiti 1,024 kwa zaidi. |
| Sehemu zina aina sahihi | Sehemu yenye aina isiyo sahihi ya YAML huharibu faili zima. Weka matoleo katika alama za nukuu, kama "1.0.0". |
platform inalingana | Ikiwepo, ujuzi hupakiwa kwenye mifumo ya uendeshaji iliyoorodheshwa pekee. |
Funguo za frontmatter ambazo Nebo haizitambui hupuuzwa. Kiini hakina kikomo cha ukubwa, lakini maagizo mafupi huacha nafasi zaidi kwa kazi. Hamisha maudhui marefu kwenye faili ambazo mfanyakazi husoma anapozihitaji.
Ongeza faili
Faili lolote kwenye folda isipokuwa SKILL.md na faili zinazoanza kwa nukta linapatikana kwa mfanyakazi. Majina ya folda ni chaguo lako; Nebo haipi references/ wala assets/ maana maalum. Faili zilizo chini ya scripts/ au bin/ zinaweza kuendeshwa.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Rejelea faili kwa njia yake ndani ya folda, kama references/policy.md. Mfanyakazi huzisoma kwa read_skill_file, inayokataa njia yoyote inayotoka nje ya folda. Hati huendeshwa kwa zana ya execute ndani ya sandbox. Marejeo ya SKILL.md yanaeleza mazingira ya kuendesha, vigezo vya mazingira, siri na ufikiaji wa mtandao.
Ujuzi huhifadhiwa wapi
Boti hukusanya ujuzi kutoka sehemu kadhaa. Vyanzo viwili vinapotoa ujuzi wenye jina lilelile, chanzo cha baadaye katika orodha hii hushinda.
| Chanzo | Mahali | Nani anaweza kuutumia |
|---|---|---|
| Uliojengwa ndani | Umejengwa ndani ya Nebo | Kila mfanyakazi |
| Soko | <data>/nebo/skills/<slug>/<version>/ | Kila mfanyakazi |
| Programu-jalizi | Folda ya skills/ ya programu-jalizi iliyosakinishwa | Kila mfanyakazi |
| Mtumiaji | <data>/user/skills/<name>/ | Kila mfanyakazi |
| Kifurushi cha mfanyakazi | skills/ ndani ya kifurushi cha mfanyakazi kilichosakinishwa | Mfanyakazi huyo pekee |
| Uliojifunza | <data>/learned/skills/<employee>/<name>/ | Mfanyakazi huyo pekee |
<data> ni ~/Library/Application Support/Nebo kwenye macOS, %APPDATA%\Nebo kwenye Windows, na ~/.local/share/nebo kwenye Linux. Kigezo cha mazingira cha NEBO_HOME hukibatilisha. Mfanyakazi anapokuwa na ujuzi wake mwenyewe na ujuzi wa pamoja wenye jina lilelile, ujuzi wake mwenyewe hushinda.
Nebo hufuatilia folda hizi na hupakia upya ujuzi uliobadilishwa baada ya sekunde moja. Ili kuzima ujuzi bila kuufuta, badilisha jina la faili lake kuwa SKILL.md.disabled.
Ujuzi hueleza kazi, si zana. Andika ujuzi kuhusu jukumu, kama kupatanisha risiti, na umwache mfanyakazi atumie muunganisho wowote ambao mmiliki ametoa. Ujuzi unapohitaji kweli programu-jalizi, itangaze kwa sehemu ya plugins.
Inayofuata
- Marejeo ya SKILL.md: kila sehemu, zana na kigezo.
- Mifano: ujuzi kamili wa kunakili.
- Kuchapisha: weka ujuzi sokoni.