Revisión de código
Pide una revisión rápida con /review o una a fondo que verifica cada hallazgo, y arregla lo encontrado en un paso.
NoBreiniers revisa tus cambios de dos formas: una revisión rápida, que es la de siempre, y una a fondo, que intenta refutar cada hallazgo antes de mostrártelo.
Revisión rápida
- En el compositor escribe
/reviewy envía. También sirve decirlo con tus palabras: «revisa mis cambios». - El agente del chat revisa tu trabajo en la rama desde el lugar donde empezó (la app lo encuentra sola y dice en una nota cómo lo hizo) y te contesta en el chat. Si no puede saber dónde empezó la rama, revisa los cambios sin confirmar y lo dice. No toca nada.
| Escribes | Qué revisa |
|---|---|
/review | Tu trabajo en esta rama desde que empezó, confirmado o no. |
/review uncommitted | Solo los cambios sin confirmar de esta carpeta. |
/review main | Los cambios desde esa rama o versión. |
/review 12 | La solicitud de cambios número 12. |
El botón «Revisar» del panel «Cambios» hace lo mismo.
Revisión a fondo
- Escribe
/review deep, o/review a fondo. Admite lo mismo después:/review a fondo main,/review a fondo 12. - Bajo el chat aparece la barra «Revisión de código» con lo que va pasando: «Revisando», luego «Verificando … candidatos».
- Al terminar ves los hallazgos verificados, ordenados por gravedad.
Qué hace distinto:
- Varios revisores miran el cambio a la vez, cada uno con un foco: errores, seguridad y las reglas de tu proyecto.
- Un segundo paso intenta refutar cada candidato: lo reproduce ejecutando código, o lo sigue en el código y cita las líneas. Si no puede, lo descarta.
- Solo ves lo verificado. Lo demás queda contado como «… descartados».
Cada hallazgo dice:
| Dato | Valores |
|---|---|
| Gravedad | «Importante», «Menor» o «Previo» (ya estaba antes de tu cambio) |
| Confianza | «confianza alta», «confianza media» o «confianza baja» |
| Cómo se verificó | «Reproducido ejecutando código» o «Seguido leyendo el código» |
Arreglar los hallazgos en un paso
En la barra «Revisión de código»:
| Botón | Qué hace |
|---|---|
| «Ver los hallazgos» | Abre o cierra la lista. |
| «Arreglar los hallazgos importantes» | Arregla solo los importantes. Los cambios quedan sin confirmar, para que los mires. |
| «Publicar los hallazgos en el PR» | Los deja como comentarios en la solicitud de cambios. |
| «Más opciones de la revisión» | «Arreglar todos los hallazgos», «Arreglar y empujar a la rama del PR» o «Arreglar en una rama nueva con su propio PR». |
| «Detener la revisión» | La corta. |
Antes de arreglar, la app te pide aprobación y te dice exactamente qué hará. Después, cada hallazgo queda en uno de tres estados:
- «Arreglado: su comprobación pasa»: la comprobación del hallazgo fallaba antes del arreglo y pasa después.
- «Cambiado, sin comprobar»: se cambió, pero el hallazgo no tenía una comprobación que lo pruebe.
- «Sin arreglar».
Ajustar la revisión de un proyecto
Crea el archivo .nobreiniers/review.yaml en tu repositorio:
| Clave | Para qué sirve |
|---|---|
effort | Qué tan ancha es la revisión: low usa un solo revisor; high añade uno que mira quién llama al código cambiado. |
rules | Más archivos de reglas que la revisión debe hacer cumplir, por ejemplo docs/review.md. |
paths | include y exclude: qué carpetas se revisan. |
auto | open y update: revisar una solicitud de cambios sola cuando se abre o cuando recibe cambios. |
min_score | Desde qué puntuación se muestra un hallazgo. |
test | El comando que se corre después de arreglar, para detectar un arreglo falso. |
