run-gemini-cli

Aperçu

run-gemini-cli est une action GitHub qui intègre [Gemini] dans votre flux de développement via le [Gemini CLI]. Elle agit à la fois comme un agent autonome pour les tâches de codage critiques et récurrentes, et comme un collaborateur à la demande auquel vous pouvez rapidement déléguer du travail.

Utilisez-la pour effectuer des revues de pull request GitHub, trier les issues, réaliser des analyses et modifications de code, et plus encore en utilisant [Gemini] de manière conversationnelle (par exemple, @gemini-cli fix this issue) directement dans vos dépôts GitHub.

• run-gemini-cli
  • Aperçu
  • Fonctionnalités
  • Démarrage rapide
    • 1. Obtenir une clé API Gemini
    • 2. L'ajouter en tant que secret GitHub
    • 3. Mettre à jour votre .gitignore
    • 4. Choisir un workflow
    • 5. Essayez-le !
  • Workflows
    • Gemini Dispatch
    • Tri d'issues
    • Revue de Pull Request
    • Assistant Gemini CLI
  • Configuration
    • Entrées
    • Sorties
    • Variables de dépôt
    • Secrets
  • Authentification
    • Authentification Google
    • Authentification GitHub
  • Observabilité
  • Extensions
  • Bonnes pratiques
  • Personnalisation
  • Contribuer

Fonctionnalités

• Automatisation : Déclencher des workflows en fonction d'événements (par ex. ouverture d'une issue) ou de plannings (par ex. nocturne).
• Collaboration à la demande : Déclencher des workflows dans les commentaires d'issues et de pull requests en mentionnant le [Gemini CLI] (par ex., @gemini-cli /review).
• Extensible avec des outils : Exploiter les capacités d'appel d'outils des modèles [Gemini] pour interagir avec d'autres CLI comme le [GitHub CLI] (gh).
• Personnalisable : Utiliser un fichier GEMINI.md dans votre dépôt pour fournir des instructions et un contexte spécifiques au projet au [Gemini CLI].

Démarrage rapide

Commencez à utiliser Gemini CLI dans votre dépôt en quelques minutes :

1. Obtenir une clé API Gemini

Obtenez votre clé API depuis [Google AI Studio] avec des quotas généreux gratuits

2. L'ajouter en tant que secret GitHub

Stockez votre clé API en tant que secret nommé GEMINI_API_KEY dans votre dépôt :

• Allez dans Settings > Secrets and variables > Actions de votre dépôt
• Cliquez sur New repository secret
• Nom : GEMINI_API_KEY, Valeur : votre clé API

3. Mettre à jour votre .gitignore

Ajoutez les entrées suivantes à votre fichier .gitignore :

# gemini-cli settings
.gemini/

# GitHub App credentials
gha-creds-*.json

4. Choisir un workflow

Vous avez deux options pour configurer un workflow :

Option A : Utiliser la commande de configuration (Recommandé)

1. Lancez le Gemini CLI dans votre terminal :

   gemini
   

2. Dans le Gemini CLI dans votre terminal, tapez :

   /setup-github
   

Option B : Copier manuellement les workflows

1. Copiez les workflows préconstruits du répertoire examples/workflows vers le répertoire .github/workflows de votre dépôt. Remarque : le workflow gemini-dispatch.yml doit également être copié, car il déclenche l'exécution des workflows.

5. Essayez-le !

Revue de Pull Request :

• Ouvrez une pull request dans votre dépôt et attendez la revue automatique
• Commentez @gemini-cli /review sur une pull request existante pour déclencher manuellement une revue

Tri d'issues :

• Ouvrez une issue et attendez le tri automatique
• Commentez @gemini-cli /triage sur des issues existantes pour déclencher manuellement le tri

Assistance IA générale :

• Dans toute issue ou pull request, mentionnez @gemini-cli suivi de votre demande
• Exemples :
  • @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

Workflows

Cette action fournit plusieurs workflows préconstruits pour différents cas d'utilisation. Chaque workflow est conçu pour être copié dans le répertoire .github/workflows de votre dépôt et personnalisé selon les besoins.

Gemini Dispatch

Ce workflow agit comme un répartiteur central pour Gemini CLI, en aiguillant les requêtes vers le workflow approprié en fonction de l'événement déclencheur et de la commande fournie dans le commentaire. Pour un guide détaillé sur la configuration du workflow de répartition, consultez la documentation du workflow Gemini Dispatch.

Tri d'issues

Cette action peut être utilisée pour trier automatiquement les issues GitHub ou selon un planning. Pour un guide détaillé sur la configuration du système de tri des issues, consultez la documentation du workflow de tri d'issues GitHub.

Revue de Pull Request

Cette action peut être utilisée pour examiner automatiquement les pull requests lorsqu'elles sont ouvertes. Pour un guide détaillé sur la configuration du système de revue des pull requests, consultez la documentation du workflow de revue de PR GitHub.

Assistant Gemini CLI

Ce type d'action peut être utilisé pour invoquer un assistant IA Gemini conversationnel et polyvalent dans les pull requests et les issues afin d'effectuer un large éventail de tâches. Pour un guide détaillé sur la configuration du workflow Gemini CLI généraliste, consultez la documentation du workflow Assistant Gemini.

Configuration

Entrées

• gcp_location: (Optionnel) L'emplacement Google Cloud.

• gcp_project_id: (Optionnel) L'ID du projet Google Cloud.

• gcp_service_account: (Optionnel) L'email du compte de service Google Cloud.

• gcp_workload_identity_provider: (Optionnel) Le fournisseur d'identité de charge de travail Google Cloud.

• gcp_token_format: (Optionnel, défaut : access_token) Le format du jeton pour l'authentification. Définissez sur "access_token" pour générer des jetons d'accès (nécessite un compte de service), ou sur une chaîne vide pour une fédération d'identité directe. Peut être "access_token" ou "id_token".