Clase 7 · 18 min
Cada conversación nueva con el agente empieza desde cero. Sin un archivo de instrucciones, repites las mismas advertencias; con instrucciones vagas, nada cambia. Las reglas que puedes verificar, los procedimientos guardados en una Skill y la memoria breve con fecha ayudan al agente a mejorar con cada tarea.
Empezar la lección
Objetivo: reescribir el AGENTS.md con cinco reglas verificables y convertir un fallo real en una regla para la próxima ejecución.
Dónde va cada tipo de instrucción. Haz clic en cada bloque.
Desplázate por la página: cada etapa ilumina su parte del diagrama.
Indica cómo trabajar allí: por dónde empezar a leer, cómo verificar, qué no hacer y el formato de entrega. La historia y los motivos quedan fuera. Un archivo breve se lee completo.
Un procedimiento que se repite (la lista semanal, el informe del viernes) se convierte en una Skill: un SKILL.md que empieza con nombre y descripción. El agente la activa cuando la tarea lo requiere, sin cargar todo el manual en cada tarea.
No es el modelo aprendiendo: es un archivo que el agente lee cuando tú se lo indicas. Guarda hechos estables y decisiones con fecha y motivo, no toda la conversación. Marca al principio cuándo se revisó.
Síntoma, causa observada, corrección mínima y verificación, en una línea. Di si el fallo fue del pedido o de la infraestructura. La corrección va donde la próxima ejecución la lea: en el AGENTS.md o la Skill.
Una regla que se puede comprobar en la puerta, un guion en la carpeta, memoria breve con fecha y cada tropiezo convertido en una pequeña protección. Así, la tarea de mañana sale mejor que la de hoy, sin cambiar de modelo.
Ninguno de estos archivos está por encima de las instrucciones del sistema, los permisos de la herramienta y lo que tú pides explícitamente en la conversación.
Haz clic en cada etapa.
Haz la prueba del letrero: «usa gafas de protección» se puede comprobar con solo mirar; «ten cuidado» no.
Una buena regla pide una acción y deja evidencia en la entrega. Si una regla no cambia ninguna decisión, quítala del archivo.
Compara el total del informe con ventas.csv e indica la diferencia.
En Codex, el AGENTS.md global está en %USERPROFILE%\.codex y se aplica a todo; el del proyecto se aplica en esa carpeta; el de una subcarpeta prevalece dentro de ella.
¿Algo se comporta de forma extraña? Busca un AGENTS.override.md olvidado en una carpeta copiada: en esa misma carpeta, tiene prioridad sobre AGENTS.md.
Resume las instrucciones que cargaste y di de qué archivo vino cada una.
El agente lee la descripción para decidir si activa la Skill. «Ayuda con informes» se activa incluso con un acta de reunión.
Di en qué situación se usa y dónde se detiene. Antes de confiar en ella, ensaya con tres casos: normal, incompleto y fuera de lo acordado.
Generar un borrador de informe semanal cuando haya un CSV de ventas. No usar para enviar informes ni manejar credenciales.
Cuando el resultado sale mal, dan ganas de cambiar de modelo o rehacerlo todo. Eso lleva horas y oculta problemas simples.
Un fallo del pedido se corrige en el texto; uno de infraestructura, con una comprobación. A menudo basta con agregar una línea al AGENTS.md.
Revisa el encabezado y la cantidad de registros antes de generar.
Copia y adapta a tu carpeta. Cambia lo que esté entre < >.
# Instrucciones para el agente Propósito: <lo que produce este proyecto> 1. Lee README.md antes de cambiar cualquier cosa. 2. Usa solo entradas/ y saidas/; no borres ni renombres archivos. 3. No inventes datos que no estén en las entradas; lo que falte se anota como pendiente al final. 4. Nunca escribas claves ni contraseñas en un archivo de texto; menciona solo el nombre de la variable de .env. 5. Termina indicando: qué cambiaste, cómo lo comprobaste y qué quedó pendiente.
--- name: relatorio-semanal description: Generar un borrador de informe semanal cuando el usuario proporcione un CSV de ventas. No usar para enviar informes ni manejar credenciales. --- ## Entrada Un CSV en entradas/. ## Pasos 1. Revisa el encabezado y la cantidad de registros antes de generar. 2. Suma los valores; no inventes los que falten. 3. Escribe el borrador en saidas/relatorio.md. ## Salida y comprobación Menciona la fuente, el total conocido y los pendientes. Detente antes de enviar o publicar.
# Memoria Revisado el: <dd/mm/aaaa> - <hecho estable 1, ej.: informes breves, pendientes al final> - <hecho estable 2> - <hecho estable 3>
| Fecha | Síntoma | Causa observada | Corrección mínima | Verificación | Tipo | |---|---|---|---|---|---| | <dd/mm> | informe vacío | hoja de cálculo sin registros | revisar la cantidad de filas antes de generar | una hoja vacía genera un aviso, no un informe | infraestructura |
Resume las instrucciones que cargaste en esta carpeta e indica de qué archivo provino cada una. Después, consulta ../config/memoria.md y, al hacer la siguiente tarea, di qué dato de la memoria usaste.
mkdir .agents\skills\relatorio-semanal notepad .agents\skills\relatorio-semanal\SKILL.md type .agents\skills\relatorio-semanal\SKILL.md
%USERPROFILE%\.codex\AGENTS.md: global, breve ("informa qué comprobaste").projetos\meu-primeiro-agente\AGENTS.md: se aplica al proyecto.…\provas\AGENTS.md: prevalece dentro de provas en los temas que trata.Tu pedido explícito en la conversación tiene prioridad sobre los tres.
Sin la regla "no inventes datos faltantes": "Total de la semana: 100,00" — el bolígrafo no tenía precio y el total fingió que sí.
Con la regla: "Total conocido: 90,50. Pendiente: la línea del bolígrafo no tiene precio. No lo completé."
En el proyecto y en la carpeta config.
Reescribe el AGENTS.md con cinco reglas. Al lado de cada una, anota cómo comprobarás si se cumplió. Pide una tarea y compruébalo.
Listo cuando: para cada una de las cinco reglas que señales, indicas en el resultado del agente la evidencia de que se cumplió.
Registra en config\falhas.md un error real de las clases anteriores (síntoma, causa, corrección mínima, verificación, tipo) y agrega la corrección al AGENTS.md.
Listo cuando: en la siguiente tarea, el mismo problema no se repite y puedes decir qué línea del AGENTS.md lo evitó.
La explicación aparece después de tu respuesta.
Pregunta 1 de 4
¿Cuál de estas reglas puedes comprobar al revisar el resultado del agente?competencia
Pregunta 2 de 4
Las instrucciones globales dicen "responde en viñetas", el AGENTS.md del proyecto no especifica el formato y tú pides una tabla en la conversación. ¿Qué prevalece?
Pregunta 3 de 4
Creaste memoria.md en config, pero el agente ignoró los datos. ¿Qué haces primero?
Pregunta 4 de 4
El informe salió vacío porque la hoja de cálculo no tenía registros. ¿Cuál es la corrección mínima?
Elige una alternativa. La explicación aparece después de tu intento.