Revisión de código

Usa ChatGPT o Codex para inspeccionar los cambios de código antes de confirmarlos o enviarlos.

Iniciar una revisión

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.

Elegir el alcance de la revisión

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.

Trabajar con los resultados de la revisión

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.

De forma predeterminada, las revisiones se ejecutan en el chat actual. En Configuración > General > Revisión de código, elige Separada para iniciar un chat de revisión independiente. 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 Cmd, la línea se abre en el editor que hayas elegido.
• Si estás conforme con un cambio, puedes prepararlo 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”.

Revisiones de solicitudes de cambios

Cuando Codex tiene acceso a GitHub para tu repositorio y el proyecto actual está en la rama de la solicitud de cambios, la aplicación de escritorio ChatGPT puede ayudarte a gestionar los comentarios de la solicitud de cambios sin salir de la aplicación. La barra lateral muestra el contexto de la solicitud de cambios y los comentarios de los revisores, y el panel de revisión muestra los comentarios junto a las diferencias para que puedas pedir a Codex que resuelva los problemas en el mismo chat.

Instala GitHub CLI (gh) y autentícalo con gh auth login para que Codex pueda cargar el contexto de la solicitud de cambios, los comentarios de revisión y los archivos modificados. Si falta gh o no está autenticado, es posible que los detalles de la solicitud de cambios no aparezcan en la barra lateral ni en el panel de revisión.

Usa este flujo cuando quieras mantener todo el ciclo de corrección en un solo lugar:

1. Abre el panel de revisión en la rama de la solicitud de cambios.
2. Revisa el contexto de la solicitud de cambios, los comentarios y los archivos modificados.
3. Pide a Codex que corrija los comentarios específicos que quieras resolver.
4. Inspecciona las diferencias resultantes en el panel de revisión.
5. Prepara, confirma y envía los cambios a la rama de la solicitud de cambios cuando estén listos.

Para las revisiones iniciadas desde GitHub, consulta Usar Codex en GitHub.

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.