NeboAI
NeboAI
شروع کریں

مہارتیں

مہارت کسی ملازم کو ایک قسم کا کام اچھی طرح کرنا سکھاتی ہے۔ آپ اسے ایک فولڈر کے طور پر لکھتے ہیں جس میں SKILL.md فائل ہو: ایک مختصر تفصیل جس سے ملازم مہارت کا انتخاب کرتا ہے، اور ہدایات جن پر وہ مہارت لوڈ ہونے کے بعد عمل کرتا ہے۔ مہارتوں کو کسی کوڈ کی ضرورت نہیں، اور بوٹ کا ہر ملازم انہیں استعمال کر سکتا ہے۔

مہارت کیا ہے

مہارت ایک فولڈر ہے جس کا نام مہارت کے name سے ملتا ہے۔ فولڈر میں ایک SKILL.md فائل ہوتی ہے اور، اختیاری طور پر، کوئی بھی دوسری فائلیں جن کا ہدایات میں حوالہ ہو: حوالہ جاتی دستاویزات، ٹیمپلیٹس یا اسکرپٹس۔

SKILL.md کے دو حصے ہیں۔ --- لائنوں کے درمیان YAML فرنٹ میٹر میں نام اور تفصیل ہوتی ہے۔ اس کے بعد Markdown باڈی میں ہدایات ہوتی ہیں۔

ملازمین مہارتیں کیسے استعمال کرتے ہیں

ملازم تین مراحل میں مہارت کے ساتھ کام کرتا ہے۔

  1. انتخاب۔ ہر باری میں ملازم اپنے لیے دستیاب مہارتوں کی فہرست دیکھتا ہے: ہر مہارت کا نام، اس کی تفصیل، اور اس کے زیادہ سے زیادہ تین ٹرگرز۔ فیصلہ کرنے کے لیے ملازم تفصیل ہی پڑھتا ہے، اس لیے اس میں لکھیں کہ مہارت کیا کرتی ہے اور کب استعمال کرنی ہے۔
  2. لوڈ۔ ملازم مہارت کے نام کے ساتھ use_skill ٹول کال کرتا ہے۔ ٹول ہدایات، مہارت کے فولڈر کا پاتھ اور اس کی فائلوں کے نام لوٹاتا ہے۔ ملازم کے مہارت پڑھنے کا یہی ایک طریقہ ہے۔
  3. کام۔ ملازم ہدایات پر عمل کرتا ہے۔ وہ معاون فائلیں 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> سے مراد macOS پر ~/Library/Application Support/Nebo، Windows پر %APPDATA%\Nebo اور Linux پر ~/.local/share/nebo ہے۔ NEBO_HOME انوائرنمنٹ ویری ایبل اس پر فوقیت رکھتا ہے۔ جب کسی ملازم کے پاس اپنی مہارت ہو اور اسی نام کی ایک مشترکہ مہارت بھی، تو اس کی اپنی مہارت کو فوقیت ہوتی ہے۔

Nebo ان فولڈرز پر نظر رکھتا ہے اور بدلی ہوئی مہارت کو ایک سیکنڈ بعد دوبارہ لوڈ کرتا ہے۔ کسی مہارت کو حذف کیے بغیر بند کرنے کے لیے اس کی فائل کا نام بدل کر SKILL.md.disabled کر دیں۔

مہارتیں کام بیان کرتی ہیں، ٹولز نہیں۔ مہارت کسی ذمہ داری کے گرد لکھیں، جیسے رسیدوں کا ملان، اور ملازم کو وہ کنکشن استعمال کرنے دیں جو مالک نے فراہم کیا ہو۔ جب کسی مہارت کو واقعی کسی پلگ ان کی ضرورت ہو تو اسے plugins فیلڈ سے ظاہر کریں۔

آگے