Aumenta la autonomía según la evidencia
Qué es
El método de la bicicleta representa una supervisión que cambia a lo largo del aprendizaje. En las primeras ejecuciones, acompaña todo. Después de observar estabilidad, revisa muestras y mantén controles sobre acciones de mayor impacto.
Por qué aprender
Confiar más no significa retirar toda protección. Una skill que produce un borrador puede operar con poca supervisión; publicar, enviar o alterar registros implica consecuencias diferentes. El nivel de autonomía depende del riesgo y de las evidencias.
Conceptos clave
Fase 1: acompañar tres casos diferentes.
Fase 2: revisar cada entrega final.
Fase 3: muestrear salidas de bajo impacto.
Siempre: revisar bloqueos y cambios de comportamiento.
✓ Haz así
Aumenta la supervisión cuando la entrada o el entorno cambien.
✗ Evita este error
Tratar algunas ejecuciones buenas como autorización ilimitada.
Practica antes de revelar
Una skill estable empieza a usar una nueva herramienta de publicación. ¿Qué cambia?
Ver respuesta comentada
La capacidad y el riesgo cambiaron. Reevalúa permisos, casos de prueba y supervisión. La estabilidad del borrador no prueba la seguridad de la publicación.
Da retroalimentación que identifique la corrección más pequeña
Qué es
Un feedback eficaz nombra el resultado observado, lo esperado, el impacto y la corrección propuesta. Incluye también lo que funcionó y debe preservarse. Esto reduce el riesgo de que una reescritura innecesaria rompa partes buenas.
Por qué aprender
“Quedó mal” empuja al agente a adivinar. “El total está correcto, pero falta el período en el encabezado” localiza el defecto. La corrección es agregar y probar el período, no cambiar todo el pipeline de cálculo.
Conceptos clave
Funcionó: los totales por canal son correctos.
Falló: el período no aparece antes del resumen.
Impacto: el lector no sabe a qué semana se refiere.
Ajuste: exigir período en el encabezado y verificar las dos fechas.
Del concepto a la acción
- Observado: identificar la condición inicial.
- Esperado: aplicar la decisión descrita.
- Corrección mínima: verificar el efecto en el ejemplo.
- Prueba: registrar la evidencia de salida.
✓ Haz así
Cita el archivo, la sección o un ejemplo concreto.
✗ Evita este error
Pide “vuelve a hacerlo todo mejor” cuando haya un defecto localizado.
Practica antes de revelar
Convierte “el texto no suena como yo” en una retroalimentación utilizable.
Ver respuesta comentada
“Usaste frases largas y tres superlativos que no aparecen en mis ejemplos. Conserva los hechos, acorta esas frases y usa los dos textos aprobados como referencia de tono.”
Convierte el fallo en una prueba de regresión
Qué es
Después de corregir, guarda un caso que habría detectado la falla antes. Esa prueba entra en la próxima evaluación. También ejecuta los casos anteriores para asegurar que la nueva protección no dejó inutilizables entradas válidas.
Por qué aprender
La corrección de una ejecución es local; la prueba preserva el aprendizaje. Si una regla de privacidad empieza a ocultar todos los números, por ejemplo, la regresión debe revelar que también eliminó datos esenciales que eran públicos.
Conceptos clave
Fallo: informe sin período.
Caso: CSV con fechas diferentes.
Prueba: el encabezado contiene la fecha mínima y la máxima.
Regresión: el total y los canales siguen siendo correctos.
✓ Haz así
Mira que la prueba falle antes de confiar en que protege el caso.
✗ Evita este error
Acumular reglas que nunca se ejercitan.
Practica antes de revelar
La entrada vacía ahora da un error claro, pero la válida dejó de funcionar. ¿La corrección terminó?
Ver respuesta comentada
No. Corrigiste un caso e introdujiste una regresión. Ajusta la condición y repite ambos tests.
Versiona la receta y preserva la reversión
Qué es
Guarda cambios de la skill en control de versiones o en copias identificadas, con un historial breve del motivo. Registra la versión usada en cada experimento para distinguir mejora de instrucción de cambio de ambiente.
Por qué aprender
Un historial útil permite volver a la versión anterior cuando una corrección empeora el resultado. No basta con guardar “final”, “final2” y “ahora-va”. Identifica qué cambió y la evidencia que justificó la decisión.
Conceptos clave
Versión del proyecto: 1.0.0
Patch de corrección: 1.0.1
Nueva funcionalidad: 1.1.1
Convención de este proyecto: minor conserva el patch.
Registrar siempre el motivo y las pruebas en el historial.
✓ Haz así
Usa la convención de versionado documentada por el proyecto.
✗ Evita este error
Confundir una convención local con la regla universal de semver.
Practica antes de revelar
¿Qué información debe acompañar “ajusté la descripción”?
Ver respuesta comentada
El disparador que fallaba, el texto alterado y los pedidos positivos y negativos revaluados. Así alguien puede entender por qué existe el cambio.
Concluye el proyecto: informe semanal
Qué es
Reúne la skill, el CSV sintético, el generador, casos negativos y la evidencia de ejecución. El kit proporciona un punto de partida funcional; tu tarea es ejecutar, explicar el resultado y adaptar una regla pequeña con una prueba correspondiente.
Por qué aprender
El proyecto final comprueba el ciclo completo: contrato, implementación, verificación y mejora. Leer el SKILL.md es solo una parte. Necesitas abrir los artefactos, revisar la cuenta y observar cómo reacciona la skill ante una entrada inválida.
Conceptos clave
python3 scripts/gerar_relatorio.py dados/vendas.csv \
--outdir saidas/rodada-01
python3 scripts/testar_relatorio.py
# Después, pedir al Codex que ejecute por la skill
# y compararlo con el resultado del script.
Del concepto a la acción
- Instalar el ejemplo: identificar la condición inicial.
- Generar informe: aplicar la decisión descrita.
- Probar fallas: comprobar el efecto en el ejemplo.
- Entregar evidencias: registrar la evidencia de salida.
✓ Haz así
Compara la ejecución directa con la ejecución guiada por la skill.
✗ Evita este error
Afirmar que el disparador de Codex se probó solo porque pasó el Python.
Practica antes de revelar
Agrega un límite de valor por línea, documenta ese límite y crea un caso que lo exceda.
Ver respuesta comentada
Una solución aceptable define el límite, rechaza el valor excedente con un mensaje claro y mantiene el caso de R$ 500 aprobado. Ese límite es una elección del ejercicio, no una regla comercial universal.
Revisa tu portafolio de skills
Qué es
Una biblioteca saludable contiene tareas con fronteras claras, ejemplos y mantenimiento posible. Revisa skills parecidas, disparadores que compiten y reglas obsoletas. Consolida duplicaciones cuando haya evidencia de que representan el mismo proceso.
Por qué aprender
La habilidad final no es escribir más instrucciones: es mantener un sistema en el que cada procedimiento pueda encontrarse, ejecutarse y evaluarse. Rehaz la revisión cuando el trabajo cambie, no solo cuando el texto parezca antiguo.
Conceptos clave
Revisión final
[ ] Salida aprobada y contratos claros
[ ] Un trabajo y disparadores probados
[ ] Libertad calibrada por etapa
[ ] QA con evidencias
[ ] Configuración evaluada
[ ] El feedback se volvió prueba
✓ Haz así
Prioriza la skill que causa más retrabajo observable.
✗ Evita este error
Aumenta las instrucciones para cada incidente sin eliminar contradicciones.
Practica antes de revelar
Explica tu skill a otra persona en 60 segundos: entrada, salida, límite y evidencia.
Ver respuesta comentada
Si la persona puede ubicar la carpeta, ejecutar el ejemplo, reconocer una falla y revisar el QA, el paquete es enseñable. El siguiente paso es probarlo con nuevas entradas reales debidamente preparadas.
Verifique su comprensión
¿Qué cambio cierra el ciclo de aprendizaje?
¿Qué te llevas de este módulo?
Entregar una skill, casos de prueba, QA e historial de mejora.
- Aumente la autonomía según la evidencia.
- Dar feedback que identifique la corrección más pequeña.
- Transformar el fallo en una prueba de regresión.
- Versionar la receta y conservar la reversión.
- Concluir el proyecto: informe semanal.
- Revise su portafolio de skills.
Próxima acción: guarde el ejercicio en su laboratorio y registre lo que todavía necesita revisión.