Revisión de código

Revisiones de pull requests

El plugin Code Review muestra la descripción, los archivos modificados, los comentarios y las comprobaciones de una pull request. Úsalo para investigar posibles problemas antes de aprobarla.

La revisión de código de GitHub está disponible de forma general. La compatibilidad con las solicitudes de fusión de GitLab en Code Review está en versión preliminar. Para iniciar revisiones en la nube desde GitLab con @codex review o revisiones automáticas de solicitudes de fusión, consulta Revisa solicitudes de fusión de GitLab con Codex.

Para las revisiones iniciadas desde el repositorio, consulta la guía de integración con GitHub y la configuración del entorno de Codex Cloud (Legacy) .

La aplicación de escritorio incluye Code Review. Puedes fijarlo en la barra lateral de la aplicación desde tus plugins instalados.

Consulta una pull request

1. Abre Code Review desde la barra lateral.
2. Conecta tu cuenta del proveedor de código cuando se te solicite. Usa una cuenta con acceso al repositorio que quieras revisar.
3. Selecciona una pull request en la barra lateral o introduce su enlace en el campo de búsqueda.
4. Lee Resumen para consultar la descripción, la actividad, los comentarios y las comprobaciones. Abre Cambios para inspeccionar los archivos modificados y los comentarios junto al diff.

Encuentra revisiones que requieren atención

Usa tu bandeja de entrada personal para encontrar pull requests de GitHub en distintos repositorios. Elige Asignadas a mí para las revisiones que te hayan solicitado, Asignadas a mi equipo para las solicitudes al equipo o Creadas por mí para volver a tus propios cambios. Comprueba el estado de la revisión y luego abre la pull request para inspeccionar los comentarios y las comprobaciones.

Para volver a una revisión más tarde, selecciona la chincheta en su barra de herramientas. La solicitud de cambios aparecerá en Fijadas en la barra lateral.

Inspecciona los archivos modificados y las solicitudes de cambios relacionadas

En Cambios, selecciona Marcar como visto en un archivo después de revisarlo. Selecciona el control de nuevo para quitar la marca. Las marcas de archivos vistos se aplican a la revisión mostrada.

Para los cambios repartidos entre solicitudes de cambios dependientes, usa Pila en Resumen para abrir una solicitud de cambios relacionada e inspeccionar sus diferencias, comentarios y comprobaciones. Esta sección aparece cuando Code Review encuentra una pila de solicitudes de cambios abiertas.

Lee una revisión automática en la nube

Con el conector de ChatGPT Codex, los permisos necesarios del repositorio y las revisiones automáticas habilitadas, Codex puede revisar una solicitud de cambios de GitHub antes de que la abras. Los comentarios aparecen en GitHub y en Code Review.

La revisión en la nube no requiere que crees ni administres un entorno en la nube. Para conocer los requisitos de conexión, la configuración del repositorio y las revisiones iniciadas con @codex review, consulta Usa Codex en GitHub.

Contrasta los hallazgos de la revisión con las diferencias. Las revisiones automáticas en la nube son independientes de las revisiones que inicias en el chat de la solicitud de cambios.

Haz preguntas sobre el cambio

En el chat de la solicitud de cambios, describe el comportamiento esperado y pide a Codex que explique o investigue el cambio.

Selecciona Revisar con Codex para iniciar una revisión en un chat nuevo. Si estás viendo la solicitud de cambios junto a un chat existente, usa ese chat para preguntar sobre el cambio.

Usa las habilidades instaladas y las fuentes conectadas para proporcionar a Codex las pautas de revisión o los documentos de diseño de tu equipo. Pídele que resuma el cambio y explique los riesgos; luego verifica el contexto y el código que cita.

Por ejemplo, una solicitud de cambios añade los filtros Abiertas y Cerradas a un tablero de incidencias. Esperas que Todas siga siendo la opción predeterminada y que se muestre un estado vacío cuando ninguna incidencia coincida:

Walk me through this pull request. Focus on the default filter and what
happens when there are no matching issues. All should remain the default.

Pide pruebas que lo respalden:

Show me the code path and tests for the no-matches case. Explain what is
covered and what still needs verification.

Contrasta las diferencias y las pruebas citadas con el comportamiento esperado.

Selecciona un hallazgo para inspeccionar su explicación y las líneas pertinentes en Cambios. Contrástalo con las diferencias más recientes, el comportamiento esperado y las pruebas antes de decidir si necesita una corrección. Usa el chat de revisión para detener una revisión en curso.

Personaliza tu revisión

Selecciona el engranaje de Instrucciones de revisión junto a Revisar con Codex. También puedes editar estas instrucciones en Configuración > Code Review.

Proporciona a Codex criterios y un formato de informe que se apliquen a todas tus revisiones, por ejemplo:

Start with a short summary. Prioritize behavior changes, data loss, and
missing edge-case tests. For each finding, explain the triggering input,
expected behavior, and actual behavior. Use our team's concise review style.

Estas instrucciones se aplican a las revisiones que inicias con Revisar con Codex en todos los repositorios. Los cambios realizados durante una revisión en curso se aplican a la siguiente revisión. Usa el chat de la solicitud de cambios para preguntas específicas sobre un cambio.

Opcionalmente, selecciona Cómic, Visualización o PDF para añadir una instrucción sugerida que explique el cambio en ese formato. Edita el texto según sea necesario, y luego selecciona Guardar o Ejecutar revisión.

Comparte comentarios y haz un seguimiento

Revisar una solicitud de cambios en el chat no publica comentarios, no la aprueba ni la fusiona. Tú eliges qué hallazgos compartir.

Una vez que hayas verificado un posible problema, pide a Codex que te ayude a preparar un comentario de revisión:

Using the team review guidelines we discussed, draft a comment describing
the no-matches behavior we verified, what should happen instead, and the test
that would cover it. Keep the comment as a draft.

Comprueba las referencias a archivos y líneas del borrador antes de publicarlo. Mantén los borradores en el chat hasta que estés listo: publicar en Resumen o Cambios envía el comentario al proveedor de origen inmediatamente, sin esperar a Enviar revisión.

Usa Enviar revisión para elegir Comentar, Aprobar o Solicitar cambios y enviar tu revisión al proveedor de origen. Comprueba la decisión seleccionada y el comentario de revisión antes de enviarla.

Si eres el autor, vuelve a tu solicitud de cambios y pide a Codex que atienda comentarios específicos. Inspecciona los cambios resultantes y ejecuta las pruebas pertinentes. Antes de aprobar o fusionar, comprueba la revisión más reciente, las comprobaciones y los comentarios pendientes.

No se admite la edición de descripciones de solicitudes de cambios con imágenes adjuntas en Code Review. Abre la solicitud de cambios en GitHub para editar esas descripciones.

Continúa en un chat

Cuando Resumen muestre Hilos, selecciona un chat vinculado para volver a esa conversación. Estos son tus chats asociados con la solicitud de cambios.

En Codex, selecciona Corregir en Comprobaciones de una solicitud de cambios abierta para adjuntar las comprobaciones fallidas al chat. Esto prepara un mensaje sin enviarlo. Revisa o añade tu instrucción y luego envíala para pedir a Codex que investigue. Inspecciona los cambios resultantes y vuelve a ejecutar las pruebas pertinentes antes de enviar una corrección al repositorio remoto.

Los diagnósticos disponibles dependen del proveedor de las comprobaciones. Para la CI de terceros, Codex puede usar el estado y la salida comunicados a GitHub.

En ChatGPT Work, carga el código que quieres revisar o haz que esté disponible mediante un plugin de código fuente instalado. En el prompt, identifica la pull request, la rama, el commit, los archivos y los criterios de revisión.

Revisar en la aplicación

Abre el panel de revisión para comprender qué ha cambiado, proporcionar comentarios sobre líneas específicas y decidir qué preparar, revertir, confirmar o enviar.

Para pedir a Codex que revise los cambios, escribe /review en el cuadro de redacción. Elige Revisar con respecto a una rama base o Revisar cambios sin confirmar. Codex presenta los hallazgos priorizados sin modificar tu árbol de trabajo.

El panel de revisión requiere un proyecto dentro de un repositorio Git. Si tu proyecto todavía no es un repositorio Git, la aplicación te solicita que crees uno.

Escribe /review para abrir los ajustes preestablecidos de revisión de la CLI. Codex inicia un revisor dedicado que lee el diff seleccionado e informa de hallazgos priorizados y procesables sin modificar el árbol de trabajo.

Escribe /review en el cuadro de redacción de la extensión de IDE. Elige Review against a base branch o Review uncommitted changes. Codex informa de hallazgos priorizados sin modificar el árbol de trabajo.

El comando /review solo aparece cuando el proyecto abierto se encuentra dentro de un repositorio Git.

Indica en el prompt la pull request, la rama, el commit o los archivos que se deben inspeccionar. Para revisar archivos locales que no estén disponibles mediante un plugin de código fuente instalado, cárgalos en el chat.

Qué cambios muestra

El panel de revisión refleja el estado de tu repositorio Git, no solo lo que Codex ha editado. Incluye los cambios realizados por Codex, los que hayas realizado tú y cualquier otro cambio sin confirmar del repositorio.

De forma predeterminada, el panel de revisión muestra los cambios Sin preparar. Usa Preparados para el índice de Git, Confirmación para una confirmación seleccionada, Rama para las diferencias con respecto a tu rama base o Último turno para el turno más reciente del asistente.

Revisar varios repositorios

Cuando un proyecto local incluye varias carpetas respaldadas por diferentes repositorios Git, el panel de revisión puede mostrar los cambios de cada repositorio. Abre el selector de repositorios en el encabezado de la revisión para inspeccionar otro repositorio y ver las líneas añadidas o eliminadas sin salir del panel de revisión actual.

Elige Último turno para ver los últimos cambios del asistente en todos los repositorios adjuntos. El selector de repositorios muestra Todos los repositorios para esa vista. Otros alcances de revisión, como Sin preparar, Preparados y Rama, se aplican al repositorio que selecciones.

Elige uno de estos ámbitos de /review:

• Review against a base branch busca la base de fusión y revisa el diff de tu rama.
• Review uncommitted changes incluye los archivos preparados, no preparados y sin seguimiento.
• Review a commit revisa el conjunto exacto de cambios de un commit seleccionado.
• Custom review instructions centra la revisión en los criterios que proporciones.

Elige uno de estos ámbitos de /review:

• Review against a base branch compara tu rama actual con una rama que selecciones.
• Review uncommitted changes revisa los cambios del árbol de trabajo.

Los hallazgos de la revisión aparecen en el chat web. Pide pruebas, solicita una revisión de seguimiento más específica o pide a ChatGPT que prepare archivos corregidos.

Resultados de la revisión de código

Los hallazgos de la revisión aparecen como comentarios en línea en el panel de revisión.

Las revisiones se ejecutan en el chat actual de forma predeterminada. En Configuración > General > Revisión de código, elige Independiente para iniciar un chat de revisión separado. Consulta la configuración para desarrolladores.

La revisión aparece como un turno en la transcripción. Establece review_model en config.toml cuando quieras que las revisiones usen un modelo distinto al de la sesión actual.

De forma predeterminada, la revisión se ejecuta en el chat actual. Establece chatgpt.reviewDelivery en detached cuando quieras que /review inicie un chat de revisión independiente. Consulta la referencia de configuración de la extensión de IDE.

Si pides a ChatGPT que prepare archivos corregidos, se siguen aplicando las herramientas y los permisos del espacio de trabajo disponibles para el chat.

Si pides a Codex que aplique las correcciones que encuentre, se aplicará tu configuración habitual del entorno aislado y de aprobación.

Navegar por el panel de revisión

• Al hacer clic en el nombre de un archivo, normalmente se abre ese archivo en el editor que hayas elegido. Puedes elegir el editor predeterminado en la configuración para desarrolladores.
• Al hacer clic en el fondo del nombre del archivo, se expanden o contraen las diferencias.
• Al hacer clic en una sola línea mientras mantienes pulsada la tecla Command, se abre la línea en el editor que hayas elegido.
• Si estás conforme con un cambio, puedes añadirlo al área de preparación o revertir los cambios que no quieras.

Comentarios en línea para proporcionar observaciones

Los comentarios en línea te permiten adjuntar observaciones directamente a líneas específicas de las diferencias. A menudo, esta es la forma más rápida de guiar a Codex hacia la corrección adecuada.

Para dejar un comentario en línea:

1. Abre el panel de revisión.
2. Coloca el cursor sobre la línea que quieras comentar.
3. Selecciona el botón + que aparece.
4. Escribe tus observaciones y envíalas.
5. Cuando termines de dejar comentarios, envía un mensaje al chat.

Como los comentarios son específicos de cada línea, Codex puede responder con mayor precisión que ante una instrucción general.

Codex trata los comentarios en línea como orientación para la revisión. Después de dejar comentarios, envía un mensaje de seguimiento que haga explícita tu intención; por ejemplo: “Resuelve los comentarios en línea y mantén el alcance al mínimo”.

Preparar y revertir archivos

El panel de revisión incluye acciones de Git para que puedas ajustar las diferencias antes de confirmarlas.

Puedes preparar, retirar de la preparación o revertir cambios en estos niveles:

• Diferencias completas: Usa los botones de acción del encabezado de la revisión, como Preparar todo o Revertir todo.
• Por archivo: Prepara, retira de la preparación o revierte un archivo individual.
• Por bloque: Prepara, retira de la preparación o revierte un solo bloque.

Usa la preparación cuando quieras aceptar parte del trabajo y la reversión cuando quieras descartarlo.

Estados preparado y sin preparar

Git puede representar cambios preparados y sin preparar en el mismo archivo. Cuando esto ocurre, el panel puede mostrar el mismo archivo en ambas vistas. Es el comportamiento normal de Git.