المهارات

المهارة مجموعة مسماة من تعليمات Markdown لا يحمّلها النموذج إلا عند الحاجة. لكل مهارة slug ‏($docs-style) واسم عرض ووصف قصير وتعليمات كاملة.

التحميل عند الحاجة

الوصف هو manifest: عندما تكون الأدوات مفعّلة في جولة، تسرد أداة load_skill المضمّنة slug واسم ووصف كل مهارة مفعلة، ويجلب النموذج التعليمات الكاملة باستدعاء واحد. ولذلك لا تشغل التعليمات الطويلة السياق قبل استخدامها. ويشجّع ذكر $slug في رسالة النموذج على تحميل تلك المهارة.

دورة الحياة

يمكن تعطيل المهارات من دون حذفها؛ فتغادر المهارة المعطلة manifest وترفض التحميل. ترفع التحديثات رقم الإصدار وتؤرشف المراجعة السابقة، وتستعيد عملية الرجوع أي مراجعة كإصدار جديد. صيغة التبادل مستند SKILL.md: frontmatter يحمل الاسم وslug والوصف، تليه تعليمات Markdown حرفيًا؛ وهو ما ينزله التصدير ويقبله الاستيراد إلى جانب غلاف JSON. تُشفّر الأسماء والأوصاف والتعليمات أثناء التخزين، بينما يبقى slug صريحًا.

الاستيراد من متجر

يمكن جلب المهارات مباشرةً من مصدر بعيد ضمن الإعدادات ← المهارات ← من URL. الصيغ المقبولة: رابط إدراج skills.sh، أو مستودع GitHub أو عنوان شجرة أو blob، أو اختصار owner/repo/skill (يُحل وفق البنية المعتادة skills/<name>/SKILL.md)، أو رابط مباشر إلى أي ملف SKILL.md. يمر الجلب عبر حارس الخروج المثبّت نفسه المستخدم لخوادم الأدوات — عناوين عامة فقط وحجم محدود — ويصل المستند كمهارة تخصك ويمكنك تحريرها، فلا يحدّث المصدر البعيد نفسه بصمت.

الملفات المضمّنة

يمكن للمهارة حمل ملفات مرافقة في بنية مجلد SKILL.md، مثل مستندات مرجعية وقوالب ومصادر نصوص برمجية تشير إليها التعليمات. يسرد load_skill الحزمة في نهاية التعليمات، ويقرأ النموذج ملفًا عند الحاجة عبر أداة read_skill_file، فلا يشغل مرجع كبير السياق قبل الاحتياج الفعلي إليه.

ترافق الملفات المهارة أينما ذهبت: يرفع الإعدادات ← المهارات ← من مجلد مجلد SKILL.md محليًا في خطوة واحدة، ويجلب الاستيراد البعيد الملفات النصية المجاورة لملف SKILL.md، ويحمل تصدير JSON الحزمة، وتدير نافذة التحرير الملفات واحدًا تلو الآخر. المسارات نسبية ولا يمكنها مغادرة المهارة؛ والمحتوى نصي فقط، ومشفّر أثناء التخزين، ومحدود (32 ملفًا، 200 KB لكل ملف، 1 MB لكل مهارة).

المهارات المعلّمة

أُنشئت المهارات التي يبدأ slug الخاص بها بـ taught- عبر عرض مهمة على شاشة حاسوب Work: يُحوّل التسجيل حتميًا إلى دليل عمل بلغة طبيعية، مع أهداف نقر مثبتة وأسرار منقحة ونطاق مسموح مشتق من المواقع التي زارتها العرض، ثم يُحفظ كمهارة عادية فتحصل على الإصدارات والتحرير والمشاركة كغيرها. تحمّل عمليات Work القادرة على الحاسوب مهارات المالك المعلّمة والمفعلة تلقائيًا. بعد انتهاء العملية، تضيف مراجعة نجاح أو فشل بنقرة واحدة على شرائح المهارة سطرًا مؤرخًا إلى قسم سجل الأداء؛ وكل مراجعة إصدار مهارة عادي، لذلك يمكن تحرير السجل واستعادته هنا كأي تغيير آخر.

الموافقات المطلوبة

يمكن للمهارة أن تحمل طلب موافقة إلى جانب تعليماتها. في محرر المهارة، يفعّله اسأل دائمًا قبل وتختار قائمة تحقق الأدوات التي يشملها: run_command وcomputer_act وdelete_file وmove_file وmessage_agent وwrite_file. وترك كل المربعات فارغة يشمل الستة جميعًا.

وطوال تحميل المهارة — سواء كانت مرتبطة بالملف الشخصي أو الشخصية لتلك الجولة، أو مُحمَّلة في منتصف الجولة عبر load_skill — تتوقف تلك الأدوات لانتظار المستخدم قبل تشغيلها، بصرف النظر عمّا يقوله إعداد الموافقة الخاص بالتشغيل نفسه، ويسمي الطلب المهارةَ التي تسأل. ولا تستطيع قاعدة "السماح دائمًا" المحفوظة الموافقة عليها أبدًا: فالنثر في التعليمات نصيحة قد يتجاوزها النموذج بإعادة الصياغة، بينما هذا مفروض عند البوابة نفسها. وتظل "السماح مرة" الآنية تعمل، لأنها قرار حيّ لا قاعدة محفوظة. انظر اعتماد الإجراءات.

ينتقل الحقل مع المهارة: فهو يمر ذهابًا وإيابًا عبر التصدير والاستيراد في مغلّف JSON. أما صيغة التبادل SKILL.md فتحمل التعليمات فقط، فيستقر الاستيراد من ملف markdown وحده على الافتراضي (الوراثة) ويجب ضبط الطلب من جديد.

تُحفظ المهارة المعلَّمة التي نقّح عرضها سرًا مع تفعيل هذا لأجل computer_act: إذ يعيد تشغيلها المرور عبر أرض يجب أن يراها المستخدم، ولم تكن حدود النثر وحدها كافية أبدًا.

المشاركة والملفات الشخصية

المهارات خاصة افتراضيًا ويمكن مشاركتها عبر نموذج منح الموارد المشترك. يستطيع ملف مساعد ربط مجموعة فرعية من المهارات، ولا ترى الجلسات التي تستخدمه إلا تلك المهارات في manifest.

مثال

أنشئ مهارة من الإعدادات ← المهارات (أو اختر أحد قوالب البداية هناك وعدّله):

• Slug: cite-sources

• Name: Cite sources

• Description: How to cite evidence: numbered references with URLs, no unreferenced claims. (هذا السطر هو ما يراه النموذج في manifest؛ اجعله يوضح متى تُستخدم المهارة)

• Instructions:

  # Citing sources
  
  - Every factual claim gets a numbered reference like [1].
  - End with a References section: number, title, URL.
  - If no source exists, say so instead of inventing one.

فعّل الأدوات في المحرر واطلب:

لخّص أحدث النتائج واستخدم $cite-sources.

تؤدي كتابة $ إلى الإكمال التلقائي لـ slug مهاراتك. يرى النموذج cite-sources في manifest ويستدعي load_skill لجلب التعليمات أعلاه وينسق الإجابة وفقًا لها. عطّل المهارة من بطاقتها فتختفي من manifest من دون حذفها.