Що таке навичка
Навичка — це папка, назва якої збігається з name навички. У папці є файл SKILL.md і, за бажанням, будь-які інші файли, на які посилаються інструкції: довідкові документи, шаблони або скрипти.
SKILL.md має дві частини. YAML-заголовок між рядками --- містить назву й опис. Тіло Markdown після нього містить інструкції.
Як співробітники використовують навички
Співробітник працює з навичкою у три кроки.
- Вибір. Щоходу співробітник бачить список доступних йому навичок: назву кожної навички, її опис і до трьох її тригерів. Саме опис співробітник читає, щоб вирішити, тож пишіть у ньому, що робить навичка і коли її використовувати.
- Завантаження. Співробітник викликає інструмент
use_skillіз назвою навички. Інструмент повертає інструкції, шлях до папки навички й назви її файлів. Це єдиний спосіб, у який співробітник читає навичку. - Робота. Співробітник виконує інструкції. Допоміжні файли він читає за допомогою
read_skill_file, а вбудовані скрипти запускає за допомогоюexecute.
Тригери ніколи не завантажують навичку самі. Вибір завжди робить співробітник. Коли список стає довгим, співробітник може шукати в ньому за допомогою find_skills.
Напишіть свою першу навичку
Створіть папку з назвою навички й одним файлом у ній.
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".
Покладіть папку в каталог користувацьких навичок бота (див. Де зберігаються навички). Nebo помічає нову папку приблизно за секунду, і навичку може використовувати кожен співробітник на цьому боті.
Співробітник також може написати навичку для вас. Попросіть його зберегти її, і він викличе save_skill, який записує папку в той самий каталог користувацьких навичок.
Правила, які застосовує завантажувач
Навичка, яка порушує одне з цих правил, не завантажується. Nebo записує попередження в журнал і пропускає її.
| Правило | Подробиці |
|---|---|
Файл починається з --- | Заголовок має бути першим у файлі. Файл має бути в UTF-8. |
name обов'язковий | Лише малі літери, цифри й дефіси; без дефіса на початку чи в кінці; без подвійного дефіса; щонайбільше 64 байти. |
description обов'язковий | Щонайбільше 1 024 байти. |
| Поля мають правильний тип | Поле з неправильним типом YAML ламає весь файл. Беріть версії в лапки, наприклад "1.0.0". |
platform збігається | Якщо поле є, навичка завантажується лише на перелічених операційних системах. |
Ключі заголовка, яких Nebo не розпізнає, ігноруються. Розмір тіла не обмежено, але коротші інструкції залишають більше місця для роботи. Довгі матеріали перенесіть у файли, які співробітник читає, коли вони йому потрібні.
Додайте файли
Будь-який файл у папці, крім SKILL.md і файлів, що починаються з крапки, доступний співробітнику. Назви папок обираєте ви; Nebo не надає особливого значення references/ чи assets/. Файли в scripts/ або bin/ можна запускати.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Посилайтеся на файли за шляхом усередині папки, наприклад references/policy.md. Співробітник читає їх за допомогою read_skill_file, який відхиляє будь-який шлях, що виходить за межі папки. Скрипти запускаються інструментом execute у пісочниці. Довідник SKILL.md описує середовища виконання, змінні середовища, секрети й доступ до мережі.
Де зберігаються навички
Бот збирає навички з кількох місць. Коли два джерела надають навичку з однаковою назвою, перемагає те, що стоїть у цьому списку пізніше.
| Джерело | Розташування | Хто може використовувати |
|---|---|---|
| Вбудована | Вбудовано в Nebo під час збирання | Кожен співробітник |
| Маркетплейс | <data>/nebo/skills/<slug>/<version>/ | Кожен співробітник |
| Плагін | Папка skills/ установленого плагіна | Кожен співробітник |
| Користувач | <data>/user/skills/<name>/ | Кожен співробітник |
| Пакет співробітника | skills/ усередині встановленого пакета співробітника | Лише цей співробітник |
| Вивчена | <data>/learned/skills/<employee>/<name>/ | Лише цей співробітник |
<data> — це ~/Library/Application Support/Nebo на macOS, %APPDATA%\Nebo на Windows і ~/.local/share/nebo на Linux. Змінна середовища NEBO_HOME його перевизначає. Коли співробітник має власну навичку і спільну навичку з тією самою назвою, перемагає його власна.
Nebo стежить за цими папками й перезавантажує змінену навичку через секунду. Щоб вимкнути навичку, не видаляючи її, перейменуйте її файл на SKILL.md.disabled.
Навички описують роботу, а не інструменти. Пишіть навичку навколо обов'язку, наприклад звірки чеків, і дозвольте співробітнику використовувати будь-яке підключення, яке надав власник. Коли навичці справді потрібен плагін, оголосіть його в полі plugins.
Далі
- Довідник SKILL.md: кожне поле, інструмент і змінна.
- Приклади: готові навички, які можна скопіювати.
- Публікація: розмістіть навичку в маркетплейсі.