Descarga gratis

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.

Actualizado el · versión 2.0.145 · Markdown

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

  1. En el compositor escribe /review y envía. También sirve decirlo con tus palabras: «revisa mis cambios».
  2. 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.
EscribesQué revisa
/reviewTu trabajo en esta rama desde que empezó, confirmado o no.
/review uncommittedSolo los cambios sin confirmar de esta carpeta.
/review mainLos cambios desde esa rama o versión.
/review 12La solicitud de cambios número 12.

El botón «Revisar» del panel «Cambios» hace lo mismo.

Revisión a fondo

  1. Escribe /review deep, o /review a fondo. Admite lo mismo después: /review a fondo main, /review a fondo 12.
  2. Bajo el chat aparece la barra «Revisión de código» con lo que va pasando: «Revisando», luego «Verificando … candidatos».
  3. 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:

DatoValores
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ónQué 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:

ClavePara qué sirve
effortQué tan ancha es la revisión: low usa un solo revisor; high añade uno que mira quién llama al código cambiado.
rulesMás archivos de reglas que la revisión debe hacer cumplir, por ejemplo docs/review.md.
pathsinclude y exclude: qué carpetas se revisan.
autoopen y update: revisar una solicitud de cambios sola cuando se abre o cuando recibe cambios.
min_scoreDesde qué puntuación se muestra un hallazgo.
testEl comando que se corre después de arreglar, para detectar un arreglo falso.