كيفاش تثبّت وتستعمل مهارات Jev لاتخاذ القرارات ديال الوكلاء

شنو كيدير Jev Skills

Awesome Jev Skills هي مجموعة ديال تسعة مهارات قابلين للتثبيت، كيزيدو قرارات منظّمة لسير العمل ديال وكلاء الذكاء الاصطناعي. Jev كيختار بين المرشحين، كيصنّف المدخلات، وكيعطي نقاط للمعايير المحددة. الوكيل ديالك كيبقى مسؤول على جمع السياق، واستعمال الأدوات، وإنجاز الخدمة، والتأكد من النتائج.

المستودع فيه 90 سيناريو و14 مثال مسجّل ديال المدخلات والمخرجات. الوصفات ديالو كتشمل الوكلاء اللي خدامين لفترات طويلة، والتقييم، والتوجيه، وتدبير السياق، والتفاعل مع المتصفح، وفرز البريد الوارد، وأدلة الوثائق، وأدوات المطورين، والمحاكاة، والألعاب، وسير العمل الإبداعي.

Jev كيختار أو كيعطي النقاط. ما كيكليكاش على الأزرار، وما كيرسلش الرسائل، وما كيبدلش الملفات، وما كيرندريش الوسائط، وما كينفذش الإجراء المختار.

المزايا الرئيسية

• أنواع قرارات منظّمة: استعمل choice باش تختار مرشح واحد، وnoul لحكم مستقل بنعم أو لا، وscore لمستويات متدرجة.
• مهارات متخصصة: ثبّت مهارات للفرز، والوثائق، وواجهات المستخدم، والتوجيه، والسياق، ومراجعة الكود، واكتشاف الكود، والمحاكاة.
• نقط مراقبة للوكيل: طلب من Jev يكتاشف الإخفاقات المتكررة، ويقيّم أدلة اكتمال المهمة، ويختار مسارا، أو يحدد واش إجراء مقترح كيقرب من الهدف.
• أحكام متوازية: حط عدة أسئلة مستقلة على نفس الحالة فطلب واحد، أو خلّي الوكيل المضيف يجدول الطلبات المستقلة بتزامن محدود.
• تحقق بلا اتصال: استعمل --dry-run للتحقق من المدخل بلا اتصال بالشبكة وبلا إنتاج تصنيف.
• وضع المحاكاة الصريح: إلا ما كانش مفتاح OpenRouter متوفر، الوكيل الحالي ديالك يقدر يحاكي نفس الحكم غير من بعد ما توافق على هاد الوضع.

اختيار مهارة

• jev: عرّف قرار مخصص أو زِد نقطة مراقبة عامة للوكيل.
• jev-triage: صنّف ورتّب الرسائل، والتذاكر، أو الملاحظات حسب الأولوية.
• jev-documents: اختار المقاطع المصدر وقيّم الأدلة الداعمة.
• jev-ui: اختار بين إجراءات المتصفح أو سطح المكتب اللي سبق رصدها.
• jev-route: اقترح أداة، أو نموذجا، أو متخصصا.
• jev-context: قيّم الصلة وحدد إمتى يقدر يكون ضغط السياق مناسبا.
• jev-code-review: رتّب تغييرات الكود حسب الأولوية للمراجعة.
• jev-find-code: اختار الموقع الموالي من لائحة الملفات المرصودة.
• jev-simulation: اختار الإجراءات القانونية فالعالم المحاكى.

التثبيت

التثبيت الموصى به بمساعدة الوكيل

الطريقة الموصى بها هي تعطي مهمة التثبيت لـ Codex أو Claude Code أو OpenCode. لسّق البرومبت التالي فالوكيل ديالك:

ثبّت Jev Skills للوكيل الحالي ديالي، بما فيه المهارة العامة وجميع مهارات السيناريوهات. قرا واتبع دليل التثبيت هادا، ومن بعد تحقق من التثبيت:
https://raw.githubusercontent.com/wuyoscar/jev-skill/main/docs/install.md

الوكيل كيتحقق من البيئة ديالك، وكيثبّت افتراضيا فالمشروع الحالي، وكيتحقق من التثبيت بلا اتصال. مسار التثبيت الافتراضي ما كيحتاجش Node ولا npm ولا حساب Vercel. تعامل مع أي طلبات موافقة كيطرحها الوكيل ديالك.

للتثبيت اليدوي أو حل المشاكل، راجع دليل التثبيت اليدوي.

إعداد الولوج الحقيقي لـ Jev

استعمال Jev بشكل حقيقي كيحتاج OPENROUTER_API_KEY. أنشئ واحد من خلال إعدادات OpenRouter وضبطو محليا. ما تلصقش المفتاح فالمحادثة نهائيا. الاستعمال المباشر كيدوز عبر الواجهة البرمجية وقد يترتب عليه احتساب رسوم الاستعمال.

إلا ما تلقاش المفتاح، خاص الوكيل ينبهك ويستنى واحد من هاد الاختيارات:

1. الخيار A: جيب مفتاح وضبطو محليا، ومن بعد استعمل Jev الحقيقي.
2. الخيار B: خلّي الوكيل الحالي يحاكي التصنيف بنفس السياق، والمرشحين، والمعايير.

خاص نتائج المحاكاة تكون معلمة بـ mode: agent_simulation وjev_called: false. هادي ماشي ردود Jev ولا احتمالات Jev معايرة، وبهذا ما خاصش الوكيل يخترع قيم الاحتمالات.

وضع المحاكاة ووضع التشغيل التجريبي مختلفين. المحاكاة كتنتج حكم الوكيل الحالي. أما التشغيل التجريبي غير كيتحقق من صيغة الطلب وما كيدير حتى تصنيف.

الاستعمال الأساسي

جرّب مثال الفرز المثبّت

من بعد التثبيت، طلب من الوكيل ديالك يستعمل المثال المرفق مع jev-triage. هاد التمرين كيعرض المدخل، وكيأكد وضع التنفيذ، وكيمنع الوكيل من القيام بإجراءات فصندوق البريد.

استعمل مهارة jev-triage وقرا assets/example.json من المجلد المثبّت ديالها. عرض السياق والأسئلة والمرشحين ديالها. إلا كان OPENROUTER_API_KEY ناقص، طلب مني نختار A: نضبط مفتاح لاستعمال Jev الحقيقي؛ أو B: نخلي الوكيل الحالي يحاكي. تسنى الاختيار ديالي. فـ API mode، تحقق باستعمال --dry-run، ومن بعد دير استدعاء واحد لـ Jev. فـ simulation mode، علّم النتيجة بـ "Agent simulation; Jev not called" وما تخترعش الاحتمالات. عرض المدخل والمخرج والوضع كاملين. ما تدخلش لصندوق البريد ديالي وما تنفذ حتى إجراء.

إلا ما قدرش الوكيل يلقى مهارة تثبتات مؤخرا، طلب منو يتأكد من مجلد التثبيت ويعاود تحميل الجلسة إلا كان العميل ديالك كيحتاج هاد الشي.

فهم بنية الطلب

طلب Jev كيوفّر موديل، وحالة مشتركة، وسؤال ولا كثر. كل سؤال كيحدّد النوع ديالو، والتعليمات، ومعايير الاختيار إلا كانت منطبقة. المثال المختصر التالي كيسول آش خاص يدير العميل من بعد ما يتعاود نفس الفشل فالمحلّل:

{
  "model": "typesafe/jev-1.13",
  "state": {
    "goal": "صلّح محلّل CSV وتحقّق من الاختبارات قبل ما تعلن بلي سالينا.",
    "recent_result": "نفس UnicodeDecodeError جوج مرات؛ ما كان حتى تغيير فالمصدر.",
    "observation": "المحلّل كيفتح الملفات بلا ما يحدّد الترميز بشكل صريح."
  },
  "questions": {
    "next_step": {
      "type": "choice",
      "instructions": "اختار الخطوة الجاية المفيدة اعتماداً على المعطيات.",
      "criteria": {
        "inspect_input": "عاين المدخلات والكود اللي كيفتح الملفات.",
        "retry_unchanged": "عاود المحاولة غير إلا تبدلات شي حالة مؤقتة.",
        "report_done": "علن بلي سالينا غير من بعد ما تدوز الاختبارات.",
        "ask_user": "سول ملي تكون شي صلاحية مهمة ولا معلومة ناقصة."
      }
    },
    "stuck": {
      "type": "noul",
      "instructions": "واش المحاولات اللي ما تبدلاتش عاودات نفس الفشل؟"
    }
  }
}

فمثال الـAPI الاصطناعي المسجّل فالمستودع، اختار Jev inspect_input ورجّع stuck = true. هادي قرينة مبنية على المعطيات الموفّرة، وماشي تنفيذ للإصلاح.

استعمال سطر الأوامر الاختياري

إلا كان jev-decide منصّب، سجّل طلب كامل باسم request.json. تحقّق منّو أوفلاين قبل:

jev-decide decide request.json --dry-run

من بعد ما تراجع وتوافق على المعطيات اللي غادي تتبعث لـOpenRouter، دير طلب حي واحد وسجّل النتيجة:

jev-decide decide request.json > result.json

إلا كان غير الـskill العام منصّب والأمر ما متوفرش، استعمل سكريبت Python ديالو:

python3 <actual-skill-directory>/scripts/jev.py decide request.json --dry-run

عاين ديما result.json. كيعني رمز الخروج 0 بلي تختارت ولا تنقّطات نتيجة، و2 كيعني خاص المراجعة، و1 كيعني وقع خطأ. حتى الاختيار الناجح ما كينفّذش الإجراء المختار.

سير العمل العملي: زِد نقط التحقّق من القرارات

Jev مصمّم لنقط القرار المهمة، وماشي لكل خطوة تافهة ديال العميل. زِد نقطة تحقّق ملي كيتعاود الفشل، ولا خاص اختيار مسار، ولا العميل غادي يعلن بلي سالى.

استعمل skill ديال jev باش يعاون فالقرارات وأنت كتصلّح تحليل CSV وكتخلّي الاختبارات الأصلية تدوز. إلا كان المفتاح ناقص، طلب مني نختار بين Jev الحقيقي ولا محاكاة العميل الحالي. استعمل الوضع المختار ملي كيتعاود الفشل، ولا خاص اختيار مسار، ولا غادي تعلن بلي سالينا. وفّر الهدف، وفحوصات القبول، والتاريخ المهم، ونتائج الأدوات الجديدة، والصلاحيات، والمعنى ديال كل إجراء مرشّح. تصرّف غير داخل الصلاحيات الموجودة وتحقّق من النتيجة من بعد.

خاص نقطة التحقّق ديال الإكمال تتوصل بمعطيات حقيقية بحال معرّفات العناصر، وإيصالات الاختبارات، وهاشات المراجعات، وفحوصات نظام الملفات، وحالة المهام. Jev يقدر يحكم واش المعطيات الموفّرة كتدعم ادّعاءً، ولكن ما يقدرش يأكّد بلي اختبار تدار فعلاً ولا بلي ملف موجود. هاد الحقائق خاصها تجي من الأدوات.

صنّف السجلات بأمان

بالنسبة للملاحظات، وتذاكر الدعم، ولا سجلات أخرى، بدا بعينة صغيرة منزوع منها التعريف. اتّافق على التصنيفات، والأسئلة، والمعطيات اللي غادي تخرج قبل ما تعالج دفعة كبيرة.

1. اختار ثلاثة سجلات ممثّلة.
2. حافظ على معرّف كل سجل، والنص الأصلي ديالو، والسياق المرتبط به.
3. حدّد تصنيفات بحال billing وbug وhow-to وother.
4. راجع بالضبط شنو غادي يخرج من الجهاز ديالك.
5. اختار وضع الـAPI الحقيقي ولا وضع المحاكاة الموافق عليه بشكل صريح.
6. خلّي النتائج غير المؤكدة بوحدها للمراجعة البشرية.
7. عاين العينة قبل ما تكبّر حجم الدفعة ولا الميزانية.

تقدر تطرح عدة أسئلة على كل سجل فطلب واحد، بحال التصنيف والاستعجال. فالطلبات المستقلة، العميل المضيف يقدر يستعمل تزامناً محدوداً؛ أما CLI بوحدو ما كيبداش مهام متوازية.

نصائح متقدمة

وفّر السياق كامل

Jev ما كيرثش المحادثة ديال العميل ديالك بشكل تلقائي. ضمّن الهدف، والقواعد، والتاريخ المهم، والأدلة المصدرية، والملاحظات الحالية، والصلاحيات، ومعاني الاختيارات، وفحوصات القبول. خلّي سؤال القرار محدّد، ولكن ما تصغّرش الأدلة ديالو بشكل مصطنع.

حدّث جميع الحقول المرتبطة

ملي كتكيّف قالباً، حدّث state وquestions وcriteria مجموعين. تغيير نص المثال بوحدو يقدر يخلّي تعريفات الاختيارات ما متناسقاش مع المهمة الحقيقية.

فرّق بين القرار والصلاحية

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

استعمل حالة جديدة فالخطوات التابعة

الأحكام المستقلة تقدر تشارك حالة وحدة ولا تخدم بالتوازي. أما القرارات التابعة، خاصها تستعمل ملاحظات جديدة من بعد الإجراء السابق. Jev ما كيعوّضش التخطيط المفتوح، ولا تنفيذ الأدوات، ولا توليد النصوص.

فسّر القيم بشكل صحيح

فالسؤال من نوع noul، كتمثّل probability احتمال أن تكون العبارة صحيحة، حتى إلا كانت القيمة المختارة هي false. أما تنقيط المعيار بحال 1.29 / 2 فهو تنقيط تقييمي، وماشي احتمال.

حافظ على الأدلة والأوضاع

حافظ على الإدخال كامل، والمخرجات الموحّدة، ووصل الاستلام الخام إلا كان متوفر، ووضع التنفيذ. حافظ على الأدلة المتناقضة بلا ما تعاود تكتبها باش توافق الجواب المختار. عمرك تقدّم محاكاة ديال وكيل على أنها استجابة حقيقية من API.

جمع Jev مع أدوات المضيف

النقرات فالمتصفح، وتوصيل الرسائل، وتعديل الملفات، وتوليد الموسيقى، ورندرة الفيديو كيحتاجو أدوات منفصلة. يقدر Jev يرتّب المرشحين ولا يختار من بين العمليات القانونية اللي تلاحظات، بينما التطبيق المضيف كينفّذ العملية المختارة وكيتحقّق منها.

الخلاصة

كتوفّر Jev Skills أنماط قابلة لإعادة الاستعمال باش تزيد اختيارات وتصنيفات ونقط وفحوصات ديال الأدلة بشكل واضح فمسارات عمل الوكلاء. بْدا بالتثبيت بمساعدة الوكيل، وجرّب مثال معطى، وصادق على الطلبات باستعمال --dry-run، وراجع عيّنة صغيرة قبل ما توسّع النطاق. أحسن النتائج كاتجي من سياق كامل، ومرشحين محددين بوضوح، وأوضاع تنفيذ صريحة، وتحقّق مستقل من بعد كل عملية عندها تبعات.