Saltar al contenido
Aula en la nube
Ejemplo resuelto · Sesión 5FP y Secundaria

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

Las seis, una a una

Corregir y evaluar · el ejemplo

Cuaderno de evaluación por criterios

Pesos de RA y CE (FP) o de competencias y criterios (ESO y Bachillerato), notas por actividad y la nota final calculada, sin hojas de cálculo frágiles.

Planificar

Planificador del curso

Sesiones semanales, festivos y horas de cada unidad: la temporalización sale sola y se imprime.

Corregir

Generador de rúbricas y feedback

Tus criterios se convierten en rúbricas con cuatro niveles y en hojas de comentarios listas para devolver.

Preparar clases

Banco de preguntas para Aules

Escribes o pegas preguntas y la herramienta las exporta en GIFT o Moodle XML para importarlas en Aules.

Preparar clases

Biblioteca de prompts de tu materia

Tus mejores prompts con huecos que se rellenan desde tu ficha: eliges, copias y pegas en Copilot.

Planificar (FP)

Seguimiento de la formación en empresa

Empresas, alumnado en prácticas, visitas y actividades del plan formativo en un solo panel.

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

Modo FP o ESO/Bachillerato. Bloques (RA o competencias) y criterios, cada uno con su peso. Avisa si no suman 100.

2. Alumnado

Por código (A01, A02…) o por nombre. Un aviso fijo recuerda que los datos solo están en este navegador.

3. Actividades

Cada actividad o instrumento, con las casillas de los criterios que evalúa: uno o varios.

4. Notas

Una tabla alumnado × actividades, de 0 a 10 con coma. Vacía significa «no evaluado», no un cero.

5. Resultados

Nota de cada criterio, de cada bloque y final, con aviso de quién tiene criterios pendientes.

Copia, CSV e imprimir

Copia de seguridad en JSON, notas finales en CSV para tu hoja de cálculo y una versión limpia para 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.

Examen 1nota 8Práctica 1nota 6,5CE1.160 % del RA1 · 8,0CE1.240 % del RA1 · 6,5CE2.1100 % del RA2 · 8,0RA1pesa 40 % · 7,4RA2pesa 60 % · 8,0Nota final7,76 → 7,8

Desliza el diagrama de lado para verlo entero

Cada actividad alimenta sus criterios; los criterios, su RA; los RA, la nota final. Compruébalo con calculadora.

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.

Rolquién es el agenteContextoquién eres y qué te pasaTarealas pantallas, una a unaReglascálculos y límitesFormatoun index.html y 5 líneasControlque lo compruebe él antes

Desliza el diagrama de lado para verlo entero

Rol, contexto y tarea

Encargo real · parte 1 de 2
# 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

Encargo real · parte 2 de 2
# 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.

Lo que el agente puede tocarcuaderno-evaluacionAGENTS.md · la memoriaopencode.json · las reglasindex.html · tu herramientaFuera de la carpetaDocumentostus otros ficherosEscritorioy todo lo demás✕external_directory: denyel agente no sale de aquí

Desliza el diagrama de lado para verlo entero

Abre siempre una carpeta vacía, solo para la herramienta: lo que no está ahí, el agente no lo toca.

Descargar AGENTS.md · Descargar opencode.json

AGENTS.md: qué es y quién la usa

AGENTS.md · parte 1 de 2
# 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

AGENTS.md · parte 2 de 2
## 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

opencode.json
{  "$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.

El plan5 pantallas, 3 dudasv135 KB, cuentas bienv2«abc» ya no borrav3rótulos en ordenv4botón de ejemplov5aviso por alumnov6nombres enterosv7pie: cómo se hizo

Desliza el diagrama de lado para verlo entero

En rosa, los fallos que salieron al probar; en verde, las mejoras pedidas. Una cosa por mensaje.

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

En 34 segundos propuso cinco pestañas, guardar todo en el navegador bajo una sola clave y medias ponderadas que ignoran lo no evaluado. Planteó tres dudas y, por su cuenta, decidió borrar todos los datos al cambiar de modo FP / ESO.

Lo que leímos del plan

Leímos el plan entero: en mitad de un nombre interno se le coló texto en chino («alumnoId的活动Id»). No importa en un plan, pero recuerda que lo que escribe la IA se lee antes de aceptarlo.

2. Luz verde, con las dudas resueltas

Agente BuildResultado: v1

Mensaje 2, literal
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

Escribió un index.html de unos 35 KB con las cinco pestañas, la copia en JSON, el CSV y la impresión. Dijo haber comprobado las cuentas con su propio ejemplo.

Lo que probamos de la v1

Cargamos un ejemplo con resultado conocido (7,32 y 4,0): las cuentas, bien. Pero «abc» borraba una nota sin avisar, un 11 se guardaba como 10 y había rótulos en minúsculas.

3. Que una nota mal escrita no borre nada

Agente BuildResultado: v26 × Permitir una vez2 min 5 s

Mensaje 3, literal
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

La casilla se pone en rojo, un aviso explica qué está mal y, al salir de la casilla, vuelve la nota anterior.

Lo que probamos de la v2

Repetimos «abc» sobre un 5 y un 11: las notas guardadas no cambian y los cálculos siguen igual.

4. Rótulos que se lean bien

Agente BuildResultado: v38 × Permitir una vez1 min 12 s

Mensaje 4, literal
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

Arregló los tres y, por su cuenta, un cuarto del mismo tipo que no le habíamos dicho: «¿Quitar este ce?».

Lo que probamos de la v3

«Nota RA», «Añadir CE» y «A01» sin punto colgando. Revisamos que no tocara nada más.

5. Un botón para probarla en un minuto

Agente BuildResultado: v43 × Permitir una vez1 min 24 s

Mensaje 5, literal
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

Antes de tocar nada explicó su plan en tres líneas. Añadió «Cargar ejemplo» con tres alumnos ficticios y aseguró que el ejemplo enseñaría el aviso de criterio sin notas.

Lo que probamos de la v4

Las notas del ejemplo, comprobadas con calculadora: 7,8 · 6,7 · 6,0. Pero el aviso prometido no salía: decía «Todos los criterios tienen notas» aunque a A03 le faltaba uno.

6. El aviso, alumno por alumno

Agente BuildResultado: v53 × Permitir una vez1 min 15 s

Mensaje 6, literal
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

El aviso miraba criterio a criterio en toda la clase; ahora mira alumno por alumno: «Notas pendientes: A03 · falta CE1.2».

Lo que probamos de la v5

Con el ejemplo cargado sale el aviso de A03; al ponerle la nota que falta, desaparece.

7. Nombres enteros en Resultados

Agente BuildResultado: v62 × Permitir una vez28 s

Mensaje 7, literal
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

Encontró que cortaba los nombres a 18 caracteres. Quitó el corte y dejó que el nombre baje a una segunda línea.

Lo que probamos de la v6

«CE2.1. Configura los parámetros del equipo», entero, en pantalla y en la vista de impresión.

8. El pie que cuenta cómo se hizo

Agente BuildResultado: v71 × Permitir una vez10 s

Mensaje 8, literal
Ú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

Añadió el pie con el enlace a esta página y lo ocultó al imprimir.

Lo que probamos de la v7

El enlace abre esta página en otra pestaña y el pie no sale en la vista de impresión.

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.

Módulo profesionalFormación ProfesionalRA con su pesoresultado de aprendizajeCE con su pesodentro de cada RAMateriaESO y BachilleratoCompetencia y pesocompetencia específicaCriterio y pesodentro de su competenciael modo FP o ESO solo cambia los rótulos: las cuentas son las mismas

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

Prompt · OpenCode (agente Build)
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.

Pruebaúsala de verdadAnota un fallosolo unoPídeloqué pasa y qué esperabasCompruebaque se arregló y nada másuna cosa por petición

Desliza el diagrama de lado para verlo entero

«Arréglalo todo» devuelve un revoltijo; una cosa por petición, y compruebas cada una.

Las dos peticiones que más usarás

Prompt · un fallo
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.
Prompt · una mejora
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.