Entrega contexto al revisor
Una revisión comienza con el cambio que quieres evaluar y con el comportamiento esperado. Informa entrada, resultado deseado, archivos involucrados y verificaciones ya hechas. El revisor necesita saber qué puede considerarse correcto, no solo recibir un directorio enorme.
Una segunda IA, como Codex, puede ofrecer otro análisis, pero no se vuelve automáticamente más confiable. Trata sus sugerencias como hipótesis que deben apuntar a un escenario concreto. El valor aparece cuando la revisión encuentra algo que puede demostrarse.
Por qué aprender
El contexto reduce comentarios genéricos y evita que el revisor proponga cambios que contradicen el objetivo. También limita el costo y el alcance de la revisión.
✓ Hacer
Relaciona cada hallazgo con un comportamiento.
✗ Evitar
Aceptar una revisión porque suena convincente.
Conceptos clave
Prepara una base comparable
En un proyecto Git, el diff muestra lo que cambió. Antes de revisar, revisa la carpeta actual y el estado del repositorio. Separa archivos propios del cambio y materiales que no deben publicarse. Una revisión de cambios no versionados puede incluir archivos nuevos.
Con la CLI Codex instalada y autenticada, consulta la ayuda local y usa una revisión compatible con la versión disponible. El ejemplo de abajo muestra la revisión de cambios no confirmados. No sustituye la prueba de la aplicación.
Por qué aprender
Una base clara evita que el revisor compare archivos equivocados o trate código antiguo como parte del cambio actual. La inspección del estado también evita publicar datos de preparación por accidente.
Un camino para aplicar
- Describe el cambio y elige una base.
- Pide evidencia, reproduce y clasifica los hallazgos.
- Aplica la corrección mínima y repite el escenario.
Conceptos clave
Pide hallazgos accionables
Solicita que cada hallazgo describa disparador, efecto, ubicación y forma de reproducir. Prefiere “dos clics envían el mismo pedido dos veces” a “mejora la robustez”. La primera enunciación permite construir una prueba; la segunda no define un comportamiento.
Diferencia error funcional, mantenimiento y preferencia de estilo. Todos pueden importar, pero no deben recibir la misma prioridad. Una exportación que incluye registros de otro cliente exige una respuesta distinta a un nombre de variable poco claro.
Por qué aprender
Los hallazgos accionables convierten la revisión en una herramienta de decisión. Puedes priorizar por impacto y verificar si la corrección mínima realmente resolvió el caso.
git status --short
git diff --stat
# Revise las opciones de la versión instalada:
codex review --help
# Revise los cambios que aún no se han commiteado:
codex review --uncommitted
Conceptos clave
Prueba repetición e interrupción
Muchos errores aparecen en la segunda ejecución. Si un pedido se reenvía después de una falla de conexión, la operación necesita saber si ya fue procesada. Una clave de idempotencia identifica la misma intención para evitar crear dos resultados.
Otro escenario es la interrupción a mitad de una actualización. Registrar la mitad de una operación puede dejar los datos inconsistentes. En ejercicios, simula la falla entre pasos y observa el estado final. No concluyas que un flujo es correcto solo porque funcione una vez.
Por qué aprender
Estos escenarios son fáciles de olvidar en demostraciones. Probar repetición e interrupción revela problemas que una lectura superficial o una sola ejecución no muestra.
✓ Hacer
Guardar el caso que reproducía el error.
✗ Evitar
Corregir el estilo y el fallo crítico como si fueran lo mismo.
Conceptos clave
Salir de un ciclo de intentos
Cuando una corrección falla repetidamente, registre lo que ya se intentó y el resultado de cada intento. Reduzca el problema hasta una entrada pequeña que todavía falle. Entregue ese caso a una nueva revisión.
Cambiar de modelo sin organizar las evidencias puede solo reiniciar el mismo ciclo. El cambio más importante es proporcionar un experimento más pequeño, una hipótesis a la vez y una condición clara de parada. Conserve el caso que fallaba después de la corrección.
Por qué aprender
Un caso mínimo reduce la cantidad de explicaciones posibles. Le permite distinguir un problema de lógica, una configuración incompatible y una dependencia no disponible.
| Criterio | Evidencia esperada |
|---|---|
| Reproducción | Dos entradas iguales demuestran el problema. |
| Corrección | La misma intención produce un único efecto. |
| Conflicto | El contenido divergente no se descarta en silencio. |
Conceptos clave
Práctica: encuentre una duplicación
Imagine un formulario ficticio que agrega pedidos a una lista. El mismo identificador puede llegar dos veces. Describa cómo reproducir la duplicación y proponga una regla que conserve solo un efecto para el mismo pedido.
No basta con ocultar la segunda línea en la pantalla. La regla debe actuar sobre el registro de la operación. Explique también qué hacer cuando el identificador es igual, pero el contenido cambió: esto exige tratar un conflicto, y no descartar en silencio la información.
Por qué aprender
La práctica conecta revisión, prueba y comportamiento de negocio. Usted aprende a verificar el efecto real de la corrección y a reconocer cuándo dos entradas aparentemente iguales representan situaciones diferentes.
Tu ejercicio
El pedido R-14, “revisar catálogo”, llega dos veces por un nuevo intento de envío. Luego llega R-14 con “revisar contrato”. Defina el resultado esperado para cada recepción.
Descargar ficha de la prácticaRevisar respuesta comentada
Primero R-14: registrar el pedido. Segundo R-14 con contenido idéntico: devolver el registro existente, sin duplicar. Tercero R-14 con contenido diferente: señalar conflicto para revisión. Probar el conteo y el contenido almacenado después de las tres entradas.
Comprueba tu comprensión
El revisor escribió “hay riesgo de duplicación”. ¿Qué falta?
Conceptos clave
Lo que queda de este módulo
Un reporte corto con un problema reproducido y su corrección mínima.
- ✓ Dos entradas iguales demuestran el problema.
- ✓ La misma intención produce un único efecto.
- ✓ El contenido divergente no se descarta en silencio.
El progreso registra tu lectura. La práctica queda concluida cuando revisas la entrega.