run-gemini-cli

نظرة عامة

run-gemini-cli هو إجراء GitHub يدمج [Gemini] في سير عمل التطوير الخاص بك عبر [Gemini CLI]. يعمل كعامل مستقل للمهام البرمجية الروتينية الحرجة، وكمتعاون حسب الطلب يمكنك تفويض العمل إليه بسرعة.

استخدمه لتنفيذ مراجعات طلبات السحب على GitHub، وفرز المشكلات، وإجراء تحليل الكود وتعديله، والمزيد باستخدام [Gemini] بطريقة محادثة (مثل @gemini-cli fix this issue) مباشرة داخل مستودعات GitHub الخاصة بك.

• run-gemini-cli
  • نظرة عامة
  • الميزات
  • بدء سريع
    • 1. احصل على مفتاح API من Gemini
    • 2. أضفه كسر من أسرار GitHub
    • 3. حدّث ملف .gitignore الخاص بك
    • 4. اختر سير عمل
    • 5. جربه!
  • سير العمل
    • Gemini Dispatch
    • فرز المشكلات
    • مراجعة طلب السحب
    • مساعد Gemini CLI
  • الإعدادات
    • المدخلات
    • المخرجات
    • متغيرات المستودع
    • الأسرار
  • المصادقة
    • المصادقة مع Google
    • المصادقة مع GitHub
  • قابلية المراقبة
  • الإضافات
  • أفضل الممارسات
  • التخصيص
  • المساهمة

الميزات

• الأتمتة: تشغيل سير العمل بناءً على الأحداث (مثل فتح مشكلة) أو الجداول الزمنية (مثل الليلي).
• التعاون حسب الطلب: تشغيل سير العمل في تعليقات المشكلات وطلبات السحب عن طريق ذكر [Gemini CLI] (مثل @gemini-cli /review).
• قابل للتوسيع بالأدوات: استفد من قدرات [Gemini] على استدعاء الأدوات للتفاعل مع واجهات CLI الأخرى مثل [GitHub CLI] (gh).
• قابل للتخصيص: استخدم ملف GEMINI.md في مستودعك لتقديم تعليمات وسياق خاص بالمشروع لـ [Gemini CLI].

بدء سريع

ابدأ مع Gemini CLI في مستودعك في دقائق معدودة:

1. احصل على مفتاح API من Gemini

احصل على مفتاح API الخاص بك من [Google AI Studio] مع حصص سخية مجانية.

2. أضفه كسر من أسرار GitHub

خزّن مفتاح API الخاص بك كسر باسم GEMINI_API_KEY في مستودعك:

• اذهب إلى Settings > Secrets and variables > Actions في مستودعك.
• انقر على New repository secret.
• الاسم: GEMINI_API_KEY، القيمة: مفتاح API الخاص بك.

3. حدّث ملف .gitignore الخاص بك

أضف الإدخالات التالية إلى ملف .gitignore الخاص بك:

# gemini-cli settings
.gemini/

# GitHub App credentials
gha-creds-*.json

4. اختر سير عمل

لديك خياران لإعداد سير عمل:

الخيار أ: استخدم أمر الإعداد (موصى به)

1. ابدأ Gemini CLI في الطرفية الخاصة بك:

   gemini
   

2. في Gemini CLI في الطرفية، اكتب:

   /setup-github
   

الخيار ب: انسخ سير العمل يدويًا

1. انسخ سير العمل المُعدّة مسبقًا من دليل examples/workflows إلى دليل .github/workflows في مستودعك. ملاحظة: يجب أيضًا نسخ سير العمل gemini-dispatch.yml، الذي يقوم بتشغيل سير العمل لتنفيذه.

5. جربه!

مراجعة طلب السحب:

• افتح طلب سحب في مستودعك وانتظر المراجعة التلقائية.
• علّق بـ @gemini-cli /review على طلب سحب موجود لتشغيل مراجعة يدويًا.

فرز المشكلات:

• افتح مشكلة وانتظر الفرز التلقائي.
• علّق بـ @gemini-cli /triage على مشكلات موجودة لتشغيل الفرز يدويًا.

المساعدة العامة بالذكاء الاصطناعي:

• في أي مشكلة أو طلب سحب، اذكر @gemini-cli متبوعًا بطلبك.
• أمثلة:
  • @gemini-cli explain this code change
  • @gemini-cli suggest improvements for this function
  • @gemini-cli help me debug this error
  • @gemini-cli write unit tests for this component

سير العمل

يوفر هذا الإجراء العديد من سير العمل المُعدّة مسبقًا لحالات استخدام مختلفة. كل سير عمل مُصمم ليتم نسخه إلى دليل .github/workflows في مستودعك وتخصيصه حسب الحاجة.

Gemini Dispatch

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

فرز المشكلات

يمكن استخدام هذا الإجراء لفرز مشكلات GitHub تلقائيًا أو وفقًا لجدول زمني. للحصول على دليل مفصل حول كيفية إعداد نظام فرز المشكلات، توجه إلى وثائق سير عمل فرز مشكلات GitHub.

مراجعة طلب السحب

يمكن استخدام هذا الإجراء لمراجعة طلبات السحب تلقائيًا عند فتحها. للحصول على دليل مفصل حول كيفية إعداد نظام مراجعة طلب السحب، توجه إلى وثائق سير عمل مراجعة PR على GitHub.

مساعد Gemini CLI

يمكن استخدام هذا النوع من الإجراءات لاستدعاء مساعد Gemini AI للأغراض العامة والمحادثة داخل طلبات السحب والمشكلات لأداء مجموعة واسعة من المهام. للحصول على دليل مفصل حول كيفية إعداد سير عمل Gemini CLI للأغراض العامة، توجه إلى وثائق سير عمل مساعد Gemini.

الإعدادات

المدخلات

• gcp_location: (اختياري) موقع Google Cloud.

• gcp_project_id: (اختياري) معرف مشروع Google Cloud.

• gcp_service_account: (اختياري) البريد الإلكتروني لحساب الخدمة في Google Cloud.

• gcp_workload_identity_provider: (اختياري) موفر هوية العمل في Google Cloud.

• gcp_token_format: (اختياري، القيمة الافتراضية: access_token) تنسيق الرمز المميز للمصادقة. اضبط على "access_token" لإنشاء رموز وصول (يتطلب حساب خدمة)، أو اضبط على سلسلة فارغة لـ WIF المباشر. يمكن أن يكون "access_token" أو "id_token".

• gcp_access_token_scopes: (اختياري، القيمة الافتراضية: https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/userinfo.profile) نطاقات رمز الوصول عند استخدام token_format "access_token". قائمة مفصولة بفواصل لنطاقات OAuth 2.0.

• gemini_api_key: (اختياري) مفتاح API لواجهة Gemini API.

• gemini_cli_version: (اختياري، القيمة الافتراضية: latest) إصدار Gemini CLI الذي سيتم تثبيته. يمكن أن يكون "latest"، أو "preview"، أو "nightly"، أو رقم إصدار محدد، أو فرع git أو علامة أو commit. لمزيد من المعلومات، راجع إصدارات Gemini CLI.

• gemini_debug: (اختياري) تمكين تسجيل التصحيح وتدفق المخرجات.

• gemini_model: (اختياري) النموذج الذي سيتم استخدامه مع Gemini.

• google_api_key: (اختياري) مفتاح Vertex AI API الذي سيتم استخدامه مع Gemini.