দক্ষতা কী
দক্ষতা হলো এমন একটি ফোল্ডার যার নাম দক্ষতার 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 আবশ্যক | কেবল ছোট হাতের অক্ষর, অঙ্ক ও হাইফেন; শুরুতে বা শেষে হাইফেন নয়; পরপর দুটি হাইফেন নয়; সর্বোচ্চ 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 ফিল্ড দিয়ে তা ঘোষণা করুন।
এরপর
- SKILL.md রেফারেন্স: প্রতিটি ফিল্ড, টুল ও ভেরিয়েবল।
- উদাহরণ: কপি করার মতো সম্পূর্ণ দক্ষতা।
- প্রকাশ করা: মার্কেটপ্লেসে একটি দক্ষতা রাখুন।