run-gemini-cli

अवलोकन

run-gemini-cli एक GitHub Action है जो [Gemini CLI] के माध्यम से [Gemini] को आपके डेवलपमेंट वर्कफ़्लो में एकीकृत करता है। यह महत्वपूर्ण नियमित कोडिंग कार्यों के लिए एक स्वायत्त एजेंट और एक ऑन-डिमांड सहयोगी दोनों के रूप में कार्य करता है, जिसे आप तुरंत काम सौंप सकते हैं।

इसका उपयोग GitHub पुल रिक्वेस्ट समीक्षा करने, इश्यू को ट्रायेज करने, कोड विश्लेषण और संशोधन करने और बहुत कुछ करने के लिए [Gemini] के साथ संवादात्मक रूप से (जैसे, @gemini-cli fix this issue) सीधे आपके GitHub रिपॉजिटरी के अंदर करें।

• run-gemini-cli
  • अवलोकन
  • विशेषताएं
  • त्वरित प्रारंभ
    • 1. Gemini API कुंजी प्राप्त करें
    • 2. इसे GitHub Secret के रूप में जोड़ें
    • 3. अपनी .gitignore अपडेट करें
    • 4. एक वर्कफ़्लो चुनें
    • 5. इसे आज़माएं!
  • वर्कफ़्लो
    • Gemini Dispatch
    • Issue Triage
    • Pull Request Review
    • Gemini CLI Assistant
  • कॉन्फ़िगरेशन
    • इनपुट
    • आउटपुट
    • रिपॉजिटरी वेरिएबल्स
    • सीक्रेट्स
  • प्रमाणीकरण
    • Google प्रमाणीकरण
    • GitHub प्रमाणीकरण
  • अवलोकनीयता
  • एक्सटेंशन
  • सर्वोत्तम अभ्यास
  • अनुकूलन
  • योगदान

विशेषताएं

• स्वचालन: ईवेंट (जैसे इश्यू खोलना) या शेड्यूल (जैसे रात्रिकालीन) के आधार पर वर्कफ़्लो को ट्रिगर करें।
• ऑन-डिमांड सहयोग: [Gemini CLI] का उल्लेख करके (जैसे, @gemini-cli /review) इश्यू और पुल रिक्वेस्ट टिप्पणियों में वर्कफ़्लो ट्रिगर करें।
• उपकरणों के साथ विस्तार योग्य: [GitHub CLI] (gh) जैसे अन्य CLI के साथ इंटरैक्ट करने के लिए [Gemini] मॉडल की टूल-कॉलिंग क्षमताओं का लाभ उठाएं।
• अनुकूलन योग्य: [Gemini CLI] को प्रोजेक्ट-विशिष्ट निर्देश और संदर्भ प्रदान करने के लिए अपने रिपॉजिटरी में GEMINI.md फ़ाइल का उपयोग करें।

त्वरित प्रारंभ

बस कुछ मिनटों में अपने रिपॉजिटरी में Gemini CLI के साथ शुरुआत करें:

1. Gemini API कुंजी प्राप्त करें

[Google AI Studio] से अपनी API कुंजी प्राप्त करें, जिसमें उदार निःशुल्क कोटा है।

2. इसे GitHub Secret के रूप में जोड़ें

अपनी API कुंजी को अपने रिपॉजिटरी में GEMINI_API_KEY नामक सीक्रेट के रूप में संग्रहित करें:

• अपने रिपॉजिटरी के Settings > Secrets and variables > Actions पर जाएं
• New repository secret पर क्लिक करें
• नाम: GEMINI_API_KEY, मान: आपकी API कुंजी

3. अपनी .gitignore अपडेट करें

अपनी .gitignore फ़ाइल में निम्नलिखित प्रविष्टियाँ जोड़ें:

# gemini-cli सेटिंग्स
.gemini/

# GitHub App क्रेडेंशियल्स
gha-creds-*.json

4. एक वर्कफ़्लो चुनें

वर्कफ़्लो सेट करने के लिए आपके पास दो विकल्प हैं:

विकल्प A: सेटअप कमांड का उपयोग करें (अनुशंसित)

1. अपने टर्मिनल में Gemini CLI शुरू करें:

   gemini
   

2. अपने टर्मिनल में Gemini CLI में टाइप करें:

   /setup-github
   

विकल्प B: मैन्युअल रूप से वर्कफ़्लो कॉपी करें

1. examples/workflows निर्देशिका से पूर्व-निर्मित वर्कफ़्लो को अपने रिपॉजिटरी की .github/workflows निर्देशिका में कॉपी करें। ध्यान दें: gemini-dispatch.yml वर्कफ़्लो को भी कॉपी किया जाना चाहिए, जो वर्कफ़्लो को चलाने के लिए ट्रिगर करता है।

5. इसे आज़माएं!

Pull Request समीक्षा:

• अपने रिपॉजिटरी में एक पुल रिक्वेस्ट खोलें और स्वचालित समीक्षा की प्रतीक्षा करें
• मैन्युअल रूप से समीक्षा ट्रिगर करने के लिए किसी मौजूदा पुल रिक्वेस्ट पर @gemini-cli /review टिप्पणी करें

Issue Triage:

• एक इश्यू खोलें और स्वचालित ट्रायेज की प्रतीक्षा करें
• मैन्युअल रूप से ट्रायेजिंग ट्रिगर करने के लिए मौजूदा इश्यू पर @gemini-cli /triage टिप्पणी करें

सामान्य AI सहायता:

• किसी भी इश्यू या पुल रिक्वेस्ट में, अपने अनुरोध के बाद @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 वर्कफ़्लो दस्तावेज़ीकरण पर जाएं।

Issue Triage

इस क्रिया का उपयोग GitHub इश्यू को स्वचालित रूप से या एक शेड्यूल पर ट्रायेज करने के लिए किया जा सकता है। इश्यू ट्रायेज सिस्टम सेट करने के विस्तृत गाइड के लिए, GitHub Issue Triage वर्कफ़्लो दस्तावेज़ीकरण पर जाएं।

Pull Request Review

इस क्रिया का उपयोग पुल रिक्वेस्ट खोले जाने पर स्वचालित रूप से समीक्षा करने के लिए किया जा सकता है। पुल रिक्वेस्ट समीक्षा प्रणाली सेट करने के विस्तृत गाइड के लिए, GitHub PR Review वर्कफ़्लो दस्तावेज़ीकरण पर जाएं।

Gemini CLI Assistant

इस प्रकार की क्रिया का उपयोग पुल रिक्वेस्ट और इश्यू के भीतर एक सामान्य-उद्देश्यीय, संवादात्मक Gemini AI सहायक को आमंत्रित करने के लिए किया जा सकता है ताकि विभिन्न प्रकार के कार्य किए जा सकें। सामान्य-उद्देश्यीय Gemini CLI वर्कफ़्लो सेट करने के विस्तृत गाइड के लिए, Gemini Assistant वर्कफ़्लो दस्तावेज़ीकरण पर जाएं।

कॉन्फ़िगरेशन

इनपुट

• gcp_location: (वैकल्पिक) Google Cloud स्थान।

• gcp_project_id: (वैकल्पिक) Google Cloud प्रोजेक्ट ID।

• gcp_service_account: (वैकल्पिक) Google Cloud सेवा खाता ईमेल।

• gcp_workload_identity_provider: (वैकल्पिक) Google Cloud Workload Identity प्रदाता।

• 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: (वैकल्पिक) Gemini API के लिए API कुंजी।