# Instrucciones para el agente: Open Code Review: revisa cambios de Git con contexto del proyecto

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/alibaba/open-code-review (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/alibaba-open-code-review

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: prepara la instalación

Comprueba Git 2.41 o posterior y Node.js ≥14 y npm para este método, según [package.json](https://github.com/alibaba/open-code-review/blob/main/package.json). Lee el [README](https://github.com/alibaba/open-code-review/blob/375f64cd6f67a48a135da83cfcf59c52669a09cb/README.md#how-to-use) y las opciones de tu plataforma. La instalación de npm documentada es:

```bash
npm install -g @alibaba-group/open-code-review
```

### Paso 2: configura el modelo

En el modo normal, sigue el asistente oficial:

```bash
ocr config provider
ocr config model
```

Introduce la clave directamente en la configuración privada de la herramienta. El asistente prueba conectividad. Antes de revisar un repositorio privado, comprueba a qué dirección de la API se enviará el código y el coste del modelo elegido.

### Paso 3: revisa los cambios locales

Entra en el repositorio que quieras evaluar y ejecuta:

```bash
ocr review
```

Según el README, este modo incluye cambios preparados, sin preparar y archivos sin seguimiento. Comprueba por tanto el conjunto de archivos antes de ejecutarlo. Para exportar los hallazgos, el README ofrece:

```bash
ocr review --format json --output result.json
```

No hace falta ejecutar ambos ejemplos: el segundo añade exportación a la revisión.

### Paso 4: usa una comparación de ramas cuando corresponda

El ejemplo oficial es:

```bash
ocr review --from main --to feature-branch
```

Sustituye los nombres por ramas que existan en tu repositorio. El modo compara los cambios desde el ancestro común, no exige que la rama de destino se llame feature-branch.

## Comprobación

Confirma que se revisó el conjunto de cambios esperado. Abre las ubicaciones de cada hallazgo y verifica si el problema se reproduce. Revisa errores de proveedor o archivos omitidos antes de interpretar una salida vacía como falta de incidencias. Una ejecución local no modifica por sí sola las reglas de protección de ramas.

## Si algo falla

Repite la configuración interactiva si falla conectividad y comprueba Git y los nombres de rama. Para una revisión interrumpida, el README ofrece ocr session list y las opciones --resume del mismo modo de revisión. Sigue su sintaxis exacta desde la documentación; no reutilices un identificador de sesión de otro repositorio.