Tiempo: 75 minutos
Superficie: Codex local
Plataformas: macOS, Windows y Linux
Qué vas a aprender
- Convertir un resultado manual en un proceso repetible.
- Utilizar las herramientas ya instaladas sin descargar software innecesario.
- Probar una automatización con datos conocidos y salidas separadas.
Automatizar no significa perder el control
Una automatización segura tiene una entrada, una salida, una regla conocida, un modo de prueba y una señal clara de fallo. No debe sobrescribir el origen ni esconder errores.
Dentro de Aprender-Codex/entrada, crea gastos-practica.csv:
fecha,categoria,concepto,importe
2026-07-01,material,cuadernos,24.50
2026-07-02,transporte,bus,18.00
2026-07-03,formacion,curso,42.25
2026-07-04,material,boligrafos,15.25
Son datos ficticios. El total conocido es 100.00; material suma 39.75, transporte 18.00 y formación 42.25.
Fase 1 — inspecciona el entorno
No instales nada y no cambies archivos. Comprueba qué herramienta ya disponible
en este equipo serviría para leer un CSV y crear un resumen reproducible. Elige
la opción más sencilla y multiplataforma posible. Si no hay una opción adecuada,
detente y explica alternativas. No uses red.
Codex puede detectar Python, Node.js, PowerShell u otra herramienta. La elección puede variar; lo importante es que explique qué encontró. No autorices una instalación solo para completar la práctica.
Fase 2 — diseña antes de ejecutar
Propón una automatización que lea entrada/gastos-practica.csv y escriba archivos
nuevos en salida/resumen-gastos. Debe producir un resumen por categoría, total
general, número de filas válidas y lista de errores. No debe modificar el CSV.
Incluye modo de prueba o vista previa, códigos de error y una instrucción breve
para repetirla. Muéstrame los archivos y el comando previsto antes de crearlos.
Fase 3 — prueba con una copia
Autoriza la creación únicamente dentro de una carpeta nueva. Pide ejecutar primero la vista previa y comparar con los totales conocidos. Después autoriza la salida final.
Ejecuta primero el modo de vista previa. Compara el total y las categorías con
estos valores esperados: total 100.00; material 39.75; transporte 18.00;
formacion 42.25. Si no coinciden, no escribas la salida final. Si coinciden,
crea el resumen y vuelve a leerlo para verificarlo.
Prueba de error
Copia el CSV como gastos-error.csv y cambia un importe por NO_VALIDO. Ejecuta la automatización sobre esa copia. Debe informar del error y evitar presentar un total incompleto como correcto.
Comprobación manual
- El CSV original sigue igual.
- La vista previa coincide con 100.00.
- El resumen identifica cuatro filas válidas.
- La prueba defectuosa produce un error visible.
- Las instrucciones permiten repetir el proceso sin recordar la conversación.
Recuperación
Elimina solo la carpeta de salida y vuelve a ejecutar. Como la entrada está intacta, el proceso es recuperable. Si la automatización modifica el origen, no cumple el diseño y debe corregirse antes de reutilizarla.
Error frecuente
Probar únicamente el caso correcto. Una automatización puede parecer fiable hasta que encuentra una celda vacía, un nombre duplicado o un formato inesperado. Incluye al menos una prueba de fallo.
Mini ejercicio
Añade una quinta fila válida y calcula manualmente el nuevo total. Ejecuta de nuevo y comprueba que no necesitas modificar el programa para aceptar otra fila.
Evidencia que debes guardar
- Herramienta elegida y motivo.
- Plan previo.
- Comando o acción reproducible.
- Salida correcta y salida de error.
- Confirmación de que el origen no cambió.
Ejemplo resuelto: automatizar un CSV con una fila problemática
Marta recibe cada viernes un CSV con cliente, email, ultima_contacto y estado. Quiere un resumen de seguimientos. Una fila contiene una fecha inválida y otra no tiene correo. En vez de ordenar directamente, establece tres fases.
Fase 1 — inspección. Codex informa de columnas, codificación, número de filas, valores vacíos, formatos detectados y anomalías. No escribe resultados.
Fase 2 — vista previa. Procesa cinco filas y muestra cómo interpretará fechas, estados y ausencias. Marta confirma que una fecha ambigua no debe corregirse por intuición: se marca REVISAR.
Fase 3 — ejecución. Crea salidas nuevas y un informe de control.
Usa entrada/clientes.csv. No modifiques el original.
Antes de ejecutar, valida cabeceras y muestra cinco filas transformadas.
Después crea salida/seguimiento.csv con todas las filas, ordenadas por
ultima_contacto válida; coloca al final las fechas inválidas y marca REVISAR.
Crea salida/resumen.md con recuentos, incidencias y reglas aplicadas.
Comprueba que filas_de_entrada = filas_de_salida y que no se enviaron correos.
Para demostrar que la automatización es reutilizable, Marta guarda una copia del encargo y lo repite con un segundo archivo de prueba. Si el nuevo CSV cambia el nombre de una columna, la tarea debe detenerse y explicar la incompatibilidad; no adaptar silenciosamente la regla.
Control de reconciliación: total de entrada, total procesado, total correcto y total a revisar deben ser matemáticamente compatibles.
Señal de alarma: el sistema «rellena» correos, fechas o estados que no estaban en la fuente.
Criterio de terminado: los originales siguen iguales, los recuentos cuadran, las excepciones son visibles y una segunda ejecución no duplica ni mezcla salidas.
Cambia una variable
Introduce deliberadamente una cabecera mal escrita. El comportamiento deseado es una parada explicada, no un resultado aparentemente válido.
Comprueba que lo has entendido
- ¿Por qué una vista previa de cinco filas no sustituye el control final de todas las filas?
- ¿Qué propiedad debe tener una automatización que se ejecutará cada semana?
Respuesta razonada
La muestra ayuda a validar la regla, pero puede no contener las excepciones del conjunto completo. Una automatización recurrente debe ser reproducible, detectar cambios de formato, separar entradas y salidas y producir controles revisables.
Fuentes oficiales
Revisado contra la documentación: 14 de julio de 2026.
Prueba pendiente antes de publicación: ejecutar la práctica con herramientas disponibles por defecto o habitualmente disponibles en macOS, Windows y Linux y documentar las variantes reales.