NeboAI
NeboAI
Başlayın

SKILL.md referansı

Bu sayfa, bir becerinin Nebo’nun okuduğu her parçasını listeler: ön bilgi alanları, genişlettiği değişkenler, çalışanların becerilerle çalışmak için kullandığı araçlar ve betiklerin çalıştığı ortam.

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.

AlanTürVarsayılanAnlamı
namestringzorunluTanı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.
descriptionstringzorunluBecerinin 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.
versionstring"1.0.0"Anlamsal sürüm. Diğer becerilerin requires aralıklarıyla denetlenir. Tırnak içine alın.
triggersdize 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.
platformdize listesitümümacos, linux, windows. Beceri yalnızca birinin eşleştiği yerde yüklenir.
capabilitiesdize listesi[]network ve storage betik korumalı alanını genişletir. Bkz. Betik korumalı alanı.
metadatamap{}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.
dependenciesdize listesi[]Bulunması gereken becerilerin kısa adları.
priorityinteger0Yönetim listelerinde becerileri sıralar. Bir çalışanın hangi beceriyi seçtiğini etkilemez.
authorstring""Görüntüleme için saklanır.
licensestring""Görüntüleme için saklanır.
compatibilitystring""Serbest metin notu, en fazla 500 bayt.
tagsdize listesi[]Görüntüleme için saklanır.
allowed-toolsstring""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
AnahtarAnlamı
keyBetiğin aldığı ortam değişkeninin adı. Zorunlu.
labelSahibe gösterilen ad.
hintDeğerin nereden alınacağı.
requiredtrue 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şkenDeğ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.
$ARGUMENTSuse_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çParametrelerNe yapar
use_skillname, argsBir 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_skillsqueryAd, tetikleyici ve açıklama eşleşmelerine göre sıralanmış en fazla 10 beceri döndürür.
read_skill_filename, pathBecerinin klasöründeki bir dosyayı okur. path olmadan dosyaları ve boyutlarını listeler.
save_skillname, contentEksiksiz bir SKILL.md dosyasını kullanıcı becerileri klasörüne yazar. Pazar yeri becerilerinin üzerine yazılamaz.
delete_skillnameBir kullanıcı becerisini siler.
install_skillcodeBir pazar yeri becerisini SKIL- kurulum koduyla kurar.
configure_skillname, key, valueBir gizli bilgi ayarlar. key olmadan, becerinin neye ihtiyaç duyduğunu gösterir.
rate_skillname, rating, reviewBir pazar yeri becerisini 1 ile 5 arasında puanlar.
read_skill_reviewsnameBir pazar yeri becerisinin değerlendirmelerini okur.
executeskill, script, args, timeoutBir 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ı
.pyPython; varsa Nebo’nun paketlenmiş uv’si üzerinden, yoksa python3.
.ts, .jsVarsa Nebo’nun paketlenmiş Bun’ı, yoksa node.
bin/<file> veya binaryDoğrudan çalıştırılır.
.shDesteklenmez.

Her çalıştırma boş bir ortamla ve şu değişkenlerle başlar:

DeğişkenDeğer
SKILL_ARGSJSON olarak args nesnesi.
Her gizli bilginin key değeriŞifresi çözülmüş gizli bilgi değeri.
<PLUGIN>_BINBildirilmiş 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/nebo konumuna yazabilir. storage yeteneği Nebo’nun veri klasörünü ekler.
  • Ağ erişimi yoktur. network yeteneği, paket kayıtlarına ve metadata.allowed_domains içinde listelenen alan adlarına izin verir.

Dosyalar ve sınırlar

ÖğeKural
KaynaklarSKILL.md, manifest.json, signatures.json ve nokta ile başlayan dosyalar dışındaki her dosya.
Çalıştırılabilir dosyalarscripts/ veya bin/ altındaki dosyalar ve kök dizindeki binary adlı dosya.
YollarBeceri klasörüne göre görelidir. .. içeren veya klasörün dışına çıkan yollar reddedilir.
Devre dışı beceriSKILL.md yerine SKILL.md.disabled içeren bir klasör.
Beceri listesiHer 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.