Mikä taito on
Taito on kansio, jonka nimi vastaa taidon name-arvoa. Kansiossa on SKILL.md-tiedosto ja halutessasi muita tiedostoja, joihin ohjeet viittaavat: viiteasiakirjoja, malleja tai skriptejä.
SKILL.md koostuu kahdesta osasta. ----rivien välissä oleva YAML-esittelyosa sisältää nimen ja kuvauksen. Sen jälkeinen Markdown-runko sisältää ohjeet.
Miten työntekijät käyttävät taitoja
Työntekijä käyttää taitoa kolmessa vaiheessa.
- Valinta. Joka vuorolla työntekijä näkee luettelon käytettävissään olevista taidoista: kunkin taidon nimen, kuvauksen ja enintään kolme sen laukaisinta. Työntekijä tekee päätöksensä kuvauksen perusteella, joten kirjoita siihen, mitä taito tekee ja milloin sitä käytetään.
- Lataus. Työntekijä kutsuu
use_skill-työkalua taidon nimellä. Työkalu palauttaa ohjeet, taidon kansion polun ja sen tiedostojen nimet. Tämä on ainoa tapa, jolla työntekijä lukee taidon. - Työ. Työntekijä noudattaa ohjeita. Se lukee tukitiedostoja työkalulla
read_skill_fileja suorittaa mukana tulevia skriptejä työkalullaexecute.
Laukaisimet eivät koskaan lataa taitoa itsestään. Valinnan tekee aina työntekijä. Kun luettelo kasvaa pitkäksi, työntekijä voi hakea siitä työkalulla find_skills.
Kirjoita ensimmäinen taitosi
Luo taidon mukaan nimetty kansio ja siihen yksi tiedosto.
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".
Laita kansio botin käyttäjän taitokansioon (katso Missä taidot sijaitsevat). Nebo huomaa uuden kansion noin sekunnissa, ja jokainen botin työntekijä voi käyttää taitoa.
Työntekijä voi myös kirjoittaa taidon puolestasi. Pyydä sitä tallentamaan sellainen, niin se kutsuu save_skill-työkalua, joka kirjoittaa kansion samaan käyttäjän taitokansioon.
Lataajan valvomat säännöt
Taito, joka rikkoo jotakin näistä säännöistä, ei lataudu. Nebo kirjaa varoituksen ja ohittaa sen.
| Sääntö | Tiedot |
|---|---|
Tiedosto alkaa --- | Esittelyosan on oltava tiedoston ensimmäinen asia. Tiedoston on oltava UTF-8-muodossa. |
name on pakollinen | Vain pieniä kirjaimia, numeroita ja yhdysmerkkejä; ei yhdysmerkkiä alussa tai lopussa; ei kahta yhdysmerkkiä peräkkäin; enintään 64 tavua. |
description on pakollinen | Enintään 1 024 tavua. |
| Kentät ovat oikeaa tyyppiä | Väärän YAML-tyypin kenttä hylkää koko tiedoston. Laita versiot lainausmerkkeihin, esimerkiksi "1.0.0". |
platform täsmää | Jos kenttä on mukana, taito latautuu vain luetelluissa käyttöjärjestelmissä. |
Esittelyosan avaimet, joita Nebo ei tunnista, ohitetaan. Rungolla ei ole kokorajaa, mutta lyhyemmät ohjeet jättävät enemmän tilaa työlle. Siirrä pitkä aineisto tiedostoihin, joita työntekijä lukee tarvittaessa.
Lisää tiedostoja
Mikä tahansa kansion tiedosto SKILL.md-tiedostoa ja pistetiedostoja lukuun ottamatta on työntekijän käytettävissä. Saat valita kansioiden nimet itse; Nebo ei anna erityistä merkitystä kansioille references/ tai assets/. Kansioiden scripts/ tai bin/ tiedostoja voi suorittaa.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Viittaa tiedostoihin niiden polulla kansion sisällä, esimerkiksi references/policy.md. Työntekijä lukee ne työkalulla read_skill_file, joka hylkää kaikki kansiosta ulos johtavat polut. Skriptit suoritetaan execute-työkalulla hiekkalaatikossa. SKILL.md-viite kertoo suoritusympäristöistä, ympäristömuuttujista, salaisuuksista ja verkkoyhteydestä.
Missä taidot sijaitsevat
Botti kerää taitoja useasta paikasta. Kun kaksi lähdettä tarjoaa samannimisen taidon, tässä luettelossa myöhempi lähde voittaa.
| Lähde | Sijainti | Kuka voi käyttää |
|---|---|---|
| Sisäänrakennettu | Käännetty Neboon | Jokainen työntekijä |
| Kauppa | <data>/nebo/skills/<slug>/<version>/ | Jokainen työntekijä |
| Laajennus | Asennetun laajennuksen skills/-kansio | Jokainen työntekijä |
| Käyttäjä | <data>/user/skills/<name>/ | Jokainen työntekijä |
| Työntekijäpaketti | skills/ asennetun työntekijäpaketin sisällä | Vain kyseinen työntekijä |
| Opittu | <data>/learned/skills/<employee>/<name>/ | Vain kyseinen työntekijä |
<data> on macOS:ssä ~/Library/Application Support/Nebo, Windowsissa %APPDATA%\Nebo ja Linuxissa ~/.local/share/nebo. Ympäristömuuttuja NEBO_HOME ohittaa sen. Kun työntekijällä on oma taito ja samanniminen jaettu taito, sen oma taito voittaa.
Nebo tarkkailee näitä kansioita ja lataa muuttuneen taidon uudelleen sekunnin kuluttua. Voit poistaa taidon käytöstä poistamatta sitä nimeämällä sen tiedoston uudelleen muotoon SKILL.md.disabled.
Taidot kuvaavat työtä, eivät työkaluja. Kirjoita taito vastuualueen ympärille, kuten kuittien täsmäyttämisen, ja anna työntekijän käyttää mitä tahansa yhteyttä, jonka omistaja on antanut. Kun taito todella tarvitsee laajennuksen, ilmoita se plugins-kentässä.
Seuraavaksi
- SKILL.md-viite: jokainen kenttä, työkalu ja muuttuja.
- Esimerkit: valmiita taitoja kopioitavaksi.
- Julkaiseminen: vie taito kauppaan.