NeboAI
NeboAI
Zacznij

Umiejętności

Umiejętność uczy pracownika, jak dobrze wykonywać jeden rodzaj pracy. Piszesz ją jako folder z plikiem SKILL.md: krótkim opisem, na podstawie którego pracownik wybiera umiejętność, i instrukcjami, których przestrzega po jej załadowaniu. Umiejętności nie wymagają kodu i może z nich korzystać każdy pracownik na bocie.

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.

  1. 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ć.
  2. Ładowanie. Pracownik wywołuje narzędzie use_skill z 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ść.
  3. Praca. Pracownik wykonuje instrukcje. Odczytuje pliki pomocnicze za pomocą read_skill_file i 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łaSzczegóły
Plik zaczyna się od ---Nagłówek (frontmatter) musi być na samym początku pliku. Plik musi być w UTF-8.
name jest wymaganeTylko małe litery, cyfry i łączniki; bez łącznika na początku lub na końcu; bez podwójnego łącznika; maksymalnie 64 bajty.
description jest wymaganeMaksymalnie 1024 bajty.
Pola mają właściwy typPole o niewłaściwym typie YAML unieważnia cały plik. Wersje ujmuj w cudzysłów, np. "1.0.0".
platform pasujeJeś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łoLokalizacjaKto może z niej korzystać
WbudowaneWkompilowane w NeboKażdy pracownik
Sklep<data>/nebo/skills/<slug>/<version>/Każdy pracownik
WtyczkaFolder skills/ zainstalowanej wtyczkiKażdy pracownik
Użytkownik<data>/user/skills/<name>/Każdy pracownik
Pakiet pracownikaskills/ wewnątrz zainstalowanego pakietu pracownikaTylko 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