Ano ang skill
Ang skill ay isang folder na tugma ang pangalan sa name ng skill. Laman ng folder ang isang SKILL.md file at, kung gusto, anumang ibang file na tinutukoy ng mga instruction: mga reference na dokumento, template, o script.
May dalawang bahagi ang SKILL.md. Ang YAML frontmatter sa pagitan ng mga linyang --- ang nagdadala ng pangalan at description. Ang Markdown body pagkatapos nito ang nagdadala ng mga instruction.
Paano ginagamit ng mga empleyado ang mga skill
Tatlong hakbang ang pagtatrabaho ng empleyado gamit ang isang skill.
- Pumili. Sa bawat turn, nakikita ng empleyado ang listahan ng mga skill na available dito: ang pangalan ng bawat skill, ang description nito, at hanggang tatlo sa mga trigger nito. Ang description ang binabasa ng empleyado para magpasya, kaya isulat ito para sabihin kung ano ang ginagawa ng skill at kailan ito gagamitin.
- I-load. Tinatawag ng empleyado ang tool na
use_skillgamit ang pangalan ng skill. Ibinabalik ng tool ang mga instruction, ang path ng folder ng skill, at ang mga pangalan ng mga file nito. Ito lang ang paraan para mabasa ng empleyado ang isang skill. - Magtrabaho. Sinusunod ng empleyado ang mga instruction. Binabasa nito ang mga sumusuportang file gamit ang
read_skill_fileat pinapatakbo ang mga kasamang script gamit angexecute.
Hindi kailanman nilo-load ng mga trigger ang skill nang mag-isa. Laging ang empleyado ang pumipili. Kapag humaba ang listahan, puwede itong hanapin ng empleyado gamit ang find_skills.
Isulat ang una mong skill
Gumawa ng folder na pinangalanan ayon sa skill, na may isang file sa loob.
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".
Ilagay ang folder sa user skills directory ng isang bot (tingnan ang Kung saan nakalagay ang mga skill). Napapansin ng Nebo ang bagong folder sa loob ng mga isang segundo, at magagamit ng bawat empleyado sa bot na iyon ang skill.
Puwede ka ring sulatan ng empleyado ng skill. Sabihan itong mag-save ng isa, at tatawagin nito ang save_skill, na isinusulat ang folder sa parehong user skills directory.
Mga patakarang ipinapatupad ng loader
Hindi nilo-load ang skill na lumalabag sa isa sa mga patakarang ito. Nagla-log ng babala ang Nebo at nilalaktawan ito.
| Patakaran | Detalye |
|---|---|
Nagsisimula ang file sa --- | Ang frontmatter ang dapat na unang laman ng file. Dapat UTF-8 ang file. |
Kailangan ang name | Maliliit na titik, numero at gitling lang; walang gitling sa simula o dulo; walang magkasunod na gitling; hanggang 64 bytes. |
Kailangan ang description | Hanggang 1,024 bytes. |
| Tama ang uri ng mga field | Ang field na mali ang YAML type ay nagpapapalya sa buong file. Lagyan ng quote ang mga version, gaya ng "1.0.0". |
Tumutugma ang platform | Kapag naroon, nilo-load lang ang skill sa mga nakalistang operating system. |
Binabalewala ang mga frontmatter key na hindi kilala ng Nebo. Walang limit sa laki ang body, pero mas maraming puwang para sa trabaho kapag mas maikli ang mga instruction. Ilipat ang mahahabang materyal sa mga file na binabasa ng empleyado kapag kailangan nito.
Magdagdag ng mga file
Available sa empleyado ang anumang file sa folder maliban sa SKILL.md at mga dotfile. Ikaw ang bahala sa mga pangalan ng folder; walang espesyal na kahulugan para sa Nebo ang references/ o assets/. Mapapatakbo ang mga file sa ilalim ng scripts/ o bin/.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Tukuyin ang mga file ayon sa path nila sa loob ng folder, gaya ng references/policy.md. Binabasa ito ng empleyado gamit ang read_skill_file, na tinatanggihan ang anumang path na lumalabas sa folder. Tumatakbo ang mga script gamit ang tool na execute sa isang sandbox. Tinatalakay ng SKILL.md reference ang mga runtime, environment variable, secret at network access.
Kung saan nakalagay ang mga skill
Nangongolekta ang isang bot ng mga skill mula sa ilang lugar. Kapag dalawang pinagmulan ang nagbibigay ng skill na may parehong pangalan, nananaig ang mas huli sa listahang ito.
| Pinagmulan | Lokasyon | Sino ang makakagamit |
|---|---|---|
| Built in | Naka-compile sa loob ng Nebo | Bawat empleyado |
| Marketplace | <data>/nebo/skills/<slug>/<version>/ | Bawat empleyado |
| Plugin | Ang folder na skills/ ng naka-install na plugin | Bawat empleyado |
| User | <data>/user/skills/<name>/ | Bawat empleyado |
| Package ng empleyado | skills/ sa loob ng naka-install na package ng empleyado | Ang empleyadong iyon lang |
| Natutunan | <data>/learned/skills/<employee>/<name>/ | Ang empleyadong iyon lang |
Ang <data> ay ~/Library/Application Support/Nebo sa macOS, %APPDATA%\Nebo sa Windows, at ~/.local/share/nebo sa Linux. Nangingibabaw dito ang environment variable na NEBO_HOME. Kapag may sariling skill ang isang empleyado at may shared na skill na may parehong pangalan, nananaig ang sarili nitong skill.
Binabantayan ng Nebo ang mga folder na ito at nire-reload ang binagong skill pagkalipas ng isang segundo. Para i-off ang skill nang hindi ito binubura, palitan ang pangalan ng file nito ng SKILL.md.disabled.
Inilalarawan ng mga skill ang trabaho, hindi ang mga tool. Isulat ang skill tungkol sa isang responsibilidad, gaya ng pag-reconcile ng mga resibo, at hayaang gamitin ng empleyado ang kahit anong koneksyong ibinigay ng may-ari. Kapag talagang kailangan ng skill ang isang plugin, ideklara ito gamit ang field na plugins.
Susunod
- SKILL.md reference: bawat field, tool at variable.
- Mga halimbawa: kumpletong mga skill na puwedeng kopyahin.
- Publishing: ilagay ang skill sa marketplace.