Co je dovednost
Dovednost je složka, jejíž název odpovídá hodnotě name dovednosti. Složka obsahuje soubor SKILL.md a volitelně další soubory, na které pokyny odkazují: referenční dokumenty, šablony nebo skripty.
SKILL.md má dvě části. Úvodní blok YAML mezi řádky --- nese název a popis. Tělo v Markdownu za ním nese pokyny.
Jak zaměstnanci dovednosti používají
Zaměstnanec pracuje s dovedností ve třech krocích.
- Výběr. V každém tahu zaměstnanec vidí seznam dovedností, které má k dispozici: název každé dovednosti, její popis a až tři její spouštěče. Podle popisu se zaměstnanec rozhoduje, takže v něm uveďte, co dovednost dělá a kdy ji použít.
- Načtení. Zaměstnanec zavolá nástroj
use_skills názvem dovednosti. Nástroj vrátí pokyny, cestu ke složce dovednosti a názvy jejích souborů. Jiným způsobem zaměstnanec dovednost nečte. - Práce. Zaměstnanec postupuje podle pokynů. Podpůrné soubory čte pomocí
read_skill_filea přibalené skripty spouští pomocíexecute.
Spouštěče nikdy dovednost samy nenačtou. Rozhodnutí vždy dělá zaměstnanec. Když se seznam prodlouží, může v něm zaměstnanec hledat pomocí find_skills.
Napište svou první dovednost
Vytvořte složku pojmenovanou podle dovednosti a vložte do ní jeden soubor.
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".
Vložte složku do uživatelského adresáře dovedností na botovi (viz Kde jsou dovednosti uložené). Nebo si nové složky všimne přibližně do sekundy a každý zaměstnanec na tomto botovi může dovednost používat.
Dovednost vám může napsat i zaměstnanec. Požádejte ho, ať nějakou uloží, a on zavolá save_skill, který zapíše složku do stejného uživatelského adresáře dovedností.
Pravidla, která zavaděč vynucuje
Dovednost, která poruší některé z těchto pravidel, se nenačte. Nebo zapíše do protokolu varování a dovednost přeskočí.
| Pravidlo | Podrobnosti |
|---|---|
Soubor začíná --- | Úvodní blok musí být v souboru úplně první. Soubor musí být v kódování UTF-8. |
name je povinné | Pouze malá písmena, číslice a pomlčky; bez pomlčky na začátku nebo na konci; bez dvojité pomlčky; nejvýše 64 bajtů. |
description je povinné | Nejvýše 1 024 bajtů. |
| Pole mají správný typ | Pole s nesprávným typem YAML znehodnotí celý soubor. Verze uvádějte v uvozovkách, například "1.0.0". |
platform odpovídá | Pokud je uvedeno, dovednost se načte jen v uvedených operačních systémech. |
Klíče úvodního bloku, které Nebo nezná, se ignorují. Velikost těla není omezená, ale kratší pokyny nechávají víc prostoru pro samotnou práci. Rozsáhlé materiály přesuňte do souborů, které si zaměstnanec přečte, až je bude potřebovat.
Přidání souborů
Každý soubor ve složce kromě SKILL.md a skrytých souborů začínajících tečkou je zaměstnanci k dispozici. Názvy složek volíte sami; Nebo nepřikládá references/ ani assets/ žádný zvláštní význam. Soubory ve složkách scripts/ a bin/ lze spouštět.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Na soubory odkazujte cestou uvnitř složky, například references/policy.md. Zaměstnanec je čte pomocí read_skill_file, který odmítne každou cestu vedoucí mimo složku. Skripty se spouštějí nástrojem execute v izolovaném prostředí. Referenční příručka k SKILL.md popisuje běhová prostředí, proměnné prostředí, tajné údaje a přístup k síti.
Kde jsou dovednosti uložené
Bot sbírá dovednosti z několika míst. Když dva zdroje poskytují dovednost se stejným názvem, má přednost zdroj, který je v tomto seznamu uveden později.
| Zdroj | Umístění | Kdo ji může používat |
|---|---|---|
| Vestavěné | Zkompilováno přímo do Nebo | Každý zaměstnanec |
| Obchod | <data>/nebo/skills/<slug>/<version>/ | Každý zaměstnanec |
| Plugin | Složka skills/ nainstalovaného pluginu | Každý zaměstnanec |
| Uživatel | <data>/user/skills/<name>/ | Každý zaměstnanec |
| Balíček zaměstnance | skills/ uvnitř nainstalovaného balíčku zaměstnance | Pouze daný zaměstnanec |
| Naučené | <data>/learned/skills/<employee>/<name>/ | Pouze daný zaměstnanec |
<data> je ~/Library/Application Support/Nebo v macOS, %APPDATA%\Nebo ve Windows a ~/.local/share/nebo v Linuxu. Proměnná prostředí NEBO_HOME tuto hodnotu přepíše. Když má zaměstnanec vlastní dovednost a sdílenou dovednost se stejným názvem, má přednost jeho vlastní.
Nebo tyto složky sleduje a změněnou dovednost po jedné sekundě znovu načte. Chcete-li dovednost vypnout, aniž byste ji smazali, přejmenujte její soubor na SKILL.md.disabled.
Dovednosti popisují práci, ne nástroje. Napište dovednost kolem určité odpovědnosti, například odsouhlasování účtenek, a nechte zaměstnance použít jakékoli připojení, které vlastník poskytl. Pokud dovednost opravdu potřebuje plugin, deklarujte ho v poli plugins.
Dále
- Referenční příručka k SKILL.md: každé pole, nástroj a proměnná.
- Příklady: kompletní dovednosti ke zkopírování.
- Publikování: jak dát dovednost do obchodu.