Beceri nedir
Beceri, adı becerinin name değeriyle eşleşen bir klasördür. Klasörde bir SKILL.md dosyası ve isteğe bağlı olarak talimatların atıfta bulunduğu diğer dosyalar bulunur: başvuru belgeleri, şablonlar veya betikler.
SKILL.md iki bölümden oluşur. --- satırları arasındaki YAML ön bilgisi adı ve açıklamayı taşır. Ardından gelen Markdown gövdesi talimatları taşır.
Çalışanlar becerileri nasıl kullanır
Bir çalışan bir beceriyle üç adımda çalışır.
- Seçer. Her turda çalışan, kullanabileceği becerilerin bir listesini görür: her becerinin adı, açıklaması ve en fazla üç tetikleyicisi. Çalışanın karar vermek için okuduğu şey açıklamadır; bu yüzden onu becerinin ne yaptığını ve ne zaman kullanılacağını söyleyecek şekilde yazın.
- Yükler. Çalışan, becerinin adıyla
use_skillaracını çağırır. Araç talimatları, becerinin klasörünün yolunu ve dosyalarının adlarını döndürür. Bir çalışanın bir beceriyi okumasının tek yolu budur. - Çalışır. Çalışan talimatları izler. Destekleyici dosyaları
read_skill_fileile okur ve paketlenmiş betikleriexecuteile çalıştırır.
Tetikleyiciler bir beceriyi asla kendi başlarına yüklemez. Seçimi her zaman çalışan yapar. Liste uzadığında çalışan onu find_skills ile arayabilir.
İlk becerinizi yazın
Becerinin adını taşıyan ve içinde tek bir dosya bulunan bir klasör oluşturun.
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".
Klasörü bir botun kullanıcı becerileri dizinine koyun (bkz. Beceriler nerede bulunur). Nebo yeni klasörü yaklaşık bir saniye içinde fark eder ve o bottaki her çalışan beceriyi kullanabilir.
Bir çalışan sizin için de bir beceri yazabilir. Ondan bir tane kaydetmesini isteyin; save_skill aracını çağırır ve klasörü aynı kullanıcı becerileri dizinine yazar.
Yükleyicinin uyguladığı kurallar
Bu kurallardan birini çiğneyen bir beceri yüklenmez. Nebo bir uyarı kaydeder ve onu atlar.
| Kural | Ayrıntı |
|---|---|
Dosya --- ile başlar | Ön bilgi dosyadaki ilk şey olmalıdır. Dosya UTF-8 olmalıdır. |
name zorunludur | Yalnızca küçük harfler, rakamlar ve kısa çizgiler; başta veya sonda kısa çizgi yok; art arda iki kısa çizgi yok; en fazla 64 bayt. |
description zorunludur | En fazla 1.024 bayt. |
| Alanlar doğru türdedir | YAML türü yanlış olan bir alan tüm dosyayı geçersiz kılar. Sürümleri "1.0.0" gibi tırnak içine alın. |
platform eşleşir | Varsa, beceri yalnızca listelenen işletim sistemlerinde yüklenir. |
Nebo’nun tanımadığı ön bilgi anahtarları yok sayılır. Gövdenin boyut sınırı yoktur, ancak daha kısa talimatlar işe daha fazla yer bırakır. Uzun içeriği, çalışanın ihtiyaç duyduğunda okuyacağı dosyalara taşıyın.
Dosya ekleyin
Klasördeki SKILL.md ve nokta ile başlayan dosyalar dışındaki her dosya çalışanın kullanımına açıktır. Klasör adlarını siz seçersiniz; Nebo references/ veya assets/ klasörlerine özel bir anlam yüklemez. scripts/ veya bin/ altındaki dosyalar çalıştırılabilir.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Dosyalara klasör içindeki yollarıyla atıfta bulunun, örneğin references/policy.md. Çalışan onları, klasörün dışına çıkan her yolu reddeden read_skill_file ile okur. Betikler execute aracıyla bir korumalı alanda çalışır. Çalışma zamanları, ortam değişkenleri, gizli bilgiler ve ağ erişimi SKILL.md başvurusu sayfasında anlatılır.
Beceriler nerede bulunur
Bir bot becerileri birkaç yerden toplar. İki kaynak aynı adda bir beceri sağladığında bu listede daha sonra gelen kaynak önceliklidir.
| Kaynak | Konum | Kim kullanabilir |
|---|---|---|
| Yerleşik | Nebo’ya derlenmiş | Her çalışan |
| Pazar yeri | <data>/nebo/skills/<slug>/<version>/ | Her çalışan |
| Eklenti | Kurulu bir eklentinin skills/ klasörü | Her çalışan |
| Kullanıcı | <data>/user/skills/<name>/ | Her çalışan |
| Çalışan paketi | Kurulu bir çalışan paketinin içindeki skills/ | Yalnızca o çalışan |
| Öğrenilmiş | <data>/learned/skills/<employee>/<name>/ | Yalnızca o çalışan |
<data>, macOS’ta ~/Library/Application Support/Nebo, Windows’ta %APPDATA%\Nebo, Linux’ta ~/.local/share/nebo olur. NEBO_HOME ortam değişkeni bunu geçersiz kılar. Bir çalışanın kendi becerisi ile aynı adda ortak bir beceri olduğunda, kendi becerisi önceliklidir.
Nebo bu klasörleri izler ve değişen bir beceriyi bir saniye sonra yeniden yükler. Bir beceriyi silmeden kapatmak için dosyasının adını SKILL.md.disabled olarak değiştirin.
Beceriler araçları değil, işi anlatır. Bir beceriyi makbuzların mutabakatı gibi bir sorumluluk etrafında yazın ve çalışanın, sahibin sağladığı bağlantı hangisiyse onu kullanmasına izin verin. Bir beceri gerçekten bir eklentiye ihtiyaç duyduğunda bunu plugins alanıyla bildirin.
Sonraki adımlar
- SKILL.md başvurusu: her alan, araç ve değişken.
- Örnekler: kopyalanmaya hazır eksiksiz beceriler.
- Yayımlama: bir beceriyi pazar yerine koyun.