AI CodeOps

Agente Reviewer

El agente Reviewer comprueba la corrección, los casos límite y la mantenibilidad de los cambios propuestos, y enumera correcciones concretas. Se ejecuta en ocho flujos de trabajo integrados.

El agente Reviewer es el segundo par de ojos crítico. Lee el cambio propuesto y busca problemas de corrección, claridad, casos límite y mantenibilidad. Enumera problemas concretos y una corrección concreta para cada uno.

Dónde se ejecuta

Flujo de trabajoPaso
Plan, Build, Review & TestReview
Parallel ReviewCorrectness review
UI ImplementationCode review
Architecture DebateCritic review
Swarm InspectionReviewer slice
Release ReadinessCorrectness review
Data MigrationFinal review
Quality-Gated ChangeReview

En Architecture Debate hace de crítico: cuestiona los dos diseños rivales del Architect antes de la síntesis final.

Cuándo se ejecuta su paso depende del flujo de trabajo:

  • Después de escribir el código. En Plan, Build, Review & Test, UI Implementation, Data Migration y Quality-Gated Change, su paso sigue al paso que implementa el cambio. Así que espera a que el código esté escrito y las pruebas del proyecto se hayan ejecutado, y revisa ese cambio.
  • Antes de la pasada de código. Parallel Review, Swarm Inspection y Release Readiness no tienen paso de implementación. Todos sus pasos se ejecutan antes de que se escriba ningún código, y el Reviewer trabaja a partir de la tarea y del código que ya está en el repositorio.
  • Sin código. Architecture Debate termina con sus documentos.

Entradas

  • La tarea de la sesión y una instantánea de solo lectura de los archivos relevantes del repositorio del proyecto.
  • Los pasos anteriores: normalmente un plan y la descripción del cambio del Builder.
  • Cuando se ejecuta después de escribir el código: el cambio como diff, recortado para que quepa y con el recorte marcado cuando es largo, y el resultado de pruebas registrado. Se le indica que cite los archivos que leyó.
  • Herramientas de los servidores MCP conectados, si la política de tu espacio de trabajo las permite.

Salidas

El paso del Reviewer devuelve una lista de problemas con sus correcciones, en texto. Influye en el resto de la sesión de dos formas:

  • Los pasos posteriores lo leen. Cuando se ejecuta antes de la pasada de código, la pasada de código también lo lee y puede actuar en consecuencia. Cuando se ejecuta después de escribir el código, nada en la sesión reescribe el cambio a partir de él: actúa sobre sus observaciones con un seguimiento.
  • Después de los pasos del flujo de trabajo, la sesión ejecuta una pasada de hallazgos que revisa el diff real y registra hallazgos estructurados, cada uno con un título, una gravedad, una categoría, una recomendación y, cuando procede, el archivo. El análisis del Reviewer se le da a esa pasada como contexto. Cuando en la sesión no se ha ejecutado ningún Security Auditor, los hallazgos se atribuyen al Reviewer.

Esos hallazgos aparecen en la sesión y en las páginas de calidad del espacio de trabajo, y el control de publicación los comprueba antes de que un cambio se pueda entregar. Si la revisión de hallazgos no llega a ejecutarse, el control retiene el cambio en lugar de tomar el silencio como un control superado.

Con el nivel Auto, los pasos del Reviewer van primero al nivel Premium.

Ejemplo de ejecución

Ejemplo ilustrativo, no una sesión registrada. En Quality-Gated Change, la sesión escribe una nueva exportación CSV de facturas y las pruebas del proyecto se ejecutan sobre ella. Después, el Reviewer lee el diff y señala tres cosas en el archivo de exportación: los importes se formatean con la configuración regional del servidor, así que una coma como separador decimal rompe el archivo; los nombres de los clientes no se escapan, así que un nombre con una coma desplaza todas las columnas; y la exportación carga todas las facturas en memoria. Propone un formato numérico fijo, un entrecomillado correcto y una respuesta en streaming. Después, la pasada de hallazgos revisa el mismo diff con esas notas como contexto, y una sesión de seguimiento hace las correcciones.

Límites

  • Después de escribir el código lee el diff, y un diff largo se recorta para que quepa, con el recorte marcado. La pasada de hallazgos también lee el diff: lee sus hallazgos, no solo el paso del Reviewer.
  • Su paso no cambia el código. Una corrección que proponga después de escribir el código necesita una sesión de seguimiento, o Fix en un hallazgo.
  • No ejecuta el código. El comportamiento lo comprueban las pruebas del proyecto en el paso verify (verificación), y el Tester lee el resultado.
  • Puede equivocarse en ambos sentidos: puede pasar por alto un error real y señalar algo que no es un problema. Los hallazgos se pueden pasar por triaje en la sesión.

Preguntas frecuentes

¿El agente Reviewer ve el diff final?

En cuatro de sus ocho flujos de trabajo, sí. Cuando su paso sigue al paso que implementa el cambio, se ejecuta después de que el código se haya escrito y probado, y se le muestra el diff y el resultado de pruebas registrado. Después, la pasada de hallazgos de la sesión revisa el mismo diff y registra los hallazgos que condicionan el paso del cambio por el control.

¿Pueden los hallazgos de revisión bloquear una fusión?

Sí. Los hallazgos de la revisión del diff se registran en la sesión, y el control de publicación comprueba esa revisión antes de que el cambio se pueda entregar.