MÓDULO 3.1 / 5 DE 8
AGENTS, Skills y memoria
Crear instrucciones de proyecto y una capacidad reutilizable con criterio de revisión.
1AGENTS.md orienta la ejecución
Qué es
AGENTS.md es el archivo de instrucciones que Codex descubre en el ámbito aplicable. Describe cómo trabajar: archivos iniciales, comandos de verificación, límites y formato de entrega. No es necesario explicar toda la historia de la organización; prefiera reglas cortas que alteren una decisión real.
Por qué aprender
Las instrucciones objetivas evitan repetir los mismos detalles en cada conversación. El archivo debe ayudar al agente a elegir una acción concreta, como verificar el informe antes de considerarlo finalizado.
Conceptos clave
Instrucción operativa; alcance; regla observable; concisión.
En la práctica
“Sé excelente” es difícil de probar. “Compare el total del informe con vendas.csv e indique la diferencia” define una acción y su evidencia.
✓ Hazlo
Escriba cinco reglas. Para cada una, pregunte: ¿puedo observar si se cumplió? Elimine orientaciones que no cambian el trabajo.
✗ Evita
Aceptar una conclusión sin comprobar la entrada que la sustenta.
2Global y proyecto se complementan
Qué es
Por defecto, ~/.codex/AGENTS.md guarda instrucciones globales. En el proyecto, AGENTS.md añade reglas específicas; los archivos en carpetas más cercanas pueden prevalecer en el ámbito correspondiente. AGENTS.override.md tiene prioridad sobre AGENTS.md en el mismo nivel. Esto no supera instrucciones del sistema, permisos o la solicitud explícita de la sesión.
Por qué aprender
La ruta importa. Una regla local puede no aplicarse a otra carpeta, y un archivo override olvidado puede explicar un comportamiento inesperado. Mantenga lo global pequeño y deje los detalles locales en el proyecto.
Conceptos clave
Descubrimiento; jerarquía; alcance de directorio; override.
En la práctica
Global: “informe las pruebas ejecutadas”. Proyecto: “valide el CSV con python3 validar.py”. Ambas instrucciones colaboran; no es necesario repetir el script de cada proyecto en el archivo global.
3Las Skills empaquetan procedimientos
Qué es
Una Skill reúne instrucciones de una actividad recurrente, con nombre y descripción al inicio de SKILL.md. Puede incluir recursos y programas de apoyo. Las Skills personales quedan en ~/.agents/skills; las del proyecto pueden quedar en .agents/skills dentro del repositorio. La carpeta ~/.codex sigue siendo la configuración de Codex.
Por qué aprender
Una regla indica qué respetar; una Skill enseña un procedimiento que puede activarse cuando sea necesario. Separar estos papeles evita cargar todo el manual en todas las tareas.
Conceptos clave
Nombre; descripción de activación; procedimiento; entrada y salida; validación.
En la práctica
relatorio-semanal recibe un CSV ficticio, calcula un total verificable y produce un Markdown con pendientes. La descripción deja claro que no envía el resultado automáticamente.
Secuencia para experimentar
- Prepara una copia de entrenamiento.
- Lea materiais/SKILL-relatorio.md. Cree la carpeta indicada y guarde el archivo como SKILL.md, manteniendo el encabezado delimitado por ---.
- Registra el resultado observado y la próxima corrección.
4La memoria necesita mantenimiento
Qué es
La memoria operativa del curso es un conjunto de archivos consultables, no un cambio en los pesos del modelo. Funciona cuando el agente lee la información relevante y cuando alguien mantiene esa información actualizada. Guarde hechos estables, decisiones y causas de fallas; no preserve cada frase de cada conversación.
Por qué aprender
Copiar todo el historial aumenta el volumen y puede reintroducir instrucciones antiguas. Una memoria pequeña, datada y revisada ayuda más que un archivo inmenso que nadie puede validar.
Conceptos clave
Memoria externa; consulta explícita; resumen; validez; fuente.
En la práctica
Una profesora registra que los materiales de la clase usan lenguaje accesible y ejemplos ficticios. En la próxima tarea, indique ese archivo en lugar de repetir toda la conversación sobre la clase.
✓ Hazlo
Incluya en memoria.md tres hechos útiles y una fecha de revisión. En la tarea siguiente, pida que el agente cite qué hecho utilizó.
✗ Evita
Mezclar la copia de entrenamiento con archivos privados o trabajo en producción.
5Los fallos se convierten en pequeñas protecciones
Qué es
Registre el síntoma, la causa observada, la corrección mínima y cómo verificar. Diferencie falla de solicitud, como objetivo ambiguo, de falla de infraestructura, como proceso terminado. El registro solo genera aprendizaje operativo cuando altera el procedimiento siguiente.
Por qué aprender
Rehacer todo el proyecto puede enmascarar un problema simple. Una pequeña protección, como verificar la existencia de un archivo antes de leerlo, suele ser más fácil de probar y mantener.
Conceptos clave
Síntoma no es causa; corrección mínima; prevención; evidencia.
En la práctica
El informe salió vacío porque el CSV no tenía líneas. La protección es validar el encabezado y la cantidad de registros antes de generar el informe, no cambiar de modelo.
6Pruebe la capacidad reutilizable
Qué es
Prueba la Skill con una entrada normal, otra incompleta y una fuera de alcance. Observa si el resultado preserva datos, señala incertidumbre y se detiene cuando debería. La prueba debe medir comportamiento, no solo buscar el nombre de la Skill en la respuesta.
Por qué aprender
Un procedimiento que funciona una vez puede estar dependiendo de un contexto accidental. Variar entradas ayuda a descubrir lo que necesita quedar explícito en las instrucciones.
Conceptos clave
Caso normal; caso incompleto; límite de alcance; criterio de aceptación.
En la práctica
Entrada incompleta: falta el valor de una venta. Esperado: no inventar el número y separar el total conocido de la pendiente. Fuera de alcance: solicitar envío al cliente; esperado: preparar solo el borrador.
Criterios para revisar su entrega
Use esta rúbrica después del laboratorio. Cada línea pide una evidencia; marcar lectura no significa que la práctica se haya ejecutado.
| Criterio | Evidencia esperada | Si no pasó |
|---|---|---|
| Alcance | La entrega corresponde al objetivo de esta clase. | Reduzca la tarea y nombre un único resultado. |
| Entradas | Usted sabe qué archivos o datos se usaron. | Liste las fuentes y elimine material sin relación. |
| Ejecución | El procedimiento se realizó en el entorno de entrenamiento. | Diferencie lo que se planificó de lo que se hizo. |
| Conferencia | Un resultado se comparó con una referencia. | Abra el archivo o repita la consulta verificable. |
| Secretos | No se compartió ningún token, contraseña o dato privado. | Revise la copia de trabajo antes de cualquier envío. |
| Continuidad | Otra persona puede encontrar el siguiente paso. | Actualice el README y registre una pendiente concreta. |
MANOS A LA OBRA / ~15 MIN O EN ETAPAS
Tu primera Skill de informe
Use archivos ficticios y una carpeta de entrenamiento. Las prácticas con instalación, Telegram o VPS pueden requerir tiempo adicional para registro y configuración.
Skill de ejemplo
Lea el bloque antes de usar. Campos como Su Nombre y usuario@ip-de-vps son ejemplos para adaptar; los comandos administrativos pertenecen solo a su entorno de entrenamiento.
--- name: relatorio-semanal description: Generar borrador de informe a partir de CSV proporcionado, sin envío externo. --- 1. Lee el README y el CSV indicado. 2. Valida encabezado, valores y filas vacías. 3. Calcula los totales sin inventar datos ausentes. 4. Genera Markdown con fuentes, total y pendientes. 5. Compara el total con la suma de las entradas. 6. Detente antes de enviar o publicar.
Criterio de listo
Crear instrucciones de proyecto y una capacidad reutilizable con criterio de revisión. Registra el archivo producido, la prueba ejecutada y el resultado observado.
Abrir archivos y modelos del laboratorioCompruebe lo que quedó
¿Escribir “no reveles secretos” en AGENTS.md sustituye permisos de archivos?
Ver respuesta comentada
No. Las instrucciones orientan; los permisos y el aislamiento restringen lo que la herramienta puede acceder.
Si su respuesta fue diferente, vuelva al tema correspondiente y escriba la diferencia en una frase. La verificación no bloquea su estudio.
Resumen del módulo
- Instrucción operativa; alcance; regla observable; concisión.
- Descubrimiento; jerarquía; alcance de directorio; override.
- Nombre; descripción de activación; procedimiento; entrada y salida; validación.
- Memoria externa; consulta explícita; resumen; validez; fuente.
- Síntoma no es causa; corrección mínima; prevención; evidencia.
- Caso normal; caso incompleto; límite de alcance; criterio de aceptación.
Consulte la fuente
Herramientas verificadas el 20/09/2026; los nombres de pantallas y la disponibilidad pueden cambiar.