Dosya biçimi
SKILL.md UTF-8 metindir. Üç kısa çizgiden oluşan bir satırla başlar, ardından YAML ön bilgisi ve yine üç kısa çizgiden oluşan kapanış satırı gelir. Bundan sonraki her şey gövdedir: çalışanın beceriyi yüklediğinde aldığı Markdown talimatları. Nebo dosyayı büyük/küçük harf ayrımı yapmadan adıyla bulur.
---
name: expense-review
description: Check submitted expenses against the company policy and flag anything that needs a receipt or an approval. Use when someone asks to review expenses or a reimbursement request.
version: "1.2.0"
author: Example Co
license: MIT
tags: [finance, expenses]
triggers: [reimbursement, expense report]
platform: [macos, linux, windows]
capabilities: [network]
metadata:
allowed_domains: [api.example.com]
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true
requires:
- name: receipt-capture
version: ">=1.0.0"
plugins:
- name: example-ledger
version: ">=2.0.0"
optional: true
---
# Expense review
Follow the policy in references/policy.md ... Ön bilgi alanları
Yalnızca name ve description zorunludur. Türü yanlış olan bir alan tüm dosyayı geçersiz kılar ve beceri yüklenmez. Burada listelenmeyen anahtarlar yok sayılır.
| Alan | Tür | Varsayılan | Anlamı |
|---|---|---|---|
name | string | zorunlu | Tanımlayıcı. [a-z0-9-]; başta, sonda veya art arda iki kısa çizgi olamaz; en fazla 64 bayt. Klasör adıyla eşleştirin. |
description | string | zorunlu | Becerinin ne yaptığı ve ne zaman kullanılacağı. En fazla 1.024 bayt. Çalışanın beceri listesinde gösterilir ve find_skills tarafından puanlanır. |
version | string | "1.0.0" | Anlamsal sürüm. Diğer becerilerin requires aralıklarıyla denetlenir. Tırnak içine alın. |
triggers | dize listesi | [] | Becerinin ne zaman uygulanacağını anlatan sözcükler ve ifadeler. Beceri listesinde en fazla üçü görünür; find_skills içinde hepsi sayılır. Bir beceriyi asla kendi başlarına yüklemezler. |
platform | dize listesi | tümü | macos, linux, windows. Beceri yalnızca birinin eşleştiği yerde yüklenir. |
capabilities | dize listesi | [] | network ve storage betik korumalı alanını genişletir. Bkz. Betik korumalı alanı. |
metadata | map | {} | secrets ve allowed_domains değerlerini tutar. Aşağıya bakın. |
requires | {name, version} listesi | [] | Bu becerinin üzerine kurulduğu diğer beceriler. name kısa beceri adıdır; version bir semver aralığıdır, varsayılanı "*". |
plugins | {name, version, optional} listesi | [] | Bu becerinin kullandığı eklentiler. version varsayılan olarak "*", optional ise false olur. |
dependencies | dize listesi | [] | Bulunması gereken becerilerin kısa adları. |
priority | integer | 0 | Yönetim listelerinde becerileri sıralar. Bir çalışanın hangi beceriyi seçtiğini etkilemez. |
author | string | "" | Görüntüleme için saklanır. |
license | string | "" | Görüntüleme için saklanır. |
compatibility | string | "" | Serbest metin notu, en fazla 500 bayt. |
tags | dize listesi | [] | Görüntüleme için saklanır. |
allowed-tools | string | "" | Boşlukla ayrılmış bir dize. Saklanır; zorunlu kılınmaz. |
requires veya dependencies içinde adı geçen bir beceri eksik ya da aralığın dışındaysa veya gerekli bir eklenti kurulu değilse, beceri yine yüklenir ve kısıtlı olarak işaretlenir. Sahip neyin eksik olduğunu görür.
Gizli bilgiler
Bir becerinin betiklerinin ihtiyaç duyduğu kimlik bilgilerini metadata.secrets altında bildirin. Değerleri sahip sağlar ve Nebo onları o beceri için şifreli olarak saklar.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Anahtar | Anlamı |
|---|---|
key | Betiğin aldığı ortam değişkeninin adı. Zorunlu. |
label | Sahibe gösterilen ad. |
hint | Değerin nereden alınacağı. |
required | true olduğunda execute, değer ayarlanana kadar becerinin betiklerini çalıştırmayı reddeder. Varsayılan false. |
Bir çalışan configure_skill ile bir değer ayarlar. Gövdede bir gizli bilgiye ${secret.KEY} olarak başvurabilirsiniz, ancak betikler bunun yerine ortam değişkenini okumalıdır.
Şablon değişkenleri
Nebo, bir çalışan beceriyi yüklediğinde gövdedeki bu değişkenleri değiştirir. Diğer dosyaların içinde değiştirilmezler; betikler bunun yerine ortam değişkenlerini okur.
| Değişken | Değer |
|---|---|
${NEBO_SKILL_DIR} | Becerinin klasörünün mutlak yolu. |
${NEBO_DATA_DIR} | Bu beceri için yazılabilir bir klasör: <data>/appdata/skills/<name>. İlk kullanımda oluşturulur. |
${NEBO_USER_NAME} | Sahibin adı. |
${NEBO_OS} | İşletim sistemi. |
${NEBO_ARCH} | İşlemci mimarisi. |
${plugin.SLUG_BIN} | Bildirilmiş bir eklentinin ikili dosya yolu. Slug büyük harfe çevrilir ve kısa çizgiler alt çizgi olur: example-ledger, ${plugin.EXAMPLE_LEDGER_BIN} olur. |
${secret.KEY} | Bildirilmiş bir gizli bilginin değeri. |
$ARGUMENTS | use_skill’e geçirilen args. Gövdede $ARGUMENTS yoksa argümanlar gövdenin sonuna eklenir. |
Beceri araçları
Çalışanlar becerilerle bu araçlar üzerinden çalışır. use_skill her zaman kullanılabilir; diğerleri bir çalışan onlara ihtiyaç duyduğunda yüklenir.
| Araç | Parametreler | Ne yapar |
|---|---|---|
use_skill | name, args | Bir beceriyi yükler. Genişletilmiş gövdeyi, klasör yolunu ve ilk 20 dosya adını döndürür. Devre dışı bırakılmış bir beceriyi yeniden etkinleştirir. |
find_skills | query | Ad, tetikleyici ve açıklama eşleşmelerine göre sıralanmış en fazla 10 beceri döndürür. |
read_skill_file | name, path | Becerinin klasöründeki bir dosyayı okur. path olmadan dosyaları ve boyutlarını listeler. |
save_skill | name, content | Eksiksiz bir SKILL.md dosyasını kullanıcı becerileri klasörüne yazar. Pazar yeri becerilerinin üzerine yazılamaz. |
delete_skill | name | Bir kullanıcı becerisini siler. |
install_skill | code | Bir pazar yeri becerisini SKIL- kurulum koduyla kurar. |
configure_skill | name, key, value | Bir gizli bilgi ayarlar. key olmadan, becerinin neye ihtiyaç duyduğunu gösterir. |
rate_skill | name, rating, review | Bir pazar yeri becerisini 1 ile 5 arasında puanlar. |
read_skill_reviews | name | Bir pazar yeri becerisinin değerlendirmelerini okur. |
execute | skill, script, args, timeout | Bir becerinin klasöründen bir betik çalıştırır. Bkz. Betik korumalı alanı. |
Betik korumalı alanı
execute aracı, bir becerinin klasöründen tek bir betik çalıştırır. Çalışma zamanını dosyaya göre seçer.
| Betik | Çalışma zamanı |
|---|---|
.py | Python; varsa Nebo’nun paketlenmiş uv’si üzerinden, yoksa python3. |
.ts, .js | Varsa Nebo’nun paketlenmiş Bun’ı, yoksa node. |
bin/<file> veya binary | Doğrudan çalıştırılır. |
.sh | Desteklenmez. |
Her çalıştırma boş bir ortamla ve şu değişkenlerle başlar:
| Değişken | Değer |
|---|---|
SKILL_ARGS | JSON olarak args nesnesi. |
Her gizli bilginin key değeri | Şifresi çözülmüş gizli bilgi değeri. |
<PLUGIN>_BIN | Bildirilmiş her eklentinin ikili dosya yolu. Eklenti klasörleri ayrıca PATH’e eklenir. |
import json, os
args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
api_key = os.environ["EXAMPLE_API_KEY"]
print(json.dumps({"checked": len(args.get("items", []))})) Betik, beceri klasörünün geçici bir kopyasında, varsayılan 30 saniyelik zaman aşımıyla çalışır. macOS ve Linux’ta bir işletim sistemi korumalı alanında çalışır:
- Kimlik bilgisi depolarını, tarayıcı ve anahtar zinciri verilerini veya Nebo’nun kendi ayarlarını ve veritabanını okuyamaz.
- Yalnızca çalışma klasörüne ve
/tmp/nebokonumuna yazabilir.storageyeteneği Nebo’nun veri klasörünü ekler. - Ağ erişimi yoktur.
networkyeteneği, paket kayıtlarına vemetadata.allowed_domainsiçinde listelenen alan adlarına izin verir.
Dosyalar ve sınırlar
| Öğe | Kural |
|---|---|
| Kaynaklar | SKILL.md, manifest.json, signatures.json ve nokta ile başlayan dosyalar dışındaki her dosya. |
| Çalıştırılabilir dosyalar | scripts/ veya bin/ altındaki dosyalar ve kök dizindeki binary adlı dosya. |
| Yollar | Beceri klasörüne göre görelidir. .. içeren veya klasörün dışına çıkan yollar reddedilir. |
| Devre dışı beceri | SKILL.md yerine SKILL.md.disabled içeren bir klasör. |
| Beceri listesi | Her girdi 250 karakterde kesilir. Listenin tamamı 8.000 karakteri aştığında önce ortak beceriler kısaltılır; bir çalışanın kendi becerileri tam girdilerini korur. |
Pazar yerinde yayımladığınız dosyaların sınırları Yayımlama sayfasındadır.