OpenCode GitHub

OpenCode se puede integrar profundamente con los flujos de trabajo de GitHub, permitiendo que la IA participe directamente en los procesos de Issue, Pull Request y revisión de código.

Al escribir /opencode o /oc en un comentario, se puede activar la IA para que ejecute tareas automáticamente.

OpenCode GitHub = convierte la IA en tu miembro de desarrollo automatizado, participando directamente en los flujos de Issue, PR y código.

1. Capacidades principales

  • Análisis de Issue:Comprender automáticamente el problema y dar una explicación
  • Reparación automática:Crear una rama y enviar un PR
  • Revisión de código:Analizar el PR y sugerir mejoras
  • Ejecución automatizada:Se ejecuta basado en GitHub Actions

Características:

  • Se ejecuta en tu propio GitHub Runner
  • Seguro y controlable, no depende de servidores externos para ejecutar código

2. Instalación rápida (recomendada)

Ejecuta en el directorio raíz del proyecto GitHub:

opencode github install

Este comando completará automáticamente:

  • Instalar GitHub App
  • Crear flujo de trabajo de GitHub Actions
  • Guiar la configuración de la API Key

3. Instalación manual (avanzado)

1. Instalar GitHub App

Visita:

https://github.com/apps/opencode-agent

Instalar en tu repositorio

2. Agregar archivo de flujo de trabajo

Crear archivo:

.github/workflows/opencode.yml

Ejemplo:

name: opencode

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  opencode:
    if: |
      contains(github.event.comment.body, '/oc') ||
      contains(github.event.comment.body, '/opencode')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v6
        with:
          fetch-depth: 1
          persist-credentials: false

      - name: Run OpenCode
        uses: anomalyco/opencode/github@latest
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        with:
          model: anthropic/claude-sonnet-4-20250514

3. Configurar Secrets

En el repositorio de GitHub:

  • Ir a Settings → Secrets → Actions
  • Agregar API Key (por ejemplo, ANTHROPIC_API_KEY)

4. Explicación de parámetros de configuración

Parámetro Descripción
model Modelo utilizado (obligatorio)
agent Especificar proxy
prompt Prompt personalizado
share Si compartir la sesión
token GitHub Token

Nota:

  • Por defecto se usa el Token de la OpenCode GitHub App
  • También se puede usar GITHUB_TOKEN o PAT

5. Eventos de activación compatibles

Evento Descripción
issue_comment Comentario activa /opencode
pull_request_review_comment Comentario en línea de código activa
issues Creación/actualización de Issue
pull_request Revisión automática de PR
schedule Tarea programada
workflow_dispatch Activación manual

6. Usos comunes

1. Explicar Issue

Comenta en el Issue:

/opencode explain this issue

La IA resumirá el problema y lo explicará

2. Reparar automáticamente Issue

/opencode fix this

Automáticamente:

  • Crear rama
  • Modificar código
  • Enviar Pull Request

3. Modificar PR

Delete the attachment from S3 when the note is removed /oc

Realizar modificaciones directamente en el PR

4. Operaciones a nivel de línea de código (muy potente)

Comenta en la página Files del PR:

/oc add error handling here

OpenCode obtendrá automáticamente:

  • Ruta del archivo
  • Número de línea
  • Diff de contexto

No es necesario indicar la ubicación manualmente

7. Tareas programadas (automatización)

Ejemplo: escanear TODO semanalmente

on:
  schedule:
    - cron: "0 9 * * 1"

Ejemplo de prompt:

Review the codebase for TODO comments and summarize them

Nota:

  • Las tareas programadas deben proporcionar un prompt
  • Se requieren permisos de escritura (contents / pull-requests)

8. Revisión automática de PR

Ejemplo:

on:
  pull_request:
    types: [opened, synchronize]

Comportamiento predeterminado:

  • Analizar la calidad del código
  • Detectar posibles errores (bugs)
  • Sugerir mejoras

9. Clasificación automática de Issue

Puede procesar automáticamente nuevos Issues, por ejemplo:

  • Filtrar cuentas spam
  • Sugerir respuestas automáticas
  • Complementar documentación

Nota:

  • El evento de issues debe proporcionar un prompt

10. Prompts personalizados (uso avanzado)

Puede sobrescribir el comportamiento predeterminado:

prompt: |
  Review this pull request:
  - Check for bugs
  - Suggest improvements

Se usa para:

  • Unificar estándares de código
  • Personalizar criterios de revisión
  • Automatizar flujos de equipo

11. Seguridad y permisos

Configuración de permisos recomendada:

permissions:
  id-token: write
  contents: write
  pull-requests: write
  issues: write

Nota:

  • Principio de mínimo privilegio
  • Solo abrir las capacidades necesarias
Otras extensiones