Mi a készség
A készség egy mappa, amelynek neve megegyezik a készség name értékével. A mappa egy SKILL.md fájlt és opcionálisan bármely más fájlt tartalmaz, amelyre az utasítások hivatkoznak: referenciadokumentumokat, sablonokat vagy szkripteket.
A SKILL.md két részből áll. A --- sorok közötti YAML-fejléc tartalmazza a nevet és a leírást. Az utána következő Markdown-törzs tartalmazza az utasításokat.
Hogyan használják a munkatársak a készségeket
A munkatárs három lépésben dolgozik egy készséggel.
- Kiválasztás. A munkatárs minden körben látja a számára elérhető készségek listáját: minden készség nevét, leírását és legfeljebb három indítószavát. A munkatárs a leírás alapján dönt, ezért úgy írja meg, hogy elmondja, mit csinál a készség, és mikor kell használni.
- Betöltés. A munkatárs meghívja a
use_skilleszközt a készség nevével. Az eszköz visszaadja az utasításokat, a készség mappájának elérési útját és a fájljai nevét. Egy munkatárs csak így olvashat be egy készséget. - Munka. A munkatárs követi az utasításokat. A kiegészítő fájlokat a
read_skill_fileeszközzel olvassa, a csomagolt szkripteket pedig azexecuteeszközzel futtatja.
Az indítószavak soha nem töltenek be maguktól egy készséget. A döntést mindig a munkatárs hozza meg. Ha a lista hosszúra nő, a munkatárs a find_skills eszközzel kereshet benne.
Az első készség megírása
Hozzon létre egy mappát a készség nevével, benne egy fájllal.
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".
Tegye a mappát egy bot felhasználói készségmappájába (lásd: Hol találhatók a készségek). A Nebo körülbelül egy másodpercen belül észleli az új mappát, és az adott bot minden munkatársa használhatja a készséget.
Egy munkatárs is megírhat Önnek egy készséget. Kérje meg, hogy mentsen el egyet, ő pedig meghívja a save_skill eszközt, amely ugyanabba a felhasználói készségmappába írja a mappát.
A betöltő által kikényszerített szabályok
Az ezen szabályok valamelyikét megszegő készség nem töltődik be. A Nebo figyelmeztetést naplóz, és kihagyja.
| Szabály | Részletek |
|---|---|
A fájl --- sorral kezdődik | A fejlécnek kell a fájl elején állnia. A fájlnak UTF-8 kódolásúnak kell lennie. |
A name kötelező | Csak kisbetűk, számjegyek és kötőjelek; nem kezdődhet és nem végződhet kötőjellel; nem lehet benne dupla kötőjel; legfeljebb 64 bájt. |
A description kötelező | Legfeljebb 1024 bájt. |
| A mezők típusa helyes | Egy hibás YAML-típusú mező az egész fájlt érvényteleníti. A verziókat tegye idézőjelbe, például "1.0.0". |
A platform egyezik | Ha meg van adva, a készség csak a felsorolt operációs rendszereken töltődik be. |
A Nebo által nem ismert fejléckulcsokat figyelmen kívül hagyja. A törzsnek nincs méretkorlátja, de a rövidebb utasítások több helyet hagynak a munkának. A hosszú anyagot tegye fájlokba, amelyeket a munkatárs akkor olvas el, amikor szüksége van rájuk.
Fájlok hozzáadása
A mappában a SKILL.md és a pontfájlok kivételével minden fájl elérhető a munkatárs számára. A mappaneveket Ön választja meg; a Nebo nem tulajdonít különleges jelentést a references/ vagy az assets/ mappának. A scripts/ vagy bin/ alatti fájlok futtathatók.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute A fájlokra a mappán belüli elérési útjukkal hivatkozzon, például references/policy.md. A munkatárs a read_skill_file eszközzel olvassa őket, amely elutasít minden olyan útvonalat, amely kivezet a mappából. A szkriptek az execute eszközzel futnak egy homokozóban. A SKILL.md referencia ismerteti a futtatókörnyezeteket, a környezeti változókat, a titkos adatokat és a hálózati hozzáférést.
Hol találhatók a készségek
Egy bot több helyről gyűjti a készségeket. Ha két forrás azonos nevű készséget ad, a listában későbbi forrás érvényesül.
| Forrás | Hely | Ki használhatja |
|---|---|---|
| Beépített | A Nebóba fordítva | Minden munkatárs |
| Piactér | <data>/nebo/skills/<slug>/<version>/ | Minden munkatárs |
| Bővítmény | Egy telepített bővítmény skills/ mappája | Minden munkatárs |
| Felhasználói | <data>/user/skills/<name>/ | Minden munkatárs |
| Munkatárscsomag | skills/ egy telepített munkatárscsomagon belül | Csak az a munkatárs |
| Tanult | <data>/learned/skills/<employee>/<name>/ | Csak az a munkatárs |
A <data> macOS-en a ~/Library/Application Support/Nebo, Windowson a %APPDATA%\Nebo, Linuxon a ~/.local/share/nebo. A NEBO_HOME környezeti változó felülírja. Ha egy munkatársnak van saját készsége és egy azonos nevű közös készsége, a saját készsége érvényesül.
A Nebo figyeli ezeket a mappákat, és egy másodperc után újratölti a módosított készséget. Ha törlés nélkül szeretne kikapcsolni egy készséget, nevezze át a fájlját SKILL.md.disabled névre.
A készségek munkát írnak le, nem eszközöket. A készséget egy feladatkör köré írja, például a nyugták egyeztetése köré, és hagyja, hogy a munkatárs azt a kapcsolatot használja, amelyet a tulajdonos biztosított. Ha egy készségnek valóban bővítményre van szüksége, adja meg a plugins mezőben.
Következő
- SKILL.md referencia: minden mező, eszköz és változó.
- Példák: teljes, másolható készségek.
- Közzététel: készség feltöltése a piactérre.