Tema

Tamaño del texto

Ancho de lectura

Interlineado

Fuente

Acento

0 de 0 0%

MÓDULO 1.3

Una segunda opinión que ayuda

Usa revisión independiente para encontrar fallas reproducibles, sin cambiar evidencia por opinión.

6 temas Conceptos y aplicación
~35 minutos Estimación con práctica
Práctico Paso a paso
Tu entrega Un reporte corto con un problema reproducido y su corrección mínima.
ETAPA 1 Cambio ETAPA 2 Revisión ETAPA 3 Reproducción ETAPA 4 Corrección ETAPA 1 Cambio ETAPA 2 Revisión ETAPA 3 Reproducción ETAPA 4 Corrección
Un reporte corto con un problema reproducido y su corrección mínima.
1

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

Contrato Comportamiento esperado
Diff Cambio entre versiones
Hipótesis Posible problema a investigar
Reproducción Pasos que muestran el efecto
2

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

  1. Describe el cambio y elige una base.
  2. Pide evidencia, reproduce y clasifica los hallazgos.
  3. Aplica la corrección mínima y repite el escenario.

Conceptos clave

Base Versión usada en la comparación
Estado Archivos nuevos y modificados
Alcance El conjunto a revisar
Ayuda local Contrato de la CLI instalada
3

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.

Ejemplo de trabajo
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

Disparador Condición que inicia la falla
Efecto Resultado observado
Prioridad Impacto y probabilidad
Corrección mínima Cambio suficiente para resolver
4

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

Reintentar Nueva tentativa de la misma operación
Idempotencia Repetir sin duplicar el efecto
Atomicidad Completar todo o no aplicar
Interrupción Fallo entre etapas
5

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.

Criterios para revisar tu entrega
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

Caso mínimo Menor entrada que mantiene el fallo
Historial Intentos y resultados
Hipótesis única Una causa probada a la vez
Parada Condición objetiva de finalización
6

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áctica
Revisar 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

Identificador Clave estable de la solicitud
Duplicación Dos efectos para la misma intención
Conflicto Misma clave con contenido diferente
Prueba de retorno Repetir el escenario después de corregir

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.