Ce este o abilitate
O abilitate este un folder al cărui nume corespunde cu name al abilității. Folderul conține un fișier SKILL.md și, opțional, orice alte fișiere la care se referă instrucțiunile: documente de referință, șabloane sau scripturi.
SKILL.md are două părți. Frontmatterul YAML dintre liniile --- conține numele și o descriere. Corpul Markdown de după el conține instrucțiunile.
Cum folosesc angajații abilitățile
Un angajat lucrează cu o abilitate în trei pași.
- Alege. La fiecare tură, angajatul vede o listă cu abilitățile disponibile: numele fiecărei abilități, descrierea ei și până la trei dintre declanșatoarele ei. Descrierea este ceea ce citește angajatul ca să decidă, așa că scrie-o astfel încât să spună ce face abilitatea și când se folosește.
- Încarcă. Angajatul apelează instrumentul
use_skillcu numele abilității. Instrumentul returnează instrucțiunile, calea folderului abilității și numele fișierelor ei. Acesta este singurul mod în care un angajat citește o abilitate. - Lucrează. Angajatul urmează instrucțiunile. Citește fișierele auxiliare cu
read_skill_fileși rulează scripturile incluse cuexecute.
Declanșatoarele nu încarcă niciodată singure o abilitate. Angajatul face întotdeauna alegerea. Când lista devine lungă, angajatul o poate căuta cu find_skills.
Scrie-ți prima abilitate
Creează un folder numit după abilitate, cu un singur fișier în el.
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".
Pune folderul în directorul de abilități al utilizatorului de pe un bot (vezi Unde se află abilitățile). Nebo observă folderul nou în aproximativ o secundă și fiecare angajat de pe acel bot poate folosi abilitatea.
Un angajat poate scrie și el o abilitate pentru tine. Cere-i să salveze una și va apela save_skill, care scrie folderul în același director de abilități al utilizatorului.
Reguli impuse de încărcător
O abilitate care încalcă una dintre aceste reguli nu se încarcă. Nebo înregistrează un avertisment și o sare.
| Regulă | Detaliu |
|---|---|
Fișierul începe cu --- | Frontmatterul trebuie să fie primul lucru din fișier. Fișierul trebuie să fie UTF-8. |
name este obligatoriu | Doar litere mici, cifre și cratime; fără cratimă la început sau la sfârșit; fără cratimă dublă; cel mult 64 de octeți. |
description este obligatoriu | Cel mult 1.024 de octeți. |
| Câmpurile au tipul corect | Un câmp cu tipul YAML greșit invalidează întregul fișier. Pune versiunile între ghilimele, de exemplu "1.0.0". |
platform se potrivește | Dacă există, abilitatea se încarcă doar pe sistemele de operare listate. |
Cheile de frontmatter pe care Nebo nu le recunoaște sunt ignorate. Corpul nu are limită de dimensiune, dar instrucțiunile mai scurte lasă mai mult loc pentru muncă. Mută materialele lungi în fișiere pe care angajatul le citește când are nevoie de ele.
Adaugă fișiere
Orice fișier din folder, în afară de SKILL.md și de fișierele care încep cu punct, este disponibil pentru angajat. Numele folderelor le alegi tu; Nebo nu dă un sens special lui references/ sau assets/. Fișierele din scripts/ sau bin/ pot fi rulate.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Referă-te la fișiere prin calea lor din folder, de exemplu references/policy.md. Angajatul le citește cu read_skill_file, care respinge orice cale ce iese din folder. Scripturile rulează cu instrumentul execute într-un sandbox. Referința SKILL.md acoperă mediile de rulare, variabilele de mediu, secretele și accesul la rețea.
Unde se află abilitățile
Un bot adună abilități din mai multe locuri. Când două surse oferă o abilitate cu același nume, sursa care apare mai târziu în această listă are prioritate.
| Sursă | Locație | Cine o poate folosi |
|---|---|---|
| Integrată | Compilată în Nebo | Toți angajații |
| Magazin | <data>/nebo/skills/<slug>/<version>/ | Toți angajații |
| Plugin | Folderul skills/ al unui plugin instalat | Toți angajații |
| Utilizator | <data>/user/skills/<name>/ | Toți angajații |
| Pachet de angajat | skills/ din interiorul unui pachet de angajat instalat | Doar acel angajat |
| Învățată | <data>/learned/skills/<employee>/<name>/ | Doar acel angajat |
<data> este ~/Library/Application Support/Nebo pe macOS, %APPDATA%\Nebo pe Windows și ~/.local/share/nebo pe Linux. Variabila de mediu NEBO_HOME îl înlocuiește. Când un angajat are o abilitate proprie și o abilitate comună cu același nume, abilitatea proprie are prioritate.
Nebo urmărește aceste foldere și reîncarcă o abilitate modificată după o secundă. Ca să dezactivezi o abilitate fără să o ștergi, redenumește-i fișierul în SKILL.md.disabled.
Abilitățile descriu munca, nu instrumentele. Scrie o abilitate în jurul unei responsabilități, de exemplu reconcilierea chitanțelor, și lasă angajatul să folosească orice conexiune i-a oferit proprietarul. Când o abilitate chiar are nevoie de un plugin, declară-l cu câmpul plugins.
Mai departe
- Referința SKILL.md: fiecare câmp, instrument și variabilă.
- Exemple: abilități complete de copiat.
- Publicare: pune o abilitate în magazin.