دستیارهای کدنویسی هوش مصنوعی قدرتمند هستند اما محدودیتهایی دارند - دادههای آموزشی در یک تاریخ خاص قطع میشوند، ویژگیها و تغییرات جدید API را از دست میدهند. بدون دسترسی به مستندات خاص Gemini، ممکن است عوامل به جای رویکردهای بهینه، الگوهای عمومی را پیشنهاد دهند.
مهارت توسعه API Gemini با فراهم کردن دسترسی مستقیم به جدیدترین مستندات API Gemini، الگوهای یکپارچهسازی و بهترین شیوهها، این شکافها را برطرف میکند. این امر تضمین میکند که نماینده شما میتواند نمونهها و راهنماییهای کد دقیقتر و خاصتری ارائه دهد. با بهرهگیری از این مهارت، دستیار کدنویسی شما با API در حال تکامل Gemini و کاربرد توصیهشده آن بهروز میماند.
آنچه مهارت ارائه میدهد
مهارت توسعه API جمینی ( gemini-api-dev ):
- کدنویس شما را به مستندات رسمی API Gemini ارجاع میدهد.
- بهترین شیوهها را برای ساخت برنامههای مبتنی بر 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
تأیید نصب
پس از نصب، تأیید کنید که عامل کدنویسی شما مهارت را فهرستبندی کرده و میتواند به مستندات API زنده Gemini دسترسی داشته باشد.
۱. رفتار اپراتور را تأیید کنید
مطمئنترین راه برای تأیید این است که از نماینده خود یک سؤال فنی در مورد Gemini API بپرسید.
سوال: "چگونه میتوانم از ذخیرهسازی زمینه با رابط برنامهنویسی کاربردی Gemini استفاده کنم؟"
یک نصب موفق موارد زیر را به همراه خواهد داشت:
- به متدهای خاص Gemini مانند
cacheContentیاcachedContents.createمراجعه کنید. - یک نشانگر نشان دهید که «در حال استفاده از مهارت: gemini-api-dev» است.
تأیید مانیفست
اگر عامل یک پاسخ کلی میدهد، از دستور خاص "کشف" برای محیط خود استفاده کنید تا تأیید کنید که مهارت بارگذاری شده است.
| محیط زیست | روش تأیید |
|---|---|
| کلود کد | برای فهرست کردن تمام مانیفستهای فعال، عبارت /skills را در ترمینال تایپ کنید. |
| مکان نما | تنظیمات > قوانین را باز کنید. تأیید کنید که gemini-api-dev در زیر «تصمیمهای عامل» ظاهر میشود. |
| ضد جاذبه | عبارت /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