steffen74/to-quiz

To quiz

Rédiger et publier le quiz pour une unité. Lire COURSE-CANVAS.md, PLAN.md, RESOURCES.md, DECISIONS.md, la section ## Agentic course creation de AGENTS.md, et le matériel de l'unité précédente (les vidéos et tâches que le quiz couvre). Charger assumed-knowledge.

1. Outil et source

AGENTS.md doit contenir une ligne - Quizzes: <fichier source>, outil <nom>, connecteur <nom|aucun>, définie dans /setup-course. Si elle est absente, demander une fois, recommander et l'écrire :

• Source : un seul fichier dans le dépôt privé du cours contient chaque question avec les options, la bonne réponse et l'explication (un CSV avec les colonnes session, type, question, option_a, option_b, option_c[, option_d], correct, explanation, ou du Markdown qui le reflète). L'outil de quiz est une copie, jamais la source.
• Outil : choisi une fois par cours, par exemple Microsoft Forms ou Formbricks. La notation est facultative ; la plupart des vérifications vidéo n'ont besoin que de la distribution des réponses pour en discuter en classe.

2. Rédiger les questions

Proposer trois à cinq questions pour l'unité, chacune avec :

• une question sur quelque chose que les apprenants ont rencontré avant la séance : les vidéos et tâches de l'unité précédente. Ne jamais demander le contenu que la séance elle-même introduit.
• trois ou quatre options, dont une correcte ; les mauvaises options sont les malentendus que les apprenants ont réellement (depuis SIGNALS.md si disponible), pas des questions pièges.
• une explication d'une ou deux phrases, à l'usage de l'enseignant en classe.
• un type : video, task ou skill, avec sa source.

Baser les questions sur ce que le matériel dit réellement. Lorsqu'une question repose sur une vidéo que vous ne pouvez pas lire, la marquer from the title only dans l'explication ; l'enseignant la vérifie par rapport à la vidéo.

Afficher les questions et attendre l'enseignant. Puis les écrire dans la source.

3. Créer dans l'outil

• Connecteur connecté pour l'outil : afficher le quiz tel qu'il sera créé, attendre un oui, le créer en tant que brouillon, et enregistrer son lien de partage. Construire la requête à partir de la source du quiz dans le propre schéma du connecteur (lire ses descriptions d'outil ; les schémas changent entre versions), et utiliser d'abord son outil de validation s'il en a un.
  • Formbricks possède un serveur MCP officiel avec connexion OAuth (https://app.formbricks.com/api/mcp, ou https://<domain>/api/mcp en auto-hébergement ; les outils incluent list_workspaces, validate_survey, create_survey). Si le cours utilise Formbricks et qu'il n'est pas connecté, donner à l'enseignant la commande pour l'ajouter à son agent (dans Claude Code : claude mcp add --transport http formbricks https://app.formbricks.com/api/mcp, puis se connecter via /mcp) ; ne pas modifier sa configuration d'agent vous-même.
  • Microsoft Forms n'a pas d'API pour créer des quiz ni de connecteur officiel ; utiliser l'export ci-dessous.
• Pas de connecteur : exporter avec scripts/export_quiz.py à partir de la source CSV :
  • Formbricks : --format formbricks écrit un corps de sondage pour l'API Management et affiche la commande curl. L'enseignant l'exécute avec sa propre clé API depuis une variable d'environnement ; ne jamais demander la clé ni l'écrire dans un fichier.
  • Microsoft Forms : --format forms écrit un .docx pour Quick Import et une clé de correction. Quick Import n'accepte pas les réponses correctes ; l'enseignant les coche à partir de la clé (uniquement nécessaire si la notation est utilisée).
  • Autre outil : écrire le format d'import le plus proche qu'il accepte, ou une simple liste à coller.

Les réponses et explications n'apparaissent jamais dans un fichier destiné aux participants ni dans un emplacement public.

4. Transmission

Enregistrer le lien du quiz dans RESOURCES.md pour l'unité (colonne Quiz). Les diapositives affichent le lien (et un code QR, lorsque le format de diapositive le permet), pas les questions ; /to-slides le prend depuis RESOURCES.md.

Terminé lorsque les questions sont dans la source, le quiz existe dans l'outil en tant que brouillon ou qu'un fichier d'import est prêt avec des instructions, et que son lien ou son statut se trouve dans RESOURCES.md.