run-gemini-cli

Übersicht

run-gemini-cli ist eine GitHub Action, die [Gemini] über die [Gemini CLI] in deinen Entwicklungsworkflow integriert. Sie fungiert sowohl als autonomer Agent für kritische routinemäßige Programmieraufgaben als auch als bedarfsorientierter Mitarbeiter, dem du schnell Aufgaben delegieren kannst.

Verwende sie, um GitHub-Pull-Request-Reviews durchzuführen, Issues zu kategorisieren, Code-Analysen und -Modifikationen vorzunehmen und vieles mehr – und das alles im Gespräch mit [Gemini] (z. B. @gemini-cli behebe dieses Problem) direkt in deinen GitHub-Repositorys.

• run-gemini-cli
  • Übersicht
  • Funktionen
  • Schnellstart
    • 1. Hol dir einen Gemini-API-Schlüssel
    • 2. Füge ihn als GitHub-Secret hinzu
    • 3. Aktualisiere deine .gitignore
    • 4. Wähle einen Workflow
    • 5. Probier es aus!
  • Workflows
    • Gemini Dispatch
    • Issue Triage
    • Pull-Request-Review
    • Gemini CLI Assistant
  • Konfiguration
    • Eingaben
    • Ausgaben
    • Repository-Variablen
    • Secrets
  • Authentifizierung
    • Google-Authentifizierung
    • GitHub-Authentifizierung
  • Observability
  • Erweiterungen
  • Best Practices
  • Anpassung
  • Mitwirken

Funktionen

• Automatisierung: Workflows durch Ereignisse (z. B. Öffnen eines Issues) oder Zeitpläne (z. B. nächtlich) auslösen.
• Bedarfsorientierte Zusammenarbeit: Workflows in Issue- und Pull-Request-Kommentaren durch Erwähnung der [Gemini CLI] auslösen (z. B. @gemini-cli /review).
• Erweiterbar mit Tools: Die Tool-Aufruffähigkeiten der [Gemini]-Modelle nutzen, um mit anderen CLIs wie der [GitHub CLI] (gh) zu interagieren.
• Anpassbar: Verwende eine GEMINI.md-Datei in deinem Repository, um projektspezifische Anweisungen und Kontext für die [Gemini CLI] bereitzustellen.

Schnellstart

Starte in nur wenigen Minuten mit der Gemini CLI in deinem Repository:

1. Hol dir einen Gemini-API-Schlüssel

Hole deinen API-Schlüssel von [Google AI Studio] mit großzügigen kostenlosen Kontingenten.

2. Füge ihn als GitHub-Secret hinzu

Speichere deinen API-Schlüssel als Secret mit dem Namen GEMINI_API_KEY in deinem Repository:

• Gehe zu Einstellungen > Secrets und Variablen > Aktionen deines Repositorys.
• Klicke auf Neues Repository-Secret.
• Name: GEMINI_API_KEY, Wert: dein API-Schlüssel.

3. Aktualisiere deine .gitignore

Füge die folgenden Einträge zu deiner .gitignore-Datei hinzu:

# gemini-cli-Einstellungen
.gemini/

# GitHub-App-Anmeldedaten
gha-creds-*.json

4. Wähle einen Workflow

Du hast zwei Möglichkeiten, einen Workflow einzurichten:

Option A: Setup-Befehl verwenden (empfohlen)

1. Starte die Gemini CLI in deinem Terminal:

   gemini
   

2. Gib in der Gemini CLI in deinem Terminal Folgendes ein:

   /setup-github
   

Option B: Workflows manuell kopieren

1. Kopiere die vorgefertigten Workflows aus dem Verzeichnis examples/workflows in das Verzeichnis .github/workflows deines Repositorys. Hinweis: Der Workflow gemini-dispatch.yml muss ebenfalls kopiert werden, da er die Ausführung der anderen Workflows auslöst.

5. Probier es aus!

Pull-Request-Review:

• Öffne einen Pull-Request in deinem Repository und warte auf die automatische Überprüfung.
• Kommentiere @gemini-cli /review in einem bestehenden Pull-Request, um eine manuelle Überprüfung auszulösen.

Issue Triage:

• Öffne ein Issue und warte auf die automatische Kategorisierung.
• Kommentiere @gemini-cli /triage in bestehenden Issues, um eine manuelle Kategorisierung auszulösen.

Allgemeine KI-Unterstützung:

• Erwähne in jedem Issue oder Pull-Request @gemini-cli, gefolgt von deiner Anfrage.
• Beispiele:
  • @gemini-cli erkläre diese Codeänderung
  • @gemini-cli schlage Verbesserungen für diese Funktion vor
  • @gemini-cli hilf mir, diesen Fehler zu debuggen
  • @gemini-cli schreibe Unit-Tests für diese Komponente

Workflows

Diese Action bietet mehrere vorgefertigte Workflows für verschiedene Anwendungsfälle. Jeder Workflow ist dafür ausgelegt, in das Verzeichnis .github/workflows deines Repositorys kopiert und nach Bedarf angepasst zu werden.

Gemini Dispatch

Dieser Workflow fungiert als zentraler Verteiler für die Gemini CLI und leitet Anfragen basierend auf dem auslösenden Ereignis und dem im Kommentar angegebenen Befehl an den entsprechenden Workflow weiter. Eine detaillierte Anleitung zur Einrichtung des Dispatch-Workflows findest du in der Dokumentation zum Gemini Dispatch-Workflow.

Issue Triage

Diese Action kann verwendet werden, um GitHub Issues automatisch oder nach einem Zeitplan zu kategorisieren. Eine detaillierte Anleitung zur Einrichtung des Issue-Triage-Systems findest du in der Dokumentation zum GitHub Issue Triage-Workflow.

Pull-Request-Review

Diese Action kann verwendet werden, um Pull-Requests automatisch zu überprüfen, wenn sie geöffnet werden. Eine detaillierte Anleitung zur Einrichtung des Pull-Request-Review-Systems findest du in der Dokumentation zum GitHub PR Review-Workflow.

Gemini CLI Assistant

Diese Art von Action kann verwendet werden, um einen allgemeinen, konversationellen Gemini-KI-Assistenten in Pull-Requests und Issues zu aktivieren, der eine Vielzahl von Aufgaben ausführen kann. Eine detaillierte Anleitung zur Einrichtung des allgemeinen Gemini CLI-Workflows findest du in der Dokumentation zum Gemini Assistant-Workflow.

Konfiguration

Eingaben

• gcp_location: (Optional) Der Google Cloud-Standort.

• gcp_project_id: (Optional) Die Google Cloud-Projekt-ID.

• gcp_service_account: (Optional) Die Google Cloud-Dienstkonto-E-Mail.

• gcp_workload_identity_provider: (Optional) Der Google Cloud Workload Identity Provider.

• gcp_token_format: (Optional, Standard: access_token) Das Token-Format für die Authentifizierung. Setze auf "access_token", um Zugriffstoken zu generieren (erfordert ein Dienstkonto), oder auf eine leere Zeichenfolge für direktes WIF. Kann "access_token" oder "id_token" sein.