run-gemini-cli

Panoramica

run-gemini-cli è una GitHub Action che integra [Gemini] nel tuo flusso di sviluppo tramite la [Gemini CLI]. Funge sia da agente autonomo per attività di codifica di routine critiche, sia da collaboratore su richiesta a cui puoi delegare rapidamente del lavoro.

Usalo per eseguire revisioni delle pull request su GitHub, triage degli issue, analisi e modifica del codice e altro ancora utilizzando [Gemini] in modo conversazionale (ad es., @gemini-cli risolvi questo problema) direttamente all'interno dei tuoi repository GitHub.

• run-gemini-cli
  • Panoramica
  • Funzionalità
  • Guida rapida
    • 1. Ottieni una chiave API Gemini
    • 2. Aggiungila come Segreto GitHub
    • 3. Aggiorna il tuo .gitignore
    • 4. Scegli un Flusso di Lavoro
    • 5. Provalo!
  • Flussi di Lavoro
    • Gemini Dispatch
    • Triage degli Issue
    • Revisione delle Pull Request
    • Assistente Gemini CLI
  • Configurazione
    • Input
    • Output
    • Variabili del Repository
    • Segreti
  • Autenticazione
    • Autenticazione Google
    • Autenticazione GitHub
  • Osservabilità
  • Estensioni
  • Buone Pratiche
  • Personalizzazione
  • Contribuire

Funzionalità

• Automazione: Attiva flussi di lavoro basati su eventi (es. apertura di un issue) o su pianificazioni (es. notturno).
• Collaborazione su richiesta: Attiva flussi di lavoro in issue e commenti delle pull request menzionando la [Gemini CLI] (es., @gemini-cli /review).
• Estendibile con Strumenti: Sfrutta le capacità di chiamata agli strumenti dei modelli [Gemini] per interagire con altre CLI come la [GitHub CLI] (gh).
• Personalizzabile: Usa un file GEMINI.md nel tuo repository per fornire istruzioni e contesto specifici del progetto alla [Gemini CLI].

Guida rapida

Inizia con la Gemini CLI nel tuo repository in pochi minuti:

1. Ottieni una chiave API Gemini

Ottieni la tua chiave API da [Google AI Studio] con generose quote gratuite

2. Aggiungila come Segreto GitHub

Salva la tua chiave API come segreto denominato GEMINI_API_KEY nel tuo repository:

• Vai a Settings > Secrets and variables > Actions del tuo repository
• Clicca su New repository secret
• Nome: GEMINI_API_KEY, Valore: la tua chiave API

3. Aggiorna il tuo .gitignore

Aggiungi le seguenti voci al tuo file .gitignore:

# impostazioni gemini-cli
.gemini/

# credenziali GitHub App
gha-creds-*.json

4. Scegli un Flusso di Lavoro

Hai due opzioni per impostare un flusso di lavoro:

Opzione A: Usa il comando di configurazione (Consigliata)

1. Avvia la Gemini CLI nel tuo terminale:

   gemini
   

2. Nella Gemini CLI nel tuo terminale, scrivi:

   /setup-github
   

Opzione B: Copia manualmente i flussi di lavoro

1. Copia i flussi di lavoro predefiniti dalla directory examples/workflows nella directory .github/workflows del tuo repository. Nota: anche il flusso di lavoro gemini-dispatch.yml deve essere copiato, poiché attiva l'esecuzione degli altri flussi di lavoro.

5. Provalo!

Revisione delle Pull Request:

• Apri una pull request nel tuo repository e attendi la revisione automatica
• Commenta @gemini-cli /review su una pull request esistente per attivare manualmente una revisione

Triage degli Issue:

• Apri un issue e attendi il triage automatico
• Commenta @gemini-cli /triage su issue esistenti per attivare manualmente il triage

Assistenza AI Generale:

• In qualsiasi issue o pull request, menziona @gemini-cli seguito dalla tua richiesta
• Esempi:
  • @gemini-cli spiega questa modifica al codice
  • @gemini-cli suggerisci miglioramenti per questa funzione
  • @gemini-cli aiutami a debuggare questo errore
  • @gemini-cli scrivi unit test per questo componente

Flussi di Lavoro

Questa azione fornisce diversi flussi di lavoro predefiniti per diversi casi d'uso. Ogni flusso di lavoro è progettato per essere copiato nella directory .github/workflows del tuo repository e personalizzato secondo necessità.

Gemini Dispatch

Questo flusso di lavoro funge da dispatcher centrale per la Gemini CLI, instradando le richieste al flusso di lavoro appropriato in base all'evento scatenante e al comando fornito nel commento. Per una guida dettagliata su come configurare il flusso di lavoro di dispatch, vai alla documentazione del flusso di lavoro Gemini Dispatch.

Triage degli Issue

Questa azione può essere utilizzata per eseguire il triage degli Issue GitHub automaticamente o secondo una pianificazione. Per una guida dettagliata su come impostare il sistema di triage degli issue, vai alla documentazione del flusso di lavoro Triage degli Issue.

Revisione delle Pull Request

Questa azione può essere utilizzata per revisionare automaticamente le pull request quando vengono aperte. Per una guida dettagliata su come impostare il sistema di revisione delle pull request, vai alla documentazione del flusso di lavoro Revisione PR.

Assistente Gemini CLI

Questo tipo di azione può essere utilizzato per invocare un assistente AI conversazionale generico di Gemini all'interno delle pull request e degli issue per svolgere un'ampia gamma di compiti. Per una guida dettagliata su come configurare il flusso di lavoro generico della Gemini CLI, vai alla documentazione del flusso di lavoro Assistente Gemini.

Configurazione

Input

• gcp_location: (Opzionale) La località di Google Cloud.

• gcp_project_id: (Opzionale) L'ID del progetto Google Cloud.

• gcp_service_account: (Opzionale) L'email dell'account di servizio Google Cloud.

• gcp_workload_identity_provider: (Opzionale) Il Provider di Identità del Carico di Lavoro Google Cloud.

• gcp_token_format: (Opzionale, default: access_token) Il formato del token per l'autenticazione. Imposta su "access_token" per generare token di accesso (richiede un account di servizio), o lascia vuoto per WIF diretto. Può essere "access_token" o "id_token".