دستیارهای کدنویسی هوش مصنوعی قدرتمند هستند اما محدودیتهایی دارند - دادههای آموزشی در یک تاریخ خاص قطع میشوند، ویژگیها و تغییرات جدید API را از دست میدهند. بدون دسترسی به مستندات خاص Gemini، ممکن است عوامل به جای رویکردهای بهینه، الگوهای عمومی را پیشنهاد دهند.
مهارتهای Gemini API با فراهم کردن دسترسی مستقیم به جدیدترین مستندات Gemini API، الگوهای یکپارچهسازی و بهترین شیوهها، این شکافها را برطرف میکند. این امر تضمین میکند که نماینده شما میتواند مثالها و راهنماییهای دقیقتر و خاصتری از کد ارائه دهد. با نصب این مهارتها، دستیار کدنویسی شما با API در حال تکامل Gemini و نحوه استفاده توصیهشده از آن بهروز میماند.
مهارتهای موجود
مهارتهای زیر موجود است. مهارتهای مرتبط با مورد استفاده خود را نصب کنید.
- skills.sh : توصیه میشود. استاندارد باز برای رفتارهای عامل قابل حمل.
- Context7 : برای کاربرانی که از قبل از اکوسیستم Context7 استفاده میکنند، پشتیبانی میشود.
بخشهای موردنیاز علامتگذاری شدهاند
مهارت اصلی توسعه API در Gemini:
- کدنویس شما را به مستندات رسمی API Gemini ارجاع میدهد.
- بهترین شیوهها را برای ساخت برنامههای مبتنی بر 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. این مهارت، مستندات و بهترین شیوهها را برای موارد زیر ارائه میدهد:
- اتصالات 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-api
مهارت ساخت برنامهها با Interactions API . Interactions API یک رابط یکپارچه برای تعامل با مدلها و عاملهای Gemini است که برای برنامههای عاملمحور طراحی شده است. این مهارت موارد زیر را پوشش میدهد:
- تولید متن، چت چند نوبتی و پخش جریانی
- فراخوانی تابع، خروجی ساختاریافته و تولید تصویر
- اجرای پسزمینه و عوامل تحقیق عمیق
- مدیریت وضعیت مکالمه سمت سرور
- الگوهای SDK پایتون و تایپاسکریپت
نصب با 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
تأیید نصب
پس از نصب، تأیید کنید که عامل کدنویسی شما مهارت را فهرستبندی کرده و میتواند به مستندات API زنده Gemini دسترسی داشته باشد.
۱. رفتار اپراتور را تأیید کنید
مطمئنترین راه برای تأیید این است که از نماینده خود یک سؤال فنی در مورد Gemini API بپرسید.
سوال: "چگونه میتوانم از ذخیرهسازی زمینه با رابط برنامهنویسی کاربردی Gemini استفاده کنم؟"
یک نصب موفق موارد زیر را به همراه خواهد داشت:
- به متدهای خاص Gemini مانند
cacheContentیاcachedContents.createمراجعه کنید. - یک نشانگر نشان دهید که «در حال استفاده از مهارت: gemini-api-dev» است.
2. مانیفست را تأیید کنید
اگر عامل یک پاسخ کلی میدهد، از دستور خاص "کشف" برای محیط خود استفاده کنید تا تأیید کنید که مهارت بارگذاری شده است.
| محیط زیست | روش تأیید |
|---|---|
| کلود کد | برای فهرست کردن تمام مانیفستهای فعال، عبارت /skills را در ترمینال تایپ کنید. |
| مکان نما | تنظیمات > قوانین را باز کنید. تأیید کنید که مهارت در زیر «تصمیمهای عامل» ظاهر میشود. |
| ضد جاذبه | عبارت /skills list را تایپ کنید یا نوار کناری Customizations > Rules را بررسی کنید. |
| رابط خط فرمان جمینی | gemini skills list اجرا کنید یا از دستور /skills slash در جلسه استفاده کنید. |
| کمک خلبان | برای مشاهده افزونههای فعال @gemini /skills (یا فقط /skills ) را تایپ کنید. |
عیبیابی
اگر نماینده شما فقط اطلاعات کلی ارائه میدهد یا روشهای خاص Gemini را تشخیص نمیدهد، موارد زیر را بررسی کنید:
نماینده مهارت را کشف نکرد
بیشتر کارشناسان فقط در بدو ورود، مهارتها را فهرست میکنند.
راه حل: IDE خود (Cursor/VS Code) را کاملاً مجدداً راه اندازی کنید یا از آن خارج شوید و عامل مبتنی بر ترمینال خود (Claude Code) را دوباره باز کنید.
درگیری جهانی در مقابل درگیری محلی
اگر با پرچم --global نصب کردهاید، ممکن است عامل شما آن را به نفع قوانین خاص پروژه نادیده بگیرد.
راه حل: سعی کنید مهارت را مستقیماً در ریشه پروژه خود و بدون پرچم سراسری نصب کنید:
npx skills add google-gemini/gemini-skills --skill gemini-api-dev