Čo je zručnosť
Zručnosť je priečinok, ktorého názov zodpovedá poľu name zručnosti. Priečinok obsahuje súbor SKILL.md a voliteľne ďalšie súbory, na ktoré sa pokyny odvolávajú: referenčné dokumenty, šablóny alebo skripty.
SKILL.md má dve časti. Úvodná časť YAML medzi riadkami --- nesie názov a popis. Telo v Markdowne za ňou nesie pokyny.
Ako zamestnanci používajú zručnosti
Zamestnanec pracuje so zručnosťou v troch krokoch.
- Výber. V každom ťahu zamestnanec vidí zoznam zručností, ktoré má k dispozícii: názov každej zručnosti, jej popis a až tri jej spúšťače. Podľa popisu sa zamestnanec rozhoduje, preto v ňom napíšte, čo zručnosť robí a kedy ju použiť.
- Načítanie. Zamestnanec zavolá nástroj
use_skills názvom zručnosti. Nástroj vráti pokyny, cestu k priečinku zručnosti a názvy jej súborov. Je to jediný spôsob, akým zamestnanec zručnosť číta. - Práca. Zamestnanec postupuje podľa pokynov. Podporné súbory číta pomocou
read_skill_filea pribalené skripty spúšťa pomocouexecute.
Spúšťače nikdy nenačítajú zručnosť samy. Rozhodnutie vždy urobí zamestnanec. Keď sa zoznam predĺži, zamestnanec v ňom môže hľadať pomocou find_skills.
Napíšte svoju prvú zručnosť
Vytvorte priečinok pomenovaný podľa zručnosti a vložte doň jeden súbor.
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".
Priečinok vložte do adresára používateľských zručností bota (pozrite Kde sú zručnosti uložené). Nebo nový priečinok zaznamená zhruba do sekundy a zručnosť potom môže používať každý zamestnanec na tomto botovi.
Zručnosť vám môže napísať aj zamestnanec. Požiadajte ho, nech ju uloží, a on zavolá save_skill, ktorý zapíše priečinok do toho istého adresára používateľských zručností.
Pravidlá, ktoré zavádzač vynucuje
Zručnosť, ktorá poruší niektoré z týchto pravidiel, sa nenačíta. Nebo zapíše do protokolu varovanie a preskočí ju.
| Pravidlo | Podrobnosti |
|---|---|
Súbor začína --- | Úvodná časť musí byť na samom začiatku súboru. Súbor musí byť v kódovaní UTF-8. |
name je povinné | Iba malé písmená, číslice a spojovníky; bez spojovníka na začiatku alebo na konci; bez zdvojeného spojovníka; najviac 64 bajtov. |
description je povinné | Najviac 1 024 bajtov. |
| Polia majú správny typ | Pole s nesprávnym typom YAML znehodnotí celý súbor. Verzie dávajte do úvodzoviek, napríklad "1.0.0". |
platform sa zhoduje | Ak je uvedené, zručnosť sa načíta iba v uvedených operačných systémoch. |
Kľúče úvodnej časti, ktoré Nebo nepozná, sa ignorujú. Veľkosť tela nie je obmedzená, no kratšie pokyny nechajú viac priestoru na prácu. Dlhší materiál presuňte do súborov, ktoré si zamestnanec prečíta, keď ich potrebuje.
Pridanie súborov
Každý súbor v priečinku okrem SKILL.md a súborov začínajúcich bodkou je zamestnancovi dostupný. Názvy priečinkov si vyberáte sami; Nebo nepripisuje references/ ani assets/ žiadny osobitný význam. Súbory v scripts/ alebo bin/ sa dajú spúšťať.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Na súbory odkazujte cestou v rámci priečinka, napríklad references/policy.md. Zamestnanec ich číta pomocou read_skill_file, ktorý odmietne každú cestu mimo priečinka. Skripty sa spúšťajú nástrojom execute v izolovanom prostredí. Referencia k SKILL.md opisuje prostredia behu, premenné prostredia, tajné údaje a prístup k sieti.
Kde sú zručnosti uložené
Bot zbiera zručnosti z viacerých miest. Keď dva zdroje poskytujú zručnosť s rovnakým názvom, vyhrá zdroj, ktorý je v tomto zozname neskôr.
| Zdroj | Umiestnenie | Kto ju môže používať |
|---|---|---|
| Vstavané | Zabudované priamo v Nebo | Každý zamestnanec |
| Obchod | <data>/nebo/skills/<slug>/<version>/ | Každý zamestnanec |
| Doplnok | Priečinok skills/ nainštalovaného doplnku | Každý zamestnanec |
| Používateľ | <data>/user/skills/<name>/ | Každý zamestnanec |
| Balík zamestnanca | skills/ v nainštalovanom balíku zamestnanca | Iba tento zamestnanec |
| Naučené | <data>/learned/skills/<employee>/<name>/ | Iba tento zamestnanec |
<data> je ~/Library/Application Support/Nebo v macOS, %APPDATA%\Nebo vo Windows a ~/.local/share/nebo v Linuxe. Premenná prostredia NEBO_HOME túto cestu prepíše. Keď má zamestnanec vlastnú zručnosť a zdieľanú zručnosť s rovnakým názvom, vyhrá jeho vlastná.
Nebo tieto priečinky sleduje a zmenenú zručnosť znova načíta po jednej sekunde. Ak chcete zručnosť vypnúť bez odstránenia, premenujte jej súbor na SKILL.md.disabled.
Zručnosti opisujú prácu, nie nástroje. Zručnosť postavte na zodpovednosti, napríklad na odsúhlasovaní účteniek, a nechajte zamestnanca použiť akékoľvek pripojenie, ktoré vlastník poskytol. Keď zručnosť naozaj potrebuje doplnok, deklarujte ho v poli plugins.
Ďalej
- Referencia k SKILL.md: každé pole, nástroj a premenná.
- Príklady: kompletné zručnosti na skopírovanie.
- Zverejňovanie: ako dať zručnosť do obchodu.