Hvad en færdighed er
En færdighed er en mappe, hvis navn svarer til færdighedens name. Mappen indeholder en SKILL.md-fil og eventuelt andre filer, som instruktionerne henviser til: referencedokumenter, skabeloner eller scripts.
SKILL.md har to dele. YAML-frontmatter mellem ----linjer indeholder navnet og en beskrivelse. Markdown-brødteksten efter den indeholder instruktionerne.
Sådan bruger medarbejdere færdigheder
En medarbejder arbejder med en færdighed i tre trin.
- Vælg. Ved hver tur ser medarbejderen en liste over de færdigheder, den har adgang til: hver færdigheds navn, dens beskrivelse og op til tre af dens udløsere. Beskrivelsen er det, medarbejderen læser for at beslutte sig, så skriv den, så den siger, hvad færdigheden gør, og hvornår den skal bruges.
- Indlæs. Medarbejderen kalder værktøjet
use_skillmed færdighedens navn. Værktøjet returnerer instruktionerne, stien til færdighedens mappe og navnene på dens filer. Det er den eneste måde, en medarbejder læser en færdighed på. - Arbejd. Medarbejderen følger instruktionerne. Den læser understøttende filer med
read_skill_fileog kører medfølgende scripts medexecute.
Udløsere indlæser aldrig en færdighed af sig selv. Det er altid medarbejderen, der vælger. Når listen bliver lang, kan medarbejderen søge i den med find_skills.
Skriv din første færdighed
Opret en mappe, der er navngivet efter færdigheden, med én fil i.
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æg mappen i en bots brugermappe til færdigheder (se Hvor færdigheder ligger). Nebo opdager den nye mappe inden for cirka et sekund, og alle medarbejdere på den bot kan bruge færdigheden.
En medarbejder kan også skrive en færdighed for dig. Bed den om at gemme en, så kalder den save_skill, som skriver mappen ind i den samme brugermappe til færdigheder.
Regler, som indlæseren håndhæver
En færdighed, der bryder en af disse regler, indlæses ikke. Nebo logger en advarsel og springer den over.
| Regel | Detaljer |
|---|---|
Filen starter med --- | Frontmatter skal være det første i filen. Filen skal være UTF-8. |
name er påkrævet | Kun små bogstaver, cifre og bindestreger; ingen bindestreg først eller sidst; ingen dobbelt bindestreg; højst 64 bytes. |
description er påkrævet | Højst 1.024 bytes. |
| Felter har den rigtige type | Et felt med forkert YAML-type får hele filen til at fejle. Sæt versioner i anførselstegn, f.eks. "1.0.0". |
platform matcher | Hvis det er angivet, indlæses færdigheden kun på de angivne operativsystemer. |
Frontmatter-nøgler, som Nebo ikke kender, ignoreres. Brødteksten har ingen størrelsesgrænse, men kortere instruktioner giver mere plads til arbejdet. Flyt langt materiale over i filer, som medarbejderen læser, når den har brug for dem.
Tilføj filer
Alle filer i mappen undtagen SKILL.md og punktumfiler er tilgængelige for medarbejderen. Mappenavne vælger du selv; Nebo tillægger ikke references/ eller assets/ nogen særlig betydning. Filer under scripts/ eller bin/ kan køres.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Henvis til filer med deres sti inde i mappen, f.eks. references/policy.md. Medarbejderen læser dem med read_skill_file, som afviser enhver sti, der fører uden for mappen. Scripts kører med værktøjet execute i en sandkasse. Referencen for SKILL.md dækker kørselsmiljøer, miljøvariabler, hemmeligheder og netværksadgang.
Hvor færdigheder ligger
En bot samler færdigheder fra flere steder. Når to kilder leverer en færdighed med samme navn, vinder den kilde, der står senest på denne liste.
| Kilde | Placering | Hvem kan bruge den |
|---|---|---|
| Indbygget | Kompileret ind i Nebo | Alle medarbejdere |
| Markedsplads | <data>/nebo/skills/<slug>/<version>/ | Alle medarbejdere |
| Plugin | Mappen skills/ i et installeret plugin | Alle medarbejdere |
| Bruger | <data>/user/skills/<name>/ | Alle medarbejdere |
| Medarbejderpakke | skills/ inde i en installeret medarbejderpakke | Kun den medarbejder |
| Lært | <data>/learned/skills/<employee>/<name>/ | Kun den medarbejder |
<data> er ~/Library/Application Support/Nebo på macOS, %APPDATA%\Nebo på Windows og ~/.local/share/nebo på Linux. Miljøvariablen NEBO_HOME tilsidesætter den. Når en medarbejder har sin egen færdighed og en fælles færdighed med samme navn, vinder dens egen færdighed.
Nebo overvåger disse mapper og genindlæser en ændret færdighed efter ét sekund. For at slå en færdighed fra uden at slette den skal du omdøbe dens fil til SKILL.md.disabled.
Færdigheder beskriver arbejde, ikke værktøjer. Skriv en færdighed omkring et ansvarsområde, f.eks. afstemning af kvitteringer, og lad medarbejderen bruge den forbindelse, ejeren har stillet til rådighed. Når en færdighed virkelig kræver et plugin, skal du erklære det med feltet plugins.
Næste
- Reference for SKILL.md: alle felter, værktøjer og variabler.
- Eksempler: komplette færdigheder, du kan kopiere.
- Udgivelse: læg en færdighed på markedspladsen.