NeboAI
NeboAI
Kezdés

Készségek

A készség megtanítja a munkatársnak, hogyan végezzen jól egyfajta munkát. Egy SKILL.md fájlt tartalmazó mappaként írja meg: egy rövid leírással, amely alapján a munkatárs kiválasztja a készséget, és utasításokkal, amelyeket a betöltése után követ. A készségekhez nem kell kód, és egy bot minden munkatársa használhatja őket.

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.

  1. 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.
  2. Betöltés. A munkatárs meghívja a use_skill eszkö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.
  3. Munka. A munkatárs követi az utasításokat. A kiegészítő fájlokat a read_skill_file eszközzel olvassa, a csomagolt szkripteket pedig az execute eszkö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ályRészletek
A fájl --- sorral kezdődikA 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 helyesEgy 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 egyezikHa 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ásHelyKi használhatja
BeépítettA Nebóba fordítvaMinden munkatárs
Piactér<data>/nebo/skills/<slug>/<version>/Minden munkatárs
BővítményEgy telepített bővítmény skills/ mappájaMinden munkatárs
Felhasználói<data>/user/skills/<name>/Minden munkatárs
Munkatárscsomagskills/ egy telepített munkatárscsomagon belülCsak 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ő