Revisión de código
Revisa los cambios de código en los clientes de ChatGPT y Codex
Usa ChatGPT o Codex para inspeccionar los cambios de código antes de confirmarlos o enviarlos.
Iniciar una 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.
Elegir el alcance de la revisión
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.
Trabajar con los resultados de la revisión
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.
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:
- Abre el panel de revisión.
- Coloca el cursor sobre la línea que quieras comentar.
- Selecciona el botón + que aparece.
- Escribe tus observaciones y envíalas.
- 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:
- Abre el panel de revisión en la rama de la solicitud de cambios.
- Revisa el contexto de la solicitud de cambios, los comentarios y los archivos modificados.
- Pide a Codex que corrija los comentarios específicos que quieras resolver.
- Inspecciona las diferencias resultantes en el panel de revisión.
- 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.