كيفية استخدام Gemini CLI GitHub Actions مجانًا

مرحباً أيها المطورون! هل أنتم مستعدون لتعزيز سير عملكم على GitHub باستخدام الذكاء الاصطناعي؟ إليكم إجراءات GitHub لـ Gemini CLI، أداة مجانية ومفتوحة المصدر تجلب ذكاء Gemini الاصطناعي من Google إلى مستودعكم لأتمتة مهام البرمجة كالمحترفين. في هذا الدليل التفاعلي، سنستكشف ما هو Gemini CLI، وكيف تتناسب إجراءات GitHub معه، ولماذا تُعد إجراءات GitHub لـ Gemini CLI بمثابة تغيير جذري، وكيفية البدء. دعونا ننغمس في مغامرة البرمجة المدعومة بالذكاء الاصطناعي هذه!

💡

هل تريد أداة رائعة لاختبار واجهة برمجة التطبيقات (API) تُنشئ وثائق API جميلة؟

هل تريد منصة متكاملة وشاملة لفريق المطورين لديك للعمل معًا بأقصى إنتاجية؟

Apidog يلبي جميع متطلباتك، ويحل محل Postman بسعر أكثر بأسعار معقولة بكثير!

زر

ما هو Gemini CLI؟

أولاً، دعنا نتحدث عن Gemini CLI. إنها أداة واجهة سطر الأوامر (CLI) مفتوحة المصدر من Google، تم إطلاقها في يونيو 2025، والتي تجلب قوة Gemini 2.5 Pro (مع نافذة سياق ضخمة بحجم مليون رمز مميز) إلى محطتك الطرفية. فكر فيها كرفيقك في البرمجة المدعوم بالذكاء الاصطناعي الذي يمكنه كتابة التعليمات البرمجية، وتصحيح الأخطاء، وتحليل قواعد التعليمات البرمجية، وحتى التعامل مع المهام غير البرمجية مثل إنشاء المحتوى أو البحث—كل ذلك من سطر الأوامر. إنها مجانية مع حساب Google (60 طلبًا/دقيقة، 1000/يوم) وتدعم ميزات متقدمة مثل دمج الأدوات وخوادم بروتوكول سياق النموذج (MCP) لمهام مثل عمليات GitHub أو إنشاء الوسائط. سواء كنت تعيد هيكلة بايثون أو تقوم بإنشاء نماذج أولية للتطبيقات، فإن Gemini CLI هي خيارك الأمثل لتعزيز الإنتاجية.

مقدمة إلى GitHub Actions

إذا كنت جديدًا على إجراءات GitHub (GitHub Actions)، فهي منصة CI/CD المدمجة في GitHub التي تقوم بأتمتة سير عمل برامجك. يمكنك إعداد سير العمل (المُعرّف في ملفات YAML في دليل .github/workflows في مستودعك) ليتم تشغيله عند وقوع أحداث مثل عمليات الدفع (pushes)، أو طلبات السحب (pull requests)، أو المشكلات (issues). يمكن لسير العمل هذه بناء التعليمات البرمجية، أو اختبارها، أو نشرها، والآن، مع إجراءات GitHub لـ Gemini CLI، يمكنها أيضًا الاستفادة من الذكاء الاصطناعي للتعامل مع مهام مثل مراجعات التعليمات البرمجية أو فرز المشكلات. إنها مثل وجود مساعد آلي يعمل في السحابة، مما يوفر عليك الوقت والجهد.

ما هي إجراءات GitHub لـ Gemini CLI؟

تُعد إجراءات GitHub لـ Gemini CLI هي المستوى التالي من دمج Gemini CLI في GitHub، وقد تم الإعلان عنها في 5 أغسطس 2025. على عكس Gemini CLI المستقل للاستخدام في المحطة الطرفية، تم تصميم هذه الأداة للتعاون الجماعي، حيث تعمل بشكل غير متزامن في مستودعك لأتمتة مهام البرمجة. يتم تشغيلها بواسطة أحداث مثل المشكلات الجديدة أو طلبات السحب، وتستخدم ذكاء Gemini الاصطناعي لفهم قاعدة التعليمات البرمجية الخاصة بك وتنفيذ مهام مثل:

الفرز الذكي للمشكلات: يقوم بتحليل المشكلات الجديدة وتصنيفها وتحديد أولوياتها تلقائيًا للحفاظ على تركيز مشروعك.
مراجعات طلبات السحب: يوفر ملاحظات فورية مدفوعة بالذكاء الاصطناعي حول تغييرات التعليمات البرمجية، ويكشف الأخطاء أو يقترح تحسينات.
التعاون عند الطلب: ضع علامة @gemini-cli في المشكلات أو طلبات السحب لتفويض المهام مثل كتابة التعليمات البرمجية أو إصلاح الأخطاء.

إنها مفتوحة المصدر (Apache 2.0)، وقابلة للتخصيص، وآمنة، وتستخدم اتحاد هوية عبء العمل (WIF) من Google Cloud لتجنب مفاتيح API طويلة الأمد. بالإضافة إلى ذلك، تعمل في حاويات معزولة للسلامة وتدعم القياس عن بعد لتصحيح الأخطاء عبر Google Cloud Monitoring. فكر فيها كزميل ذكاء اصطناعي لا يكل يعمل على مدار الساعة طوال أيام الأسبوع لتبسيط عملية التطوير الخاصة بك.

البدء باستخدام إجراءات GitHub لـ Gemini CLI

هل أنت مستعد لإحضار إجراءات GitHub لـ Gemini CLI إلى مستودعك؟ الإعداد سهل للغاية، ويمكنك البدء في دقائق. إليك دليل خطوة بخطوة للبدء:

الخطوة 1: تثبيت Gemini CLI

التحقق من المتطلبات الأساسية:

تأكد من تثبيت Node.js 20+ (nodejs.org). بدلاً من ذلك، استخدم Homebrew لنظامي macOS/Linux.

2. تثبيت Gemini CLI:

شغّل في محطتك الطرفية:

npm install -g @google-gemini/gemini-cli

أو باستخدام Homebrew:

brew install gemini-cli

3. المصادقة:

شغّل gemini وسجّل الدخول باستخدام حساب Google الخاص بك للوصول المجاني (60 طلبًا/دقيقة، 1000/يوم). للحصول على حدود أعلى، احصل على مفتاح API من Google AI Studio.

الخطوة 2: إعداد إجراءات GitHub لـ Gemini CLI

احصل على مفتاح API الخاص بك:

قم بزيارة Google AI Studio، سجّل الدخول، وأنشئ مفتاح API. انسخه بأمان.

2. أضف مفتاح API إلى GitHub:

انتقل إلى مستودع GitHub الخاص بك Settings (الإعدادات) > Secrets and variables (الأسرار والمتغيرات) > Actions (الإجراءات).
انقر على New repository secret (سر مستودع جديد)، سمّه GEMINI_API_KEY، والصق مفتاحك.

3. انسخ سير العمل المُجهز مسبقًا:

استنسخ أو قم بزيارة github.com/google-github-actions/run-gemini-cli.
انسخ سير عمل (على سبيل المثال، فرز المشكلات أو مراجعة طلب السحب) من دليل examples/workflows إلى مجلد .github/workflows في مستودعك (أنشئه إذا لم يكن موجودًا). مثال على سير العمل (gemini.yml):

name: Gemini CLI Issue Triage
on:
  issues:
    types: [opened]
jobs:
  triage:
    runs-on: ubuntu-latest
    steps:
      - uses: google-github-actions/run-gemini-cli@v1
        with:
          gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
          prompt: "Triage this issue and apply labels"

خصص prompt أو أضف إعدادات مثل gcp_project_id للاستخدام المتقدم.

4. شغّل أمر الإعداد:

في محطتك الطرفية، انتقل إلى مستودعك وشغّل:

gemini /setup-github

يقوم هذا بتهيئة مستودعك لـ إجراءات GitHub لـ Gemini CLI.

الخطوة 3: اختبرها

تشغيل سير عمل:

افتح مشكلة جديدة أو طلب سحب في مستودعك. سيتم تشغيل سير العمل تلقائيًا، وسيقوم Gemini CLI بتحليل المشكلة وتصنيفها أو مراجعة طلب السحب.
بدلاً من ذلك، علّق @gemini-cli /review في طلب سحب لتشغيل مراجعة يدوية.

2. التحقق من النتائج:

اعرض مخرجات سير العمل في علامة تبويب Actions (الإجراءات) في مستودعك. على سبيل المثال، قد يقوم سير عمل فرز المشكلات بتصنيف مشكلة على أنها "خطأ" أو "تحسين" مع علامة أولوية.

3. تخصيص سير العمل:

عدّل ملف YAML لإضافة مطالبات مخصصة أو دمج أدوات مثل gh CLI لعمليات GitHub. أنشئ ملف GEMINI.md في الجذر الخاص بمستودعك لتحديد قواعد خاصة بالمشروع (على سبيل المثال، معايير الترميز).

الخطوة 4: التحسين باستخدام الميزات المتقدمة

إضافة سياق: استخدم ملف GEMINI.md لتوفير إرشادات الترميز أو سياق المشروع للحصول على استجابات أفضل من الذكاء الاصطناعي.
تمكين القياس عن بعد: قم بتهيئة OpenTelemetry في سير عملك لمراقبة الأداء عبر Google Cloud Monitoring.
استخدام خوادم MCP: ادمج أدوات مثل Google Search أو Imagen عبر MCP لمهام متقدمة مثل إنشاء الوسائط.

نصائح استكشاف الأخطاء وإصلاحها

أخطاء مفتاح API؟ تحقق من GEMINI_API_KEY في أسرار GitHub وتأكد من أنه نشط في Google AI Studio.
سير العمل لا يتم تشغيله؟ تحقق من صيغة YAML في .github/workflows وتأكد من أن مشغل الحدث (مثل issues: [opened]) يطابق الإجراء الخاص بك.
حدود المعدل؟ يحصل المستخدمون في الطبقة المجانية على 60 طلبًا/دقيقة. للحصول على المزيد، استخدم مفتاح Google AI Studio أو Vertex AI.
أداء بطيء؟ تأكد من أن مشغلك هو ubuntu-latest للحصول على سرعة مثالية.

الخاتمة

تُعد إجراءات GitHub لـ Gemini CLI خيارًا بديهيًا للفرق التي تتطلع إلى أتمتة المهام المتكررة مع إبقاء العنصر البشري في صلب القرارات الحاسمة. إنها مجانية (تتجاوز تكاليف استخدام API بعد الطبقة المجانية)، وآمنة مع WIF، وقابلة للتخصيص لأي مشروع. تُظهر منشورات X حماس المطورين لسرعتها ووعيها بالسياق، حيث أشار أحد المستخدمين إلى أنها "تنجز المهام عبر المستودعات أسرع بـ 10 مرات من Claude" لإصلاح الأخطاء. سواء كنت تدير مشاريع مفتوحة المصدر أو مستودعات مؤسسية، توفر هذه الأداة الوقت وتعزز التعاون. جربها وأخبرنا عن حالة الاستخدام المفضلة لديك في التعليقات!

💡

زر