تتسم أدوات المساعدة في البرمجة المستندة إلى الذكاء الاصطناعي بالقوة، ولكن لها حدود، إذ إنّ بيانات التدريب تتوقف عند تاريخ معيّن، ما يؤدي إلى عدم توفّر ميزات وتغييرات جديدة في واجهة برمجة التطبيقات. بدون الوصول إلى مستندات خاصة بـ Gemini، قد تقترح البرامج الآلية أنماطًا عامة بدلاً من أساليب محسّنة.
تعالج مهارات Gemini API هذه الثغرات من خلال منح وكيل الترميز إمكانية الوصول المباشر إلى أحدث مستندات Gemini API وأنماط الدمج وأفضل الممارسات. يضمن ذلك أن يقدّم لك الوكيل أمثلة وإرشادات أكثر دقة وتحديدًا بشأن الرموز البرمجية. من خلال تثبيت هذه المهارات، يبقى مساعدك في كتابة الرموز البرمجية على اطّلاع دائم على Gemini API المتطوّر وطريقة استخدامه المقترَحة.
المهارات المتاحة
تتوفّر المهارات التالية. ثبِّت تلك التي تتعلّق بحالة الاستخدام.
- skills.sh: يُنصح به. المعيار المفتوح لسلوكيات الوكيل القابلة للنقل
- Context7: متاح للمستخدمين الذين يستفيدون من منظومة Context7 المتكاملة.
gemini-api-dev
المهارة الأساسية لتطوير Gemini API:
- توجيه وكيل الترميز إلى مستندات Gemini API الرسمية
- تقدّم أفضل الممارسات لإنشاء تطبيقات مستنِدة إلى Gemini
- تتضمّن أنماطًا مقترَحة لعمليات الدمج الشائعة
التثبيت باستخدام skills.sh
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global
التثبيت باستخدام Context7
npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev
gemini-live-api-dev
مهارة إنشاء تطبيقات ذكاء اصطناعي حواري في الوقت الفعلي باستخدام واجهة برمجة التطبيقات Gemini Live توفّر هذه المهارة مستندات وأفضل الممارسات بشأن ما يلي:
- اتصالات WebSocket للبث بزمن استجابة منخفض
- بث الصوت والفيديو والنص
- رصد النشاط الصوتي وإمكانية مقاطعة المساعد
التثبيت باستخدام skills.sh
npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global
التثبيت باستخدام Context7
npx ctx7 skills install /google-gemini/gemini-skills gemini-live-api-dev
gemini-interactions-api
مهارة إنشاء تطبيقات باستخدام واجهة Interactions API Interactions API هي واجهة موحّدة للتفاعل مع نماذج ووكلاء Gemini، وهي مصمّمة للتطبيقات المستندة إلى الوكلاء. تتضمّن هذه المهارة ما يلي:
- إنشاء النصوص والمحادثات المتعدّدة الجولات والبث
- استدعاء الدالة والناتج المنظَّم وإنشاء الصور
- التنفيذ في الخلفية وعملاء Deep Research
- إدارة حالة المحادثة من جهة الخادم
- أنماط حِزم تطوير البرامج (SDK) في Python وTypeScript
التثبيت باستخدام skills.sh
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
التثبيت باستخدام Context7
npx ctx7 skills install /google-gemini/gemini-skills gemini-interactions-api
التحقق من التثبيت
بعد التثبيت، تأكَّد من أنّ وكيل الترميز قد فهرس المهارة ويمكنه الوصول إلى مستندات واجهة برمجة التطبيقات Gemini المباشرة.
1. التحقّق من سلوك الوكيل
أكثر طريقة موثوقة للتحقّق هي طرح سؤال فنّي على الوكيل بشأن Gemini API.
الطلب: "كيف يمكنني استخدام التخزين المؤقت للسياق مع Gemini API؟"
عند اكتمال عملية التثبيت بنجاح، سيتم تنفيذ ما يلي:
- الإشارة إلى طرق Gemini محدّدة، مثل
cacheContentأوcachedContents.create - عرض مؤشر يفيد بأنّك "تستخدم مهارة: gemini-api-dev"
2. تأكيد البيان
إذا قدّم لك الوكيل إجابة عامة، استخدِم أمر "الاكتشاف" المحدّد لبيئتك للتأكّد من تحميل المهارة.
| البيئة | طريقة التحقق |
|---|---|
| Claude Code | اكتب /skills في نافذة الوحدة الطرفية لإدراج جميع ملفات البيان النشطة. |
| المؤشر | افتح الإعدادات > القواعد. تأكَّد من ظهور المهارة ضمن "يقرّر الوكيل". |
| Antigravity | اكتب /skills list أو ضَع علامة في الشريط الجانبي التخصيصات > القواعد. |
| Gemini CLI | نفِّذ الأمر gemini skills list أو استخدِم الأمر /skills الذي يبدأ بشرطة مائلة أثناء الجلسة. |
| Copilot | اكتب @gemini /skills (أو /skills فقط) لعرض الإضافات النشطة. |
تحديد المشاكل وحلّها
إذا كان وكيلك يقدّم معلومات عامة فقط أو لا يتعرّف على طرق خاصة بـ Gemini، تحقَّق مما يلي:
لم يكتشف الوكيل المهارة
يفهرس معظم الوكلاء المهارات عند بدء التشغيل فقط.
الحلّ: أعِد تشغيل بيئة التطوير المتكاملة (Cursor أو VS Code) بالكامل أو اخرج من وكيلك المستند إلى الجهاز الطرفي (Claude Code) وأعِد فتحه.
النزاعات العالمية والمحلية
إذا تم التثبيت باستخدام العلامة --global، قد يتجاهل الوكيل هذه العلامة لصالح القواعد الخاصة بالمشروع.
الحلّ: جرِّب تثبيت المهارة مباشرةً في جذر مشروعك بدون العلامة العامة:
npx skills add google-gemini/gemini-skills --skill gemini-api-dev