¿Qué hace Creador de Exámenes?
Un buen examen cumple dos funciones a la vez: evalúa lo que alguien sabe y le enseña en el momento en que se equivoca. La mayoría de los exámenes generados automáticamente solo hacen lo primero: una pregunta escueta, una respuesta correcta, nada que ayude al estudiante a entender por qué. Esta habilidad existe para hacer bien el segundo trabajo. Cada pregunta incluye una explicación simplificada que el estudiante puede seguir realmente, la ecuación o derivación detrás del tema cuando es cuantitativo, y una cita real para que pueda profundizar y confiar en la respuesta.
El resultado es un único archivo HTML interactivo que el usuario puede abrir en un navegador, responder a su propio ritmo, autocorregirse, revelar derivaciones detalladas y obtener una puntuación. Debe sentirse como una herramienta de estudio bien hecha, no como una impresión.
La única regla que va primero: preguntar la dificultad antes de construir
La dificultad cambia todo en el examen: el vocabulario, si se muestra una derivación o solo se indica un resultado, cuántos pasos tiene un problema, cuánto se asume que el lector ya sabe. Por lo tanto, no se puede escribir una sola buena pregunta hasta conocer el nivel. Pregunte al usuario qué nivel desea antes de generar el examen, utilizando la herramienta AskUserQuestion con estas cinco opciones:
- Fundacional — primera exposición. Lenguaje sencillo, ejemplos concretos, jerga mínima, resultados presentados sin derivación. Piense en un principiante curioso o en los primeros años de secundaria.
- Intermedio — familiarizado con lo básico. Introduce la terminología estándar y razonamientos simples de uno o dos pasos. Piense en un buen estudiante de secundaria o principios de universidad.
- Avanzado — conocimiento sólido de trabajo. Problemas de múltiples pasos, fluidez esperada con el formalismo central, derivaciones cortas mostradas. Piense en los últimos años de universidad.
- Experto — dominio profundo. Casos límite no obvios, conexiones entre ideas, derivaciones completas esperadas. Piense en cursos de posgrado.
- PhD / Investigación — frontera del conocimiento. Suposiciones sutiles, debates actuales, derivaciones rigurosas, citas de literatura primaria. Piense en un examen de calificación o seminario de investigación.
Si el usuario ya indicó un nivel en su mensaje ("dame un examen difícil de nivel PhD sobre..."), asígnelo a la opción más cercana y confírmelo en lugar de volver a preguntar. Mientras pregunta la dificultad, también es eficiente confirmar el tema (si es difuso) y cuántas preguntas desean (por defecto 8) en la misma llamada de AskUserQuestion, pero la dificultad es lo que nunca debe omitir.
Obtener el tema correcto
Lea el contexto antes de preguntar. El tema puede ser obvio a partir del mensaje del usuario, las instrucciones del proyecto, los archivos en la carpeta o la conversación hasta ahora. Si el usuario trabaja en un campo especializado (su perfil o CLAUDE.md a menudo lo indica), adapte los ejemplos a su mundo en lugar de usar ejemplos genéricos: a un físico le interesa la antimateria y las secciones eficaces, no "una bola rodando cuesta abajo", a menos que lo haya pedido. Solo pida aclaración cuando el tema sea genuinamente ambiguo o demasiado amplio para hacer un examen coherente ("ciencia" es demasiado amplio; "relatividad especial — dilatación del tiempo y contracción de la longitud" es un examen).
Investigar y citar — nunca inventar
Cada explicación lleva una cita, y la cita debe ser real. Esta es la diferencia entre una herramienta de estudio en la que se puede confiar y una alucinación que suena plausible.
Para temas técnicos, científicos, médicos, históricos o de rápida evolución, busque en la web para fundamentar la explicación y obtener una fuente verificable: un libro de texto con edición y capítulo, un artículo de revisión con DOI, un organismo de normalización, un sitio de referencia de buena reputación. Prefiera fuentes primarias y autorizadas sobre blogs. Capture una URL o DOI real para que la cita enlace.
Para temas estables de conocimiento general en los que tenga alta confianza (aritmética básica, definiciones bien establecidas), está bien citar una referencia estándar de su conocimiento sin una búsqueda en vivo, pero nombre una fuente específica y verificable (por ejemplo, "Griffiths, Introduction to Electrodynamics, 4.ª ed., §2.3"), nunca un vago "libros de texto" o un número de página inventado.
Si no puede encontrar una fuente real para una afirmación, es una señal de que la afirmación puede ser dudosa: reformule la pregunta en torno a algo que pueda documentar, en lugar de inventar una cita. Falsificar una cita es peor que no tener ninguna.
Escribir las preguntas
Apunte a una mezcla que realmente ejercite la comprensión, no solo el recuerdo. Los buenos exámenes se apoyan en preguntas que hacen que el estudiante aplique una idea. Varíe el formato:
- Opción múltiple es la columna vertebral: se puede calificar automáticamente, y las opciones incorrectas son una oportunidad de enseñanza. Haga que los distractores sean plausibles: cada respuesta incorrecta debe corresponder a un error o concepto erróneo común y específico, de modo que elegirla le enseñe algo al estudiante. Evite opciones de broma descartables y pistas obvias.
- Preguntas numéricas / de respuesta corta son adecuadas para temas cuantitativos: el estudiante resuelve y verifica contra la respuesta con su solución detallada.
- Preguntas abiertas / de derivación piden al estudiante que razone o derive, luego revelan una respuesta modelo que él mismo evalúa. Úselas en niveles de dificultad más altos.
Para cada pregunta escriba:
- Un enunciado claro. Use LaTeX para cualquier expresión matemática (consulte la sección de formato): inline
\( ... \)o display\[ ... \]. - Una explicación simplificada de la respuesta correcta: el corazón de la habilidad. Explíquela como lo haría un buen tutor para alguien del nivel elegido: simple, directa, basándose en lo que ya sabe. Simplifique el lenguaje, no la corrección.
- Cuando sea cuantitativo, una derivación: una lista ordenada de pasos desde los primeros principios hasta el resultado, cada paso con una línea corta de razonamiento más su ecuación. El HTML revela estos bloques uno a la vez para que el estudiante pueda intentarlo antes de mirar.
- Una o más citas, cada una con una etiqueta y (idealmente) una URL/DOI.
Calibre la profundidad según la dificultad: en nivel Fundacional puede omitir la derivación y dar una analogía intuitiva; en nivel PhD la derivación es rigurosa y la cita es una fuente primaria.
Construir el HTML interactivo
Use la plantilla incluida en lugar de crear una página desde cero cada vez: ya maneja el renderizado de MathJax, la verificación de respuestas, el mantenimiento de la puntuación, el progreso, las derivaciones plegables y los enlaces de citas, y se ve limpio. Lea references/html-format.md para conocer el procedimiento de construcción completo y el esquema de datos QUIZ exacto, luego complete el bloque de datos de la plantilla con sus preguntas. No reescriba el CSS/JS de la plantilla desde cero; solo proporcione el contenido.
La página terminada debe permitir al estudiante: leer una pregunta con ecuaciones correctamente renderizadas, elegir o revelar una respuesta, obtener retroalimentación inmediata de correcto/incorrecto, expandir la explicación y la derivación paso a paso, seguir enlaces de citas y ver una puntuación en curso con un resumen al final. Una insignia de dificultad se encuentra en la parte superior para que sepa lo que está haciendo.
Entregar
Guarde el examen terminado como un único archivo .html en la carpeta de salida de habilidades que el usuario prefiera (según las convenciones del proyecto/memoria), asígnelo un nombre descriptivo (quiz-<tema>-<dificultad>.html) y preséntelo al usuario para que pueda abrirlo directamente. Mantenga su mensaje de cierre breve: el examen habla por sí mismo. Ofrézcase a ajustar la dificultad, agregar preguntas o acotar el tema como seguimiento natural.
Indicar suposiciones
Si tuvo que tomar una decisión que afecta la corrección (asumió una convención (signo, unidades, notación), eligió un lado de un punto genuinamente debatido, o no pudo verificar completamente una fuente), dígalo brevemente cuando entregue el examen, para que el usuario pueda ponerlo a prueba. Las suposiciones silenciosas en una herramienta de estudio se propagan a lo que alguien aprende.