Czym jest umiejętność
Umiejętność to folder, którego nazwa odpowiada polu name umiejętności. Folder zawiera plik SKILL.md i opcjonalnie inne pliki, do których odwołują się instrukcje: dokumenty referencyjne, szablony lub skrypty.
SKILL.md ma dwie części. Nagłówek YAML (frontmatter) między wierszami --- zawiera nazwę i opis. Treść w Markdown po nim zawiera instrukcje.
Jak pracownicy korzystają z umiejętności
Pracownik korzysta z umiejętności w trzech krokach.
- Wybór. W każdej turze pracownik widzi listę dostępnych dla niego umiejętności: nazwę każdej umiejętności, jej opis i maksymalnie trzy wyzwalacze. Na podstawie opisu pracownik podejmuje decyzję, więc napisz w nim, co umiejętność robi i kiedy jej używać.
- Ładowanie. Pracownik wywołuje narzędzie
use_skillz nazwą umiejętności. Narzędzie zwraca instrukcje, ścieżkę folderu umiejętności i nazwy jej plików. To jedyny sposób, w jaki pracownik odczytuje umiejętność. - Praca. Pracownik wykonuje instrukcje. Odczytuje pliki pomocnicze za pomocą
read_skill_filei uruchamia dołączone skrypty za pomocąexecute.
Wyzwalacze nigdy same nie ładują umiejętności. Wyboru zawsze dokonuje pracownik. Gdy lista się wydłuża, pracownik może ją przeszukać za pomocą find_skills.
Napisz swoją pierwszą umiejętność
Utwórz folder nazwany tak jak umiejętność, z jednym plikiem w środku.
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".
Umieść folder w katalogu umiejętności użytkownika na bocie (zobacz Gdzie są przechowywane umiejętności). Nebo zauważa nowy folder w ciągu mniej więcej sekundy i każdy pracownik na tym bocie może korzystać z umiejętności.
Pracownik może też napisać umiejętność za Ciebie. Poproś go o zapisanie umiejętności, a wywoła save_skill, które zapisuje folder w tym samym katalogu umiejętności użytkownika.
Reguły egzekwowane przez moduł ładujący
Umiejętność, która łamie jedną z tych reguł, nie zostaje załadowana. Nebo zapisuje ostrzeżenie w dzienniku i ją pomija.
| Reguła | Szczegóły |
|---|---|
Plik zaczyna się od --- | Nagłówek (frontmatter) musi być na samym początku pliku. Plik musi być w UTF-8. |
name jest wymagane | Tylko małe litery, cyfry i łączniki; bez łącznika na początku lub na końcu; bez podwójnego łącznika; maksymalnie 64 bajty. |
description jest wymagane | Maksymalnie 1024 bajty. |
| Pola mają właściwy typ | Pole o niewłaściwym typie YAML unieważnia cały plik. Wersje ujmuj w cudzysłów, np. "1.0.0". |
platform pasuje | Jeśli pole jest obecne, umiejętność ładuje się tylko w wymienionych systemach operacyjnych. |
Klucze nagłówka, których Nebo nie rozpoznaje, są ignorowane. Treść nie ma limitu rozmiaru, ale krótsze instrukcje zostawiają więcej miejsca na pracę. Długie materiały przenieś do plików, które pracownik czyta, gdy ich potrzebuje.
Dodaj pliki
Każdy plik w folderze poza SKILL.md i plikami ukrytymi (zaczynającymi się od kropki) jest dostępny dla pracownika. Nazwy folderów wybierasz sam; Nebo nie nadaje specjalnego znaczenia folderom references/ ani assets/. Pliki w scripts/ lub bin/ można uruchamiać.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Odwołuj się do plików przez ich ścieżkę wewnątrz folderu, np. references/policy.md. Pracownik odczytuje je za pomocą read_skill_file, które odrzuca każdą ścieżkę wychodzącą poza folder. Skrypty uruchamiają się za pomocą narzędzia execute w piaskownicy. Dokumentacja SKILL.md opisuje środowiska wykonawcze, zmienne środowiskowe, sekrety i dostęp do sieci.
Gdzie są przechowywane umiejętności
Bot zbiera umiejętności z kilku miejsc. Gdy dwa źródła dostarczają umiejętność o tej samej nazwie, wygrywa źródło wymienione dalej na tej liście.
| Źródło | Lokalizacja | Kto może z niej korzystać |
|---|---|---|
| Wbudowane | Wkompilowane w Nebo | Każdy pracownik |
| Sklep | <data>/nebo/skills/<slug>/<version>/ | Każdy pracownik |
| Wtyczka | Folder skills/ zainstalowanej wtyczki | Każdy pracownik |
| Użytkownik | <data>/user/skills/<name>/ | Każdy pracownik |
| Pakiet pracownika | skills/ wewnątrz zainstalowanego pakietu pracownika | Tylko ten pracownik |
| Nauczone | <data>/learned/skills/<employee>/<name>/ | Tylko ten pracownik |
<data> to ~/Library/Application Support/Nebo w macOS, %APPDATA%\Nebo w Windows i ~/.local/share/nebo w Linuksie. Zmienna środowiskowa NEBO_HOME go zastępuje. Gdy pracownik ma własną umiejętność i wspólną umiejętność o tej samej nazwie, wygrywa jego własna.
Nebo obserwuje te foldery i ponownie ładuje zmienioną umiejętność po sekundzie. Aby wyłączyć umiejętność bez jej usuwania, zmień nazwę jej pliku na SKILL.md.disabled.
Umiejętności opisują pracę, nie narzędzia. Pisz umiejętność wokół obowiązku, np. uzgadniania paragonów, i pozwól pracownikowi korzystać z dowolnego połączenia zapewnionego przez właściciela. Gdy umiejętność naprawdę potrzebuje wtyczki, zadeklaruj ją w polu plugins.
Dalej
- Dokumentacja SKILL.md: każde pole, narzędzie i zmienna.
- Przykłady: kompletne umiejętności do skopiowania.
- Publikowanie: umieść umiejętność w sklepie.