Gemini CLI GitHub Actions es una herramienta gratuita de Google que integra inteligencia artificial en los flujos de trabajo de GitHub. Esta guía cubre desde conceptos básicos hasta implementaciones avanzadas para desarrolladores de todos los niveles, optimizando tareas como revisión de código y clasificación de problemas.

¿Qué es Gemini CLI GitHub Actions?

Gemini CLI GitHub Actions es una integración que utiliza la tecnología de Google para incorporar inteligencia artificial directamente en los flujos de trabajo de GitHub. Esta herramienta gratuita permite automatizar tareas repetitivas como revisión de código, clasificación de problemas y colaboración asistida por IA en repositorios.

Conceptos básicos de Gemini CLI

Instalación y configuración

# Opción 1: Usando npm
npm install -g @google/generative-ai
# Opción 2: Usando GitHub cli
gh extension install google/gh-gemini
# Verificar instalación
gemini --version

Casos de uso prácticos

name: Clasificación automática de issues
on:
  issues:
    types: [opened]
jobs:
  classify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: google-github-actions/run-gemini-cli@v1
        with:
          gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
          prompt: |
            Analiza este issue y sugiere etiquetas apropiadas.
            Las etiquetas disponibles son: bug, enhancement, question, documentation.
            Responde solo con las etiquetas separadas por comas.
          issue_number: ${{ github.event.issue.number }}

name: Revisión de código con IA
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: google-github-actions/run-gemini-cli@v1
        with:
          gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
          prompt: |
            Revisa este pull request considerando:
            1. Posibles bugs o problemas lógicos
            2. Mejoras en el rendimiento
            3. Cumplimiento de las convenciones del proyecto
            4. Seguridad
            Proporciona comentarios constructivos.
          pr_number: ${{ github.event.pull_request.number }}

name: Generar documentación
on:
  push:
    paths:
      - 'src/components/**'
jobs:
  generate-docs:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: google-github-actions/run-gemini-cli@v1
        with:
          gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
          prompt: |
            Genera documentación técnica en formato Markdown para los componentes modificados.
            Incluye:
            - Descripción del componente
            - Props y su tipado
            - Ejemplos de uso
            - Consideraciones de accesibilidad
            Guarda la documentación en docs/components/
          context: |
            Tecnología: React con TypeScript
            Estándares: Seguir convenciones de JSDoc

Personalización avanzada

Configuración de contexto del proyecto

Crea un archivo GEMINI.md en la raíz de tu repositorio para proporcionar contexto específico:

# Contexto del Proyecto para Gemini CLI
## Tecnologías Principales
- Frontend: React 18 con TypeScript
- Backend: Node.js con Express
- Base de datos: PostgreSQL
- Testing: Jest y React Testing Library
## Convenciones de Código
- Usar ESLint con configuración de Airbnb
- Nomenclatura: camelCase para variables, PascalCase para componentes
- Formato: Prettier con configuración estándar del proyecto
## Reglas Específicas
- Priorizar rendimiento sobre brevedad
- Siempre incluir manejo de errores
- Documentar funciones complejas con JSDoc
- Usar componentes funcionales y hooks

Integración con herramientas existentes

- name: Notificar a Slack
  uses: 8398a7/action-slack@v3
  with:
    status: ${{ job.status }}
    fields: repo,message,commit,author,action,eventName,ref,workflow
    text: 'Gemini ha procesado un nuevo issue: ${{ github.event.issue.title }}'

- name: Crear ticket en Jira
  uses: atlassian/gajira-create@v1
  with:
    project: PROJ
    issuetype: Bug
    summary: ${{ github.event.issue.title }}
    description: ${{ github.event.issue.body }}
    fields: |
      {
        "priority": {"name": "High"},
        "labels": ["automated", "gemini"]
      }

Seguridad y mejores prácticas

Técnicas avanzadas para expertos

Optimización de rendimiento

- name: Cache Gemini responses
  uses: actions/cache@v3
  with:
    path: ~/.gemini-cache
    key: ${{ runner.os }}-gemini-${{ hashFiles('**/*.js') }}
    restore-keys: |
      ${{ runner.os }}-gemini-
      ${{ runner.os }}-

jobs:
  analyze:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        task: [security, performance, documentation]
    steps:
      - name: Análisis con Gemini
        uses: google-github-actions/run-gemini-cli@v1
        with:
          gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
          prompt: |
            Realiza un análisis de ${{ matrix.task }} para este código.
            Proporciona recomendaciones específicas y accionables.

Integración con modelos personalizados

Para empresas con modelos ajustados (fine-tuned):

- uses: google-github-actions/run-gemini-cli@v1
  with:
    gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
    model: projects/your-project/locations/your-location/models/your-model-id
    prompt: |
      Analiza este código usando nuestro modelo especializado en seguridad financiera.
      Identifica posibles vulnerabilidades específicas del sector.

Flujos de trabajo condicional complejos

name: Análisis inteligente de PRs
on:
  pull_request:
    types: [opened, synchronize]
    branches: [main, develop]
jobs:
  analyze:
    runs-on: ubuntu-latest
    if: ${{ !contains(github.event.pull_request.title, '[WIP]') }}

    steps:
      - name: Determinar tipo de análisis
        id: analysis_type
        run: |
          if [[ "${{ github.event.pull_request.additions }}" -gt 500 ]]; then
            echo "type=deep" >> $GITHUB_OUTPUT
          else
            echo "type=standard" >> $GITHUB_OUTPUT
          fi

      - name: Análisis con Gemini
        uses: google-github-actions/run-gemini-cli@v1
        with:
          gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
          prompt: |
            Realiza un análisis ${{ steps.analysis_type.outputs.type }} de este PR.
            Considera:
            - Complejidad ciclomática
            - Patrones de diseño
            - Posibles bugs
            - Rendimiento
            - Seguridad
            Proporciona comentarios detallados y sugerencias.

Solución de problemas comunes

Herramientas de depuración

# Habilitar modo de depuración
- uses: google-github-actions/run-gemini-cli@v1
  with:
    gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
    debug: true
    log_level: debug

Recursos adicionales