فائل فارمیٹ
SKILL.md UTF-8 متن ہے۔ یہ تین ہائفنز کی ایک لائن سے شروع ہوتی ہے، پھر YAML فرنٹ میٹر، پھر تین ہائفنز کی ایک بند کرنے والی لائن۔ اس کے بعد سب کچھ باڈی ہے: Markdown ہدایات جو ملازم کو مہارت لوڈ کرنے پر ملتی ہیں۔ Nebo فائل کو نام سے ڈھونڈتا ہے، چھوٹے بڑے حروف کی پروا کیے بغیر۔
---
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 ... فرنٹ میٹر فیلڈز
صرف name اور description لازمی ہیں۔ غلط قسم والی فیلڈ پوری فائل کو ناکام کر دیتی ہے، اس لیے مہارت لوڈ نہیں ہوتی۔ یہاں درج نہ ہونے والی کیز نظر انداز ہوتی ہیں۔
| فیلڈ | قسم | طے شدہ | مطلب |
|---|---|---|---|
name | string | لازمی | شناخت کنندہ۔ [a-z0-9-]، شروع، آخر یا دوہرا ہائفن نہیں، زیادہ سے زیادہ 64 بائٹس۔ فولڈر کے نام سے میل کھائے۔ |
description | string | لازمی | مہارت کیا کرتی ہے اور کب استعمال کرنی ہے۔ زیادہ سے زیادہ 1,024 بائٹس۔ ملازم کی مہارتوں کی فہرست میں دکھائی جاتی ہے اور find_skills اسے اسکور کرتا ہے۔ |
version | string | "1.0.0" | سیمینٹک ورژن۔ دوسری مہارتوں کی requires رینجز سے جانچا جاتا ہے۔ اسے کوٹس میں لکھیں۔ |
triggers | اسٹرنگز کی فہرست | [] | الفاظ اور جملے جو بتاتے ہیں کہ مہارت کب کام آتی ہے۔ زیادہ سے زیادہ تین مہارتوں کی فہرست میں نظر آتے ہیں؛ find_skills میں سب شمار ہوتے ہیں۔ یہ کبھی خود سے مہارت لوڈ نہیں کرتے۔ |
platform | اسٹرنگز کی فہرست | سب | macos، linux، windows۔ مہارت صرف وہیں لوڈ ہوتی ہے جہاں کوئی ایک میل کھائے۔ |
capabilities | اسٹرنگز کی فہرست | [] | network اور storage اسکرپٹ سینڈ باکس کو وسیع کرتے ہیں۔ Script sandbox دیکھیں۔ |
metadata | map | {} | secrets اور allowed_domains رکھتی ہے۔ نیچے دیکھیں۔ |
requires | {name, version} کی فہرست | [] | دوسری مہارتیں جن پر یہ مہارت بنی ہے۔ name مہارت کا مختصر نام ہے؛ version ایک semver رینج ہے، طے شدہ "*"۔ |
plugins | {name, version, optional} کی فہرست | [] | پلگ انز جو یہ مہارت استعمال کرتی ہے۔ version کی طے شدہ قدر "*" ہے، optional کی false۔ |
dependencies | اسٹرنگز کی فہرست | [] | ان مہارتوں کے مختصر نام جن کا موجود ہونا ضروری ہے۔ |
priority | integer | 0 | انتظامی فہرستوں میں مہارتوں کی ترتیب طے کرتی ہے۔ اس سے اس پر کوئی اثر نہیں پڑتا کہ ملازم کون سی مہارت چنتا ہے۔ |
author | string | "" | دکھانے کے لیے محفوظ ہوتی ہے۔ |
license | string | "" | دکھانے کے لیے محفوظ ہوتی ہے۔ |
compatibility | string | "" | آزاد متن والا نوٹ، زیادہ سے زیادہ 500 بائٹس۔ |
tags | اسٹرنگز کی فہرست | [] | دکھانے کے لیے محفوظ ہوتی ہے۔ |
allowed-tools | string | "" | اسپیس سے الگ کی گئی اسٹرنگ۔ محفوظ ہوتی ہے؛ نافذ نہیں ہوتی۔ |
جب requires یا dependencies میں نامزد کوئی مہارت غائب ہو یا رینج سے باہر ہو، یا کوئی لازمی پلگ ان انسٹال نہ ہو، تب بھی مہارت لوڈ ہوتی ہے اور کمزور کے نشان کے ساتھ دکھائی جاتی ہے۔ مالک دیکھ لیتا ہے کہ کیا غائب ہے۔
سیکرٹس
مہارت کے اسکرپٹس کو درکار اسناد metadata.secrets کے تحت ظاہر کریں۔ قدریں مالک فراہم کرتا ہے، اور Nebo انہیں اس مہارت کے لیے انکرپٹ کر کے محفوظ کرتا ہے۔
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | کی | مطلب |
|---|---|
key | انوائرنمنٹ ویری ایبل کا نام جو اسکرپٹ کو ملتا ہے۔ لازمی۔ |
label | مالک کو دکھایا جانے والا نام۔ |
hint | قدر کہاں سے حاصل کریں۔ |
required | جب true ہو تو جب تک قدر سیٹ نہ ہو، execute مہارت کے اسکرپٹس چلانے سے انکار کرتا ہے۔ طے شدہ false۔ |
ملازم configure_skill سے قدر سیٹ کرتا ہے۔ آپ متن میں کسی سیکرٹ کا حوالہ ${secret.KEY} کے طور پر دے سکتے ہیں، البتہ اسکرپٹس کو اس کے بجائے انوائرنمنٹ ویری ایبل پڑھنا چاہیے۔
ٹیمپلیٹ ویری ایبلز
جب کوئی ملازم مہارت لوڈ کرتا ہے تو Nebo باڈی میں یہ ویری ایبلز بدل دیتا ہے۔ دوسری فائلوں کے اندر یہ نہیں بدلے جاتے؛ اسکرپٹس اس کی بجائے انوائرنمنٹ ویری ایبلز پڑھتے ہیں۔
| ویری ایبل | قدر |
|---|---|
${NEBO_SKILL_DIR} | مہارت کے فولڈر کا مکمل پاتھ۔ |
${NEBO_DATA_DIR} | اس مہارت کے لیے ایک قابلِ تحریر فولڈر: <data>/appdata/skills/<name>۔ پہلی بار استعمال پر بنتا ہے۔ |
${NEBO_USER_NAME} | مالک کا نام۔ |
${NEBO_OS} | آپریٹنگ سسٹم۔ |
${NEBO_ARCH} | پروسیسر کا آرکیٹیکچر۔ |
${plugin.SLUG_BIN} | ظاہر کیے گئے پلگ ان کی بائنری کا پاتھ۔ slug بڑے حروف میں ہوتا ہے، ہائفنز کی جگہ انڈر اسکور کے ساتھ: example-ledger بن جاتا ہے ${plugin.EXAMPLE_LEDGER_BIN}۔ |
${secret.KEY} | ایک ظاہر کیے گئے سیکرٹ کی قدر۔ |
$ARGUMENTS | use_skill کو دیے گئے args۔ جب باڈی میں $ARGUMENTS نہ ہو تو آرگیومنٹس اس کے بعد جوڑ دیے جاتے ہیں۔ |
مہارت کے ٹولز
ملازمین ان ٹولز کے ذریعے مہارتوں کے ساتھ کام کرتے ہیں۔ use_skill ہمیشہ دستیاب ہوتا ہے؛ باقی تب لوڈ ہوتے ہیں جب کسی ملازم کو ان کی ضرورت ہو۔
| ٹول | پیرامیٹرز | یہ کیا کرتا ہے |
|---|---|---|
use_skill | name, args | ایک مہارت لوڈ کرتا ہے۔ پھیلائی گئی باڈی، فولڈر کا پاتھ اور پہلی 20 فائلوں کے نام لوٹاتا ہے۔ بند کی گئی مہارت کو دوبارہ فعال کرتا ہے۔ |
find_skills | query | نام، ٹرگر اور تفصیل کے میل کے لحاظ سے درجہ بند زیادہ سے زیادہ 10 مہارتیں لوٹاتا ہے۔ |
read_skill_file | name, path | مہارت کے فولڈر میں ایک فائل پڑھتا ہے۔ path کے بغیر فائلیں اور ان کے سائز درج کرتا ہے۔ |
save_skill | name, content | یوزر اسکلز فولڈر میں ایک مکمل SKILL.md لکھتا ہے۔ مارکیٹ پلیس کی مہارتوں کو اوور رائٹ نہیں کیا جا سکتا۔ |
delete_skill | name | صارف کی ایک مہارت حذف کرتا ہے۔ |
install_skill | code | مارکیٹ پلیس کی کسی مہارت کو اس کے SKIL- انسٹال کوڈ سے انسٹال کرتا ہے۔ |
configure_skill | name, key, value | ایک سیکرٹ سیٹ کرتا ہے۔ key کے بغیر دکھاتا ہے کہ مہارت کو کیا درکار ہے۔ |
rate_skill | name, rating, review | مارکیٹ پلیس کی کسی مہارت کو 1 سے 5 تک ریٹ کرتا ہے۔ |
read_skill_reviews | name | مارکیٹ پلیس کی کسی مہارت کے جائزے پڑھتا ہے۔ |
execute | skill, script, args, timeout | مہارت کے فولڈر سے ایک اسکرپٹ چلاتا ہے۔ Script sandbox دیکھیں۔ |
اسکرپٹ سینڈ باکس
execute ٹول مہارت کے فولڈر سے ایک اسکرپٹ چلاتا ہے۔ یہ فائل کی بنیاد پر رن ٹائم کا انتخاب کرتا ہے۔
| اسکرپٹ | رن ٹائم |
|---|---|
.py | Python، Nebo کے ساتھ آنے والے uv کے ذریعے اگر موجود ہو، ورنہ python3۔ |
.ts, .js | Nebo کا ساتھ آنے والا Bun اگر موجود ہو، ورنہ node۔ |
bin/<file> یا binary | براہِ راست چلتی ہے۔ |
.sh | سپورٹ نہیں۔ |
ہر رن خالی انوائرنمنٹ اور ان ویری ایبلز کے ساتھ شروع ہوتا ہے:
| ویری ایبل | قدر |
|---|---|
SKILL_ARGS | args آبجیکٹ، JSON کی صورت میں۔ |
ہر سیکرٹ کی key | ڈی کرپٹ کی گئی سیکرٹ کی قدر۔ |
<PLUGIN>_BIN | ہر ظاہر کیے گئے پلگ ان کی بائنری کا پاتھ۔ پلگ ان فولڈرز PATH میں بھی شامل کیے جاتے ہیں۔ |
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", []))})) اسکرپٹ مہارت کے فولڈر کی ایک عارضی کاپی میں چلتا ہے، جس کا طے شدہ ٹائم آؤٹ 30 سیکنڈ ہے۔ macOS اور Linux پر یہ آپریٹنگ سسٹم کے سینڈ باکس میں چلتا ہے:
- یہ اسناد کے اسٹورز، براؤزر اور کی چین کا ڈیٹا، یا Nebo کی اپنی ترتیبات اور ڈیٹا بیس نہیں پڑھ سکتا۔
- یہ صرف اپنے ورکنگ فولڈر اور
/tmp/neboمیں لکھ سکتا ہے۔storageصلاحیت Nebo کا ڈیٹا فولڈر شامل کرتی ہے۔ - اسے کوئی نیٹ ورک رسائی نہیں۔
networkصلاحیت پیکیج رجسٹریز اورmetadata.allowed_domainsمیں درج ڈومینز کی اجازت دیتی ہے۔
فائلیں اور حدود
| آئٹم | اصول |
|---|---|
| وسائل | SKILL.md، manifest.json، signatures.json اور ڈاٹ فائلز کے علاوہ ہر فائل۔ |
| ایگزیکیوٹیبلز | scripts/ یا bin/ کے تحت فائلیں، اور روٹ میں binary نام کی فائل۔ |
| پاتھس | مہارت کے فولڈر کے لحاظ سے۔ .. والے یا فولڈر سے باہر جانے والے پاتھ مسترد کیے جاتے ہیں۔ |
| بند مہارت | ایسا فولڈر جس میں SKILL.md کی بجائے SKILL.md.disabled ہو۔ |
| مہارتوں کی فہرست | ہر اندراج 250 حروف پر کاٹ دیا جاتا ہے۔ جب پوری فہرست 8,000 حروف سے بڑھ جائے تو پہلے مشترکہ مہارتیں مختصر کی جاتی ہیں؛ ملازم کی اپنی مہارتوں کے اندراجات پورے رہتے ہیں۔ |
مارکیٹ پلیس پر شائع کی جانے والی فائلوں کی حدود اشاعت کے صفحے پر ہیں۔