steffen74/to-quiz

To quiz (Al cuestionario)

Escribe y publica el cuestionario para una unidad. Lee COURSE-CANVAS.md, PLAN.md, RESOURCES.md, DECISIONS.md, la sección ## Agentic course creation de AGENTS.md y el material de la unidad anterior (los videos y tareas que cubre el cuestionario). Carga assumed-knowledge.

1. Herramienta y fuente

AGENTS.md debe tener una línea - Quizzes: <archivo fuente>, tool <nombre>, connector <nombre|none>, establecida en /setup-course. Si falta, pregunta una vez, recomienda y escríbela:

• Fuente: un archivo en el repositorio privado del curso contiene cada pregunta con opciones, respuesta correcta y explicación (un CSV con las columnas session, type, question, option_a, option_b, option_c[, option_d], correct, explanation, o Markdown que lo refleje). La herramienta de cuestionarios es una copia, nunca la fuente.
• Herramienta: elegida una vez por curso, por ejemplo Microsoft Forms o Formbricks. La puntuación es opcional; la mayoría de los controles de video solo necesitan la distribución de respuestas para discutir en clase.

2. Escribe las preguntas

Redacta de tres a cinco preguntas para la unidad, cada una con:

• una pregunta sobre algo que los estudiantes encontraron antes de la sesión: los videos y tareas de la unidad anterior. Nunca preguntes sobre contenido que la sesión misma introduce.
• tres o cuatro opciones, una correcta; las opciones incorrectas son los malentendidos que los estudiantes realmente tienen (de SIGNALS.md cuando esté disponible), no preguntas capciosas.
• una explicación de una o dos oraciones, para que el instructor la use en clase.
• un tipo: video, task o skill, con su fuente.

Basa las preguntas en lo que el material realmente dice. Cuando una pregunta se base en un video que no puedes leer, márcala solo por el título en la explicación; el instructor la verifica contra el video.

Muestra las preguntas y espera al instructor. Luego escríbelas en la fuente.

3. Crear en la herramienta

• Conector conectado para la herramienta: muestra el cuestionario tal como se creará, espera un sí, créalo como borrador y registra su enlace de compartir. Construye la solicitud desde la fuente del cuestionario en el esquema propio del conector (lee sus descripciones de herramientas; los esquemas cambian entre versiones) y usa primero su herramienta de validación si la tiene.
  • Formbricks tiene un servidor MCP oficial con inicio de sesión OAuth (https://app.formbricks.com/api/mcp, o https://<dominio>/api/mcp cuando está autoalojado; las herramientas incluyen list_workspaces, validate_survey, create_survey). Si el curso usa Formbricks y no está conectado, dale al instructor el comando para agregarlo a su agente (en Claude Code: claude mcp add --transport http formbricks https://app.formbricks.com/api/mcp, luego inicia sesión a través de /mcp); no cambies su configuración de agente tú mismo.
  • Microsoft Forms no tiene API para crear cuestionarios ni conector oficial; usa la exportación a continuación.
• Sin conector: exporta con scripts/export_quiz.py desde la fuente CSV:
  • Formbricks: --format formbricks escribe un cuerpo de encuesta para la API de Administración e imprime el comando curl. El instructor lo ejecuta con su propia clave API desde una variable de entorno; nunca pidas la clave ni la escribas en un archivo.
  • Microsoft Forms: --format forms escribe un .docx para Importación rápida y una clave de respuestas. La Importación rápida no acepta respuestas correctas; el instructor las marca con la clave (solo necesario cuando se usa puntuación).
  • Otra herramienta: escribe el formato de importación más cercano que acepte, o una lista simple para pegar.

Las respuestas y explicaciones nunca aparecen en un archivo visible para los participantes ni en una ubicación pública.

4. Entrega

Registra el enlace del cuestionario en RESOURCES.md para la unidad (columna Quiz). Las diapositivas muestran el enlace (y un código QR, donde el formato de diapositiva lo permita), no las preguntas; /to-slides lo toma de RESOURCES.md.

Terminado cuando las preguntas están en la fuente, el cuestionario existe en la herramienta como borrador o un archivo de importación está listo con instrucciones, y su enlace o estado está en RESOURCES.md.