مهارات وكلاء الذكاء الاصطناعي

مهارات GetMyBot هي أغلفة وكيلية جاهزة فوق GetMyBot API. تُعلّم الوكيل الذكي (مثلاً Claude Code) التعامل مع بوتاتك بلغة طبيعية: «أنشئ تفاعلاً في GetMyBot»، «شغّل بث جماعي GetMyBot بعلامة VIP»، «أعرض إحصائيات البوت». تحت الغطاء تستدعي المهارة أدوات MCP الخاصة بـ GetMyBot؛ وإن لم يكن خادم MCP متصلاً — تُنفّذ نفس الطلبات عبر REST برمزك.

المهارات ليست ميزة مدفوعة منفصلة ولا سوقاً. هي ملفات SKILL.md (بصيغة Claude Code) تثبّتها محلياً بجانب وكيلك.

كيف تعمل

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

  • MCP (مفضَّل) — إن كان خادم GetMyBot MCP متصلاً بالوكيل، تستدعي المهارة الأدوات مباشرةً.
  • REST fallback — إن لم يكن MCP متاحاً، تُنفّذ المهارة نفس العمليات بطلبات curl مع الرمز الشخصي.

المصادقة في جميع المهارات واحدة: الرمز الشخصي mbp_… والعنوان الأساسي /api. التفاصيل في دليل التفويض.

المهارات الست

  • mybot — نقطة الدخول والتنقل: ما هو GetMyBot API وكيف تحصل على PAT ونطاقاته والعنوان الأساسي وكيف تتصل بخادم MCP ومتى REST ومتى MCP وصيغة الأخطاء والترقيم والحدود. من هنا ينتقل الوكيل إلى المهارات الخمس الأخرى.
  • mybot-bots — الاتصال وإدارة البوتات: التحقق من الرمز والاتصال والقائمة والبطاقة والتحديث والمزامنة وتغيير الرمز والنقل والحذف والإعدادات والقوالب.
  • mybot-reactions — منشئ التفاعلات (الأكبر): هيكل «مُشغِّل → شروط → محادثات → إجراءات» والإنشاء والتحديث وأنواع المُشغِّلات وشروط AND/OR وكتالوج الإجراءات والرسائل والأزرار والأزرار الديناميكية والمعاملات والصيغ (DSL) والمجلدات وروابط التفاعلات والاستيراد من SamBot واختبار الصيغ والترتيب.
  • mybot-broadcasts — البث الجماعي: التشغيل بالتفاعل والتجزئة بالعلامات والإيقاف المؤقت/الاستئناف/الإلغاء والحالة وتعديل الرسائل المُرسَلة (فردياً و«للجميع») وقائمة الانتظار وإعادة المحاولة.
  • mybot-data — البيانات والتكاملات: المجموعات (الجداول — الحقول والسجلات) والسيناريوهات (flows) والتكاملات (الذكاء الاصطناعي وGoogle Sheets وGetCourse والمعالج الخارجي عبر WebSocket) والاتصالات والوصول.
  • mybot-analytics — قابلية الملاحظة والجمهور: الإحصائيات (استهلاك الرصيد والمقاييس والسجل وسلامة التفاعلات) والتحليلات (الجمهور والمحادثات والقُمع) والمشتركون والعلامات والمحادثات والفوترة (الرصيد والخطط والمعاملات).

التثبيت

تعيش المهارات في مستودع GetMyBot في مجلد skills/. كل مهارة مجلد skills/<name>/ يحتوي ملفات SKILL.md (دليل مختصر) وreference.md (مرجع كامل للمجال مع أمثلة على MCP وcurl).

لكي يرى الوكيل المهارات، اربطها بكتالوج مهارات Claude Code الخاص بك. يوجد في المستودع سكريبت جاهز:

./skills/install.sh

يُنشئ روابط رمزية ~/.claude/skills/<name> تشير إلى المجلدات داخل المستودع — التعديلات في المستودع مرئية فوراً للوكيل دون نسخ زائدة. بعد التثبيت صُغ المهمة بكلمات عادية («ابنِ في GetMyBot بوت ردٍّ تلقائي»)، وسيُحمّل الوكيل المهارة المناسبة تلقائياً.

الخطوات التالية