Vad en färdighet är
En färdighet är en mapp vars namn matchar färdighetens name. Mappen innehåller en SKILL.md-fil och, om du vill, andra filer som instruktionerna hänvisar till: referensdokument, mallar eller skript.
SKILL.md har två delar. YAML-frontmatter mellan ----rader innehåller namnet och en beskrivning. Markdown-innehållet efter den innehåller instruktionerna.
Så använder medarbetare färdigheter
En medarbetare arbetar med en färdighet i tre steg.
- Välj. Vid varje tur ser medarbetaren en lista över de färdigheter som är tillgängliga för den: varje färdighets namn, dess beskrivning och upp till tre av dess utlösare. Beskrivningen är det medarbetaren läser för att bestämma sig, så skriv den så att den säger vad färdigheten gör och när den ska användas.
- Ladda. Medarbetaren anropar verktyget
use_skillmed färdighetens namn. Verktyget returnerar instruktionerna, sökvägen till färdighetens mapp och namnen på dess filer. Det är det enda sättet en medarbetare läser en färdighet på. - Arbeta. Medarbetaren följer instruktionerna. Den läser stödfiler med
read_skill_fileoch kör medföljande skript medexecute.
Utlösare laddar aldrig en färdighet på egen hand. Det är alltid medarbetaren som väljer. När listan blir lång kan medarbetaren söka i den med find_skills.
Skriv din första färdighet
Skapa en mapp med färdighetens namn och en fil i den.
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".
Lägg mappen i en bots användarkatalog för färdigheter (se Var färdigheter finns). Nebo märker den nya mappen inom ungefär en sekund, och alla medarbetare på den boten kan använda färdigheten.
En medarbetare kan också skriva en färdighet åt dig. Be den spara en, så anropar den save_skill, som skriver mappen till samma användarkatalog för färdigheter.
Regler som laddaren tillämpar
En färdighet som bryter mot någon av de här reglerna laddas inte. Nebo loggar en varning och hoppar över den.
| Regel | Detalj |
|---|---|
Filen börjar med --- | Frontmatter måste stå först i filen. Filen måste vara UTF-8. |
name är obligatoriskt | Endast gemener, siffror och bindestreck; inget inledande eller avslutande bindestreck; inget dubbelt bindestreck; högst 64 byte. |
description är obligatoriskt | Högst 1 024 byte. |
| Fälten har rätt typ | Ett fält med fel YAML-typ gör hela filen ogiltig. Sätt citattecken kring versioner, till exempel "1.0.0". |
platform matchar | Om fältet finns laddas färdigheten bara på de listade operativsystemen. |
Frontmatter-nycklar som Nebo inte känner igen ignoreras. Innehållet har ingen storleksgräns, men kortare instruktioner lämnar mer utrymme för arbetet. Flytta långt material till filer som medarbetaren läser när den behöver dem.
Lägg till filer
Alla filer i mappen utom SKILL.md och punktfiler är tillgängliga för medarbetaren. Mappnamnen väljer du själv; Nebo ger ingen särskild betydelse åt references/ eller assets/. Filer under scripts/ eller bin/ kan köras.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Hänvisa till filer med deras sökväg i mappen, till exempel references/policy.md. Medarbetaren läser dem med read_skill_file, som avvisar alla sökvägar som lämnar mappen. Skript körs med verktyget execute i en sandlåda. SKILL.md-referensen beskriver körmiljöer, miljövariabler, hemligheter och nätverksåtkomst.
Var färdigheter finns
En bot samlar färdigheter från flera ställen. När två källor tillhandahåller en färdighet med samma namn vinner den källa som står senare i listan.
| Källa | Plats | Vem som kan använda den |
|---|---|---|
| Inbyggd | Inkompilerad i Nebo | Alla medarbetare |
| Marknadsplats | <data>/nebo/skills/<slug>/<version>/ | Alla medarbetare |
| Plugin | Mappen skills/ i ett installerat plugin | Alla medarbetare |
| Användare | <data>/user/skills/<name>/ | Alla medarbetare |
| Medarbetarpaket | skills/ i ett installerat medarbetarpaket | Bara den medarbetaren |
| Inlärd | <data>/learned/skills/<employee>/<name>/ | Bara den medarbetaren |
<data> är ~/Library/Application Support/Nebo på macOS, %APPDATA%\Nebo på Windows och ~/.local/share/nebo på Linux. Miljövariabeln NEBO_HOME åsidosätter den. När en medarbetare har en egen färdighet och en delad färdighet med samma namn vinner den egna färdigheten.
Nebo bevakar de här mapparna och laddar om en ändrad färdighet efter en sekund. För att stänga av en färdighet utan att radera den byter du namn på dess fil till SKILL.md.disabled.
Färdigheter beskriver arbete, inte verktyg. Skriv en färdighet kring ett ansvarsområde, till exempel att stämma av kvitton, och låt medarbetaren använda den anslutning som ägaren har gett den. När en färdighet verkligen behöver ett plugin anger du det med fältet plugins.
Nästa steg
- SKILL.md-referens: varje fält, verktyg och variabel.
- Exempel: kompletta färdigheter att kopiera.
- Publicering: lägg ut en färdighet på marknadsplatsen.