تتسم أدوات المساعدة في البرمجة المستندة إلى الذكاء الاصطناعي بالقوة، ولكن لها حدود، إذ إنّ بيانات التدريب تتوقف عند تاريخ معيّن، ما يؤدي إلى عدم توفّر ميزات وتغييرات جديدة في واجهة برمجة التطبيقات. بدون الوصول إلى مستندات خاصة بـ Gemini، قد تقترح البرامج الآلية أنماطًا عامة بدلاً من أساليب محسّنة.
تعالج مهارة تطوير Gemini API هذه الثغرات من خلال منح وكيل الترميز إمكانية الوصول المباشر إلى أحدث مستندات Gemini API وأنماط الدمج وأفضل الممارسات. يضمن ذلك أن يقدّم لك الوكيل أمثلة وإرشادات أكثر دقة وتحديدًا بشأن الرموز البرمجية. من خلال الاستفادة من هذه المهارة، سيظل مساعدك في البرمجة على اطّلاع دائم على التحديثات في Gemini API وطريقة استخدامه المقترَحة.
ما تقدّمه المهارة
مهارة تطوير Gemini API (gemini-api-dev):
- توجيه وكيل الترميز إلى مستندات Gemini API الرسمية
- تقدّم أفضل الممارسات لإنشاء تطبيقات مستنِدة إلى Gemini
- تتضمّن أنماطًا مقترَحة لعمليات الدمج الشائعة
توضّح الأقسام التالية طرق التثبيت استنادًا إلى النظام الأساسي المفضّل لإدارة المهارات. كلاهما يثبّت المهارة نفسها، لذا شغِّل هذين الأمرين في الوحدة الطرفية من أي دليل.
- skills.sh: يُنصح به. المعيار المفتوح لسلوكيات الوكلاء القابلة للنقل
- Context7: متاح للمستخدمين الذين يستفيدون من منظومة Context7 المتكاملة.
التثبيت باستخدام skills.sh
# List available skills
npx skills add google-gemini/gemini-skills --list
# Install the gemini-api-dev skill globally
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global
التثبيت باستخدام Context7
# Interactively browse and install skills
npx ctx7 skills install /google-gemini/gemini-skills
# Install a specific skill directly
npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev
التحقق من التثبيت
بعد التثبيت، تأكَّد من أنّ وكيل الترميز قد فهرس المهارة ويمكنه الوصول إلى مستندات Gemini API المباشرة.
1. التحقّق من سلوك الوكيل
أكثر طريقة موثوقة للتحقّق هي طرح سؤال فنّي على الوكيل بشأن Gemini API.
الطلب: "كيف يمكنني استخدام التخزين المؤقت للسياق مع Gemini API؟"
عند اكتمال عملية التثبيت بنجاح، سيتم تنفيذ ما يلي:
- الإشارة إلى طرق Gemini محدّدة، مثل
cacheContentأوcachedContents.create - عرض مؤشر يفيد بأنّك "تستخدم أداة: gemini-api-dev"
تأكيد البيان
إذا قدّم الوكيل إجابة عامة، استخدِم أمر "الاكتشاف" المحدّد لبيئتك للتأكّد من تحميل المهارة.
| البيئة | طريقة التحقق |
|---|---|
| Claude Code | اكتب /skills في نافذة الوحدة الطرفية لإدراج جميع ملفات البيان النشطة. |
| المؤشر | افتح الإعدادات > القواعد. يظهر خيار "التحقّق من gemini-api-dev" ضمن "يقرّر الوكيل". |
| 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