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> هو ~/Library/Application Support/Nebo على macOS، و%APPDATA%\Nebo على Windows، و~/.local/share/nebo على Linux. ويتجاوزه متغير البيئة NEBO_HOME. وعندما تكون لدى الموظف مهارة خاصة به ومهارة مشتركة بالاسم نفسه، تكون الأولوية لمهارته الخاصة.

يراقب Nebo هذه المجلدات ويعيد تحميل المهارة المتغيّرة بعد ثانية واحدة. لتعطيل مهارة دون حذفها، أعد تسمية ملفها إلى SKILL.md.disabled.

المهارات تصف العمل، لا الأدوات. اكتب المهارة حول مسؤولية، مثل مطابقة الإيصالات، ودع الموظف يستخدم أي اتصال وفّره المالك. وعندما تحتاج المهارة فعلًا إلى إضافة، صرّح بها في الحقل plugins.

التالي