Tu herramienta, paso a paso
Esta es la herramienta de ejemplo del seminario, construida de verdad con OpenCode y un modelo gratuito: un cuaderno de evaluación por criterios que sirve para FP y para ESO y Bachillerato. Aquí tienes el encargo, los dos ficheros de la carpeta y la conversación entera, mensaje a mensaje, con lo que falló al probarla y cómo se arregló. Úsala tal cual o haz la tuya.
8 mensajes
del plan a la versión final
Gratis
GLM-5.3-Flash Free, sin cuenta
0 líneas
escritas a mano
1 fichero
unos 42 KB, sin internet
Antes de nada
Elige qué vas a construir
Seis ideas que funcionan bien como primera herramienta: resuelven algo que haces cada semana y caben en un solo fichero. La que elegiste en la sesión 4 vale más que cualquiera de estas.
Desliza el diagrama de lado para verlo entero
Las seis, una a una
Corregir y evaluar · el ejemplo
Cuaderno de evaluación por criterios
Planificar
Planificador del curso
Corregir
Generador de rúbricas y feedback
Preparar clases
Banco de preguntas para Aules
Preparar clases
Biblioteca de prompts de tu materia
Planificar (FP)
Seguimiento de la formación en empresa
El ejemplo
Qué hace el cuaderno de evaluación
Cinco pestañas, de izquierda a derecha: lo configuras una vez y después solo pones notas.
1. Configuración
2. Alumnado
3. Actividades
4. Notas
5. Resultados
Copia, CSV e imprimir
Cómo calcula una nota
El alumno A01 del botón «Cargar ejemplo»: un examen con un 8 y una práctica con un 6,5.
Desliza el diagrama de lado para verlo entero
Mensaje 1
El encargo, en seis bloques
Es la plantilla de la sesión 5 rellenada. Fíjate en el contexto: dice qué falla hoy y que los datos no pueden salir del ordenador.
Desliza el diagrama de lado para verlo entero
Rol, contexto y tarea
# RolEres desarrollador de aplicaciones web educativas y conoces cómo se evalúa por criterios en FP y en ESO y Bachillerato de la Comunitat Valenciana.# ContextoSoy docente y evalúo por criterios. En FP, cada módulo tiene resultados de aprendizaje (RA) con un peso en la nota final, y cada RA tiene criterios de evaluación (CE) con su peso dentro del RA. En ESO y Bachillerato es igual con competencias específicas y criterios de evaluación. Hoy lo llevo en una hoja de cálculo que se rompe cada vez que cambio un peso. Son datos de mi alumnado: no pueden salir de mi ordenador.# TareaCrea el «Cuaderno de evaluación por criterios» en un único index.html, con cinco pestañas:1. Configuración: elegir modo FP (RA y CE) o modo ESO/Bachillerato (competencias específicas y criterios); los rótulos cambian según el modo. Bloques (RA o competencias) con nombre y peso, y criterios dentro de cada bloque con nombre y peso.2. Alumnado: lista por código (A01, A02…) o por nombre, con un aviso visible de que los datos solo están en este navegador.3. Actividades: nombre de la actividad o instrumento y qué criterios evalúa (uno o varios).4. Notas: tabla alumnado × actividades, con una nota de 0 a 10 en cada casilla.5. Resultados: nota de cada criterio, de cada bloque y nota final de cada alumno.Reglas, formato y control
# Reglas- Nota de un criterio = media de las actividades que lo evalúan. Nota de un bloque = media ponderada de sus criterios. Nota final = media ponderada de los bloques. Un criterio sin notas no cuenta y se avisa.- Aviso claro si los pesos de los bloques no suman 100, o si los de los criterios de un bloque no suman 100.- Guardar solo en localStorage. Exportar e importar una copia en JSON. Exportar las notas finales en CSV. Botón de imprimir con un estilo de impresión limpio.- Sigue las reglas de AGENTS.md.# FormatoUn solo fichero index.html en esta carpeta. Al acabar, explícame en cinco líneas cómo se usa y qué has decidido tú por tu cuenta.# ControlAntes de terminar, comprueba con un ejemplo pequeño (2 bloques, 3 criterios, 2 alumnos y 2 actividades) que las cuentas salen, y dime qué parte podría fallar con datos reales.La carpeta
Los dos ficheros de la carpeta
Antes del primer mensaje, la carpeta cuaderno-evaluacion solo tenía estos dos ficheros. Descárgalos y cambia lo que sea tuyo.
Desliza el diagrama de lado para verlo entero
AGENTS.md: qué es y quién la usa
# Cuaderno de evaluación por criterios## Qué esUna herramienta web para docentes: guarda los pesos de los criterios, las notas decada actividad y calcula la nota de cada criterio, de cada bloque y la final.## Quién la usaDocentes de la Comunitat Valenciana que evalúan por criterios:- FP: resultados de aprendizaje (RA) con su peso y criterios de evaluación (CE) dentro de cada RA.- ESO y Bachillerato: competencias específicas con su peso y criterios de evaluación dentro de cada una.No saben programar: todo lo que vean tiene que entenderse sin explicaciones.AGENTS.md: lo que no se rompe
## Reglas que no se rompen- Un único fichero: index.html, con el HTML, el CSS y el JavaScript dentro.- Sin librerías, sin CDN y sin internet: tiene que funcionar abriéndolo con doble clic.- Los datos solo se guardan en este navegador (localStorage). Nada se envía a ningún sitio.- Todo en castellano. Notas de 0 a 10, con un decimal y coma decimal.- Accesible: cada campo con su etiqueta, se maneja con el teclado y el contraste se lee bien.- Modo claro y oscuro según el sistema.## Cómo trabajar- Antes de un cambio grande, explica tu plan en cinco líneas.- Haz solo lo que se pide en cada mensaje y di qué has cambiado.- No borres ficheros ni salgas de esta carpeta.opencode.json: los permisos
{ "$schema": "https://opencode.ai/config.json", "permissions": [ { "action": "edit", "resource": "*", "effect": "ask" }, { "action": "shell", "resource": "*", "effect": "ask" }, { "action": "webfetch", "resource": "*", "effect": "ask" }, { "action": "external_directory", "resource": "*", "effect": "deny" } ], "policies": [ { "action": "tool.use", "resource": "shell:rm *", "effect": "deny" }, { "action": "tool.use", "resource": "shell:del *", "effect": "deny" }, { "action": "tool.use", "resource": "shell:Remove-Item *", "effect": "deny" }, { "action": "tool.use", "resource": "shell:sudo *", "effect": "deny" } ], "agents": { "plan": { "permissions": [{ "action": "edit", "resource": "*", "effect": "deny" }] }, "explore": { "permissions": [{ "action": "edit", "resource": "*", "effect": "deny" }] } }}La conversación
La cadena real, mensaje a mensaje
Ocho mensajes. Después de cada versión la probamos con datos conocidos y con las pruebas del alumno trasto; cada fallo, un mensaje.
Desliza el diagrama de lado para verlo entero
1. El plan, sin tocar nada
Agente PlanSin cambios en ficheros34 s
El mensaje: una frase pidiendo el plan y, debajo, el encargo entero de arriba.
Lo que propuso el plan
Lo que leímos del plan
2. Luz verde, con las dudas resueltas
Agente BuildResultado: v1
Respuestas a tus dudas: 1) sí, avisa y calcula igual. 2) No borres nada al cambiar de modo: solo cambian los rótulos. 3) sí, vacía = no evaluado. 4) De acuerdo con todo.Adelante: construye el index.html siguiendo el plan.Lo que hizo en la v1
Lo que probamos de la v1
3. Que una nota mal escrita no borre nada
Agente BuildResultado: v26 × Permitir una vez2 min 5 s
He probado la pestaña Notas como lo haría el alumno más trasto y hay un fallo que me puede hacer perder notas:- Si escribo «abc» en una casilla que tenía un 5, el 5 desaparece sin avisar.- Si escribo 11, la casilla enseña 11,0 pero se guarda un 10.Quiero que una nota no válida no cambie nada en silencio: la casilla se marca en rojo, sale un aviso que diga qué está mal y se conserva la nota anterior. Arregla solo esto y dime qué has cambiado.Lo que hizo en la v2
Lo que probamos de la v2
4. Rótulos que se lean bien
Agente BuildResultado: v38 × Permitir una vez1 min 12 s
Tres detalles de los textos que se ven raros:- En Resultados, en modo FP, la columna dice «Nota ra»: debe decir «Nota RA».- En Configuración, el botón dice «Añadir ce»: debe decir «Añadir CE» (y en modo ESO, «Añadir criterio»).- Si un alumno no tiene nombre, sale «A01 ·» con un punto colgando: que salga solo «A01».Arregla solo esto y dime qué has cambiado.Lo que hizo en la v3
Lo que probamos de la v3
5. Un botón para probarla en un minuto
Agente BuildResultado: v43 × Permitir una vez1 min 24 s
Quiero añadir una sola cosa: un botón «Cargar ejemplo» en Configuración que rellene un ejemplo pequeño (2 bloques, 3 criterios, 3 alumnos con código, 2 actividades y sus notas) para que un compañero pueda probar la herramienta en un minuto.Si ya hay datos, tiene que pedir confirmación antes de sustituirlos y recordar que exporte una copia.No cambies nada de lo que ya funciona. Antes de tocar el fichero, dime en tres líneas cómo lo vas a hacer.Lo que hizo en la v4
Lo que probamos de la v4
6. El aviso, alumno por alumno
Agente BuildResultado: v53 × Permitir una vez1 min 15 s
He cargado el ejemplo y en Resultados dice «Todos los criterios tienen notas», pero a A03 le falta el CE1.2. Me dijiste que se vería el aviso y no se ve.Quiero que el aviso diga qué alumnos tienen criterios sin nota, por ejemplo «A03: falta CE1.2», para saber que su nota final es provisional. Que «Todos los criterios tienen notas» solo salga cuando sea verdad para todo el alumnado.Arregla solo esto y dime qué has cambiado.Lo que hizo en la v5
Lo que probamos de la v5
7. Nombres enteros en Resultados
Agente BuildResultado: v62 × Permitir una vez28 s
En la tabla de Resultados, el nombre de un criterio sale cortado a mitad de palabra: «CE2.1. Configura l».Quiero ver el nombre entero: si es largo, que pase a una segunda línea dentro de su columna, también al imprimir.Arregla solo esto y dime qué has cambiado.Lo que hizo en la v6
Lo que probamos de la v6
8. El pie que cuenta cómo se hizo
Agente BuildResultado: v71 × Permitir una vez10 s
Última cosa: añade al final de la página un pie discreto que diga «Hecho con OpenCode y el modelo gratuito GLM-5.3-Flash Free en el Seminario de IA para docentes. Cómo se hizo, mensaje a mensaje» y que esa última frase enlace a https://aulaenlanube.com/seminario-ia-docentes/tu-herramienta/ abriéndose en otra pestaña.Que el pie no salga al imprimir. No cambies nada más.Lo que hizo en la v7
Lo que probamos de la v7
Lo que se hizo sin pantalla, contado
Los mensajes 1 y 2 se enviaron desde un script, sin la interfaz: con una copia de las reglas que permitía editar dentro de la carpeta y prohibía las órdenes de terminal y la web. Del 3 al 8 se usó la interfaz web de OpenCode, y cada cambio se aprobó con Permitir una vez.
Ninguna línea de la herramienta se escribió a mano. Las respuestas del agente tenían alguna errata («lo arrreglo»), y una vez prometió algo que no hacía: por eso cada versión se prueba antes de pedir la siguiente.
Hazla tuya
Adáptala a tu materia o módulo
No hace falta tocar el código: el modo FP o ESO cambia los rótulos y tus bloques y criterios se escriben en Configuración. Si quieres que venga ya preparada, pídeselo al agente.
Desliza el diagrama de lado para verlo entero
FP o Secundaria: qué escribes
En FP
- Bloques = los RA de tu módulo, con el peso de tu programación.
- Criterios = los CE de cada RA, con su peso dentro del RA.
- Actividades = prácticas, pruebas, proyectos y la formación en empresa si la evalúas tú.
En ESO o Bachillerato
- Bloques = las competencias específicas de tu materia, con su peso.
- Criterios = los criterios de evaluación de cada competencia.
- Actividades = situaciones de aprendizaje, pruebas, cuaderno, exposiciones…
Que venga preparada para ti
Adapta el cuaderno a mi caso, sin cambiar cómo calcula:- Etapa y materia o módulo: [ETAPA, MATERIA O MÓDULO].- Mis bloques: [RA O COMPETENCIAS, CON SU PESO].- Mis criterios: [CRITERIOS DE CADA BLOQUE, CON SU PESO].- Cambia el ejemplo del botón «Cargar ejemplo» por uno de mi materia, con alumnado ficticio.Antes de tocar el fichero, dime en tres líneas qué vas a cambiar.Y después
Cómo pedirle mejoras
Igual que en la cadena: una cosa por mensaje, probada antes de pedir la siguiente, y una copia de cada versión que funcione.
Desliza el diagrama de lado para verlo entero
Las dos peticiones que más usarás
He probado [PANTALLA O BOTÓN] y hay un fallo:- Hago esto: [LO QUE HACES, PASO A PASO].- Pasa esto: [LO QUE VES].- Esperaba esto: [LO QUE DEBERÍA PASAR].Arregla solo esto y dime qué has cambiado.Quiero añadir una sola cosa: [LA MEJORA, EN UNA FRASE].Para qué me sirve: [EL MOMENTO DE CLASE EN QUE LA USARÉ].No cambies nada de lo que ya funciona. Antes de tocar el fichero, dime en tres líneas cómo lo vas a hacer.Ideas para la versión 8
- Pegar la lista de clase desde una hoja de cálculo, en vez de escribirla.
- Una columna de recuperación que sustituya la nota de un criterio.
- Una evaluación (1.ª, 2.ª, 3.ª) por pestaña, con la nota final de curso.
- Un informe por alumno para imprimir, con sus criterios pendientes.
