مهارت چیست
یک مهارت پوشهای است که نامش با name مهارت یکی است. این پوشه یک فایل SKILL.md و در صورت تمایل هر فایل دیگری را که دستورالعملها به آن اشاره میکنند در خود دارد: اسناد مرجع، الگوها یا اسکریپتها.
SKILL.md دو بخش دارد. پیشمتن YAML میان خطوط --- نام و توضیح را در خود دارد. بدنه Markdown پس از آن دستورالعملها را در خود دارد.
کارمندان چگونه از مهارتها استفاده میکنند
کارمند در سه گام با یک مهارت کار میکند.
- انتخاب. در هر نوبت، کارمند فهرستی از مهارتهای در دسترسش را میبیند: نام هر مهارت، توضیح آن و حداکثر سه تریگر آن. توضیح همان چیزی است که کارمند برای تصمیمگیری میخواند، پس آن را طوری بنویسید که بگوید مهارت چه میکند و کی باید از آن استفاده کرد.
- بارگذاری. کارمند ابزار
use_skillرا با نام مهارت فراخوانی میکند. این ابزار دستورالعملها، مسیر پوشه مهارت و نام فایلهایش را برمیگرداند. این تنها راهی است که کارمند یک مهارت را میخواند. - کار. کارمند دستورالعملها را دنبال میکند. فایلهای پشتیبان را با
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 الزامی است | فقط حروف کوچک، ارقام و خط تیره؛ بدون خط تیره در ابتدا یا انتها؛ بدون خط تیره دوتایی؛ حداکثر ۶۴ بایت. |
description الزامی است | حداکثر ۱٬۰۲۴ بایت. |
| فیلدها نوع درست دارند | فیلدی با نوع 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 اعلام کنید.
بعدی
- مرجع SKILL.md: همه فیلدها، ابزارها و متغیرها.
- نمونهها: مهارتهای کامل برای کپی کردن.
- انتشار: یک مهارت را در فروشگاه قرار دهید.