Kí ni ọgbọ́n kan
Ọgbọ́n kan jẹ́ fódà tí orúkọ rẹ̀ bá name ọgbọ́n náà mu. Fódà náà ní fáìlì SKILL.md kan nínú àti, bí o bá fẹ́, àwọn fáìlì mìíràn tí ìtọ́ni náà tọ́ka sí: àwọn ìwé ìtọ́kasí, àwọn àwòṣe, tàbí àwọn script.
SKILL.md ní apá méjì. Frontmatter YAML láàárín àwọn ìlà --- ń gbé orúkọ àti àpèjúwe. Ara Markdown tí ó tẹ̀lé e ń gbé àwọn ìtọ́ni.
Bí àwọn òṣìṣẹ́ ṣe ń lo àwọn ọgbọ́n
Òṣìṣẹ́ kan ń bá ọgbọ́n kan ṣiṣẹ́ ní ìgbésẹ̀ mẹ́ta.
- Yàn. Ní ìyípo kọ̀ọ̀kan, òṣìṣẹ́ náà ń rí àkójọ àwọn ọgbọ́n tí ó wà fún un: orúkọ ọgbọ́n kọ̀ọ̀kan, àpèjúwe rẹ̀, àti títí dé mẹ́ta nínú àwọn ohun ìbẹ̀rẹ̀ rẹ̀. Àpèjúwe ni ohun tí òṣìṣẹ́ náà ń kà láti pinnu, nítorí náà kọ ọ́ láti sọ ohun tí ọgbọ́n náà ń ṣe àti ìgbà tí a ó lò ó.
- Gbé wọlé. Òṣìṣẹ́ náà ń pe irinṣẹ́
use_skillpẹ̀lú orúkọ ọgbọ́n náà. Irinṣẹ́ náà ń dá àwọn ìtọ́ni padà, ipa ọ̀nà fódà ọgbọ́n náà, àti orúkọ àwọn fáìlì rẹ̀. Èyí ni ọ̀nà kan ṣoṣo tí òṣìṣẹ́ kan fi ń ka ọgbọ́n kan. - Ṣiṣẹ́. Òṣìṣẹ́ náà ń tẹ̀lé àwọn ìtọ́ni. Ó ń ka àwọn fáìlì àtìlẹ́yìn pẹ̀lú
read_skill_file, ó sì ń ṣiṣẹ́ àwọn script tí a dì pọ̀ pẹ̀lúexecute.
Àwọn ohun ìbẹ̀rẹ̀ kì í gbé ọgbọ́n wọlé fúnra wọn láé. Òṣìṣẹ́ náà ló ń yan nígbà gbogbo. Nígbà tí àkójọ náà bá gùn, òṣìṣẹ́ náà lè wá inú rẹ̀ pẹ̀lú find_skills.
Kọ ọgbọ́n àkọ́kọ́ rẹ
Ṣẹ̀dá fódà kan tí a dárúkọ bí ọgbọ́n náà, pẹ̀lú fáìlì kan nínú rẹ̀.
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".
Fi fódà náà sínú fódà ọgbọ́n olùmúlò ti bot kan (wo Ibi tí àwọn ọgbọ́n wà). Nebo ń rí fódà tuntun náà láàárín ìṣẹ́jú-àáyá kan tàbí bẹ́ẹ̀, gbogbo òṣìṣẹ́ lórí bot náà sì lè lo ọgbọ́n náà.
Òṣìṣẹ́ kan tún lè kọ ọgbọ́n kan fún ọ. Ní kí ó fi ọ̀kan pamọ́, yóò sì pe save_skill, èyí tí ń kọ fódà náà sínú fódà ọgbọ́n olùmúlò kan náà.
Àwọn òfin tí ẹ̀rọ ìgbéwọlé ń fi múni
Ọgbọ́n tí ó bá rú ọ̀kan nínú àwọn òfin wọ̀nyí kò ní wọlé. Nebo ń kọ ìkìlọ̀ sílẹ̀, ó sì ń fò ó.
| Òfin | Kúlẹ̀kúlẹ̀ |
|---|---|
Fáìlì ń bẹ̀rẹ̀ pẹ̀lú --- | Frontmatter gbọ́dọ̀ jẹ́ ohun àkọ́kọ́ nínú fáìlì náà. Fáìlì náà gbọ́dọ̀ jẹ́ UTF-8. |
name pọn dandan | Lẹ́tà kékeré, nọ́ńbà àti hyphen nìkan; kò sí hyphen ní ìbẹ̀rẹ̀ tàbí ní òpin; kò sí hyphen méjì papọ̀; 64 bytes ó pọ̀jù. |
description pọn dandan | 1,024 bytes ó pọ̀jù. |
| Àwọn àyè ní irú tí ó tọ́ | Àyè tí ó ní irú YAML tí kò tọ́ ń mú kí gbogbo fáìlì kùnà. Fi àmì ìtọ́ka yí àwọn ẹ̀yà ká, bí "1.0.0". |
platform bá a mu | Bí ó bá wà, ọgbọ́n náà ń wọlé lórí àwọn ẹ̀rọ ìṣiṣẹ́ (operating systems) tí a kọ sílẹ̀ nìkan. |
A kò ka àwọn kọ́kọ́rọ́ frontmatter tí Nebo kò mọ̀ sí. Ara rẹ̀ kò ní ààlà ìwọ̀n, ṣùgbọ́n àwọn ìtọ́ni kúkúrú ń fi àyè púpọ̀ sílẹ̀ fún iṣẹ́ náà. Gbé àwọn ohun gígùn lọ sínú àwọn fáìlì tí òṣìṣẹ́ náà ń kà nígbà tí ó bá nílò wọn.
Ṣàfikún àwọn fáìlì
Fáìlì èyíkéyìí nínú fódà náà yàtọ̀ sí SKILL.md àti dotfiles wà fún òṣìṣẹ́ náà. Ìwọ lo máa yan orúkọ àwọn fódà; Nebo kò fún references/ tàbí assets/ ní ìtumọ̀ pàtàkì kankan. Àwọn fáìlì lábẹ́ scripts/ tàbí bin/ ṣeé ṣiṣẹ́.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Tọ́ka sí àwọn fáìlì nípa ipa ọ̀nà wọn nínú fódà náà, bí references/policy.md. Òṣìṣẹ́ náà ń kà wọ́n pẹ̀lú read_skill_file, èyí tí ń kọ ipa ọ̀nà èyíkéyìí tí ó bá jáde kúrò nínú fódà náà. Àwọn script ń ṣiṣẹ́ pẹ̀lú irinṣẹ́ execute nínú àyè àdádó (sandbox). Ìtọ́kasí SKILL.md ṣàlàyé àwọn runtime, àwọn àyípadà àyíká, àwọn àṣírí àti ìwọlé nẹ́tíwọ́ọ̀kì.
Ibi tí àwọn ọgbọ́n wà
Bot kan ń kó àwọn ọgbọ́n jọ láti ọ̀pọ̀ ibi. Nígbà tí orísun méjì bá pèsè ọgbọ́n tí ó ní orúkọ kan náà, orísun tí ó kẹ́yìn nínú àkójọ yìí ló ń borí.
| Orísun | Ibi | Ta ló lè lò ó |
|---|---|---|
| Èyí tí ó wà nínú rẹ̀ | A ti kọ ọ́ pọ̀ mọ́ Nebo | Gbogbo òṣìṣẹ́ |
| Ọjà | <data>/nebo/skills/<slug>/<version>/ | Gbogbo òṣìṣẹ́ |
| Plugin | Fódà skills/ ti plugin tí a ti fi sórí ẹ̀rọ | Gbogbo òṣìṣẹ́ |
| Olùmúlò | <data>/user/skills/<name>/ | Gbogbo òṣìṣẹ́ |
| Àpò òṣìṣẹ́ | skills/ nínú àpò òṣìṣẹ́ tí a ti fi sórí ẹ̀rọ | Òṣìṣẹ́ yẹn nìkan |
| Èyí tí a kọ́ | <data>/learned/skills/<employee>/<name>/ | Òṣìṣẹ́ yẹn nìkan |
<data> ni ~/Library/Application Support/Nebo lórí macOS, %APPDATA%\Nebo lórí Windows, àti ~/.local/share/nebo lórí Linux. Àyípadà àyíká NEBO_HOME ń borí rẹ̀. Nígbà tí òṣìṣẹ́ kan bá ní ọgbọ́n tirẹ̀ àti ọgbọ́n tí a ń pín tí ó ní orúkọ kan náà, ọgbọ́n tirẹ̀ ló ń borí.
Nebo ń ṣọ́ àwọn fódà wọ̀nyí, ó sì ń tún ọgbọ́n tí a yí padà gbé wọlé lẹ́yìn ìṣẹ́jú-àáyá kan. Láti pa ọgbọ́n kan láìpaarẹ́, yí orúkọ fáìlì rẹ̀ padà sí SKILL.md.disabled.
Àwọn ọgbọ́n ń ṣàpèjúwe iṣẹ́, kì í ṣe irinṣẹ́. Kọ ọgbọ́n kan yí ojúṣe kan ká, bí ìbámu àwọn ìwé ẹ̀rí ìsanwó, kí o sì jẹ́ kí òṣìṣẹ́ náà lo ìsopọ̀ èyíkéyìí tí ẹni tó ni í pèsè. Nígbà tí ọgbọ́n kan bá nílò plugin kan ní tòótọ́, kéde rẹ̀ pẹ̀lú àyè plugins.
Ohun tí ó kàn
- Ìtọ́kasí SKILL.md: gbogbo àyè, irinṣẹ́ àti àyípadà.
- Àwọn àpẹẹrẹ: àwọn ọgbọ́n pípé láti ṣe ẹ̀dà.
- Ìtẹ̀jáde: fi ọgbọ́n kan sí ọjà.