Saltar al contenido principal
Version: Next 🚀

Revisar un pull request

El agente puede evaluar un pull request que ya está abierto en Bitbucket, sin modificarlo. Sirve como segunda opinión antes de que una persona lo apruebe.

Cómo pedir la revisión​

Menciona al agente en el elemento de trabajo con una instrucción como «revisa este PR» o «valida este pull request». El agente encuentra el pull request:

  • Por el enlace del elemento de trabajo.
  • Por un pull request abierto en Bitbucket que cita la clave del elemento de trabajo.
  • Por la URL que pegues en el comentario, también la que copia Jira desde el panel Development.

Si el pull request está cerrado o no lo encuentra, el agente pide la URL.

Qué revisa​

La revisión se hace en solo lectura:

PasoQué hace
DiffCompara el pull request contra su rama de destino.
TestsEjecuta los tests del repositorio.
forge lintSi es una app Forge, ejecuta forge lint.
Revisión de ForgeRevisa el cambio con las prácticas oficiales de Forge.
Revisión de seguridadSe añade cuando el cambio toca permisos, red, autenticación o almacenamiento.

El agente no hace commit, no hace push y no abre otro pull request.

Veredicto​

La respuesta del agente indica:

  • Si el pull request responde a lo que pide el elemento de trabajo.
  • Qué está mal y en qué archivo.
  • El resultado de los tests y de forge lint.

Cuando hay hallazgos, la respuesta incluye una tabla con la severidad, el hallazgo, la ubicación (archivo y líneas) y la corrección propuesta. Si la revisión encuentra bloqueos, el veredicto lo indica: el pull request no está listo para aprobarse.

Ejemplo de veredicto:

Veredicto: cambios necesarios. El pull request cubre dos de los tres criterios de aceptación; falta validar el campo de correo.

SeveridadArchivoHallazgo
Bloqueantesrc/resolvers/index.jsLa resolución no comprueba que el usuario tenga permiso sobre el elemento de trabajo.
Bloqueantemanifest.ymlforge lint falla: falta el scope que usa la nueva llamada.
Menorsrc/frontend/Form.jsxEl mensaje de error no está traducido.

Tests: 24 pasan, 1 falla (form.test.js). forge lint: falla.

Si mencionaste al agente, el veredicto queda como comentario en el elemento de trabajo.

Comentario del agente con el veredicto de la revisión de un pull request

Después de la revisión​

El pull request queda como estaba. La persona que lo revisa decide qué corregir. Si el pull request es del agente, puedes pedirle los ajustes con otra mención: continúa en la misma rama y pasa los controles antes de publicar.