Modèles d'activités

Cinq modèles prêts à l'emploi transforment la scène courante d'une leçon en activité interactive que vos étudiants ouvrent dans un navigateur : une page autonome, les consignes destinées à leur assistant et le format de la trace d'actions qu'ils peuvent exporter. Vous adaptez données, unités, sources et critères dans un petit fichier de configuration. Préparer une activité n'exécute aucun code récupéré, n'installe rien, n'approuve aucune leçon et ne soumet aucune réponse.

Modèle L'apprenant
linked-representations Suit des identifiants stables entre une table d'arêtes, un graphe de pics et une table de candidats
parameter-comparison Garde une entrée fixe, fait varier un paramètre et compare référence et variante
evidence-claim Lit un énoncé de source fourni et choisit l'affirmation la plus étroite qu'il soutient
diagnose-analysis Examine les étapes d'une analyse, désigne une erreur probable et compare les corrections fournies
conclusion-robustness Compare des scénarios d'hypothèses à un seuil de décision explicite

Le skill studium-activity-templates permet à votre assistant de faire ces étapes pour vous (voir skills). Un déroulé complet figure dans le tutoriel de l'activité au rapport.

Préparer une activité

.venv/bin/python tools/experience_templates.py list
.venv/bin/python tools/experience_templates.py prepare \
  --template linked-representations --context operator-context.json --out activity-linked

--context est le contexte public de la scène, le JSON que votre assistant obtient avec l'outil MCP get_operator_context (ou dans task.md avec le canal fichier). --out ne doit pas exister. list --json affiche le catalogue complet ; une entrée marquée proposée n'est pas exécutable.

Option Usage
--config FICHIER.json Adapter le modèle ; exemples dans examples/activity-templates/<modèle>/config.json
--language, --translations Langue de présentation et dictionnaires de traduction
--supports FICHIER.json Figures, équations, chimie, médias (voir médias et supports visuels)

Une configuration est fermée : champs inconnus, nombres non finis, identifiants dupliqués, identifiants de modèle discordants et sources incomplètes sont refusés avant toute écriture. Les valeurs de référence et les variantes d'un curseur doivent tomber sur sa grille de pas. Les modèles de paramètre, de preuve, de diagnostic et de robustesse acceptent soit des données synthétiques (data_status: "synthetic teaching fixture", source_kind: "synthetic_fixture"), soit des preuves fournies ("supplied source-backed data", "supplied_evidence"). Le modèle de spectres liés reste synthétique : il réutilise un noyau d'exemple vérifié et refuse un réseau dont les valeurs diffèrent de son oracle.

Le dossier produit contient :

Fichier Contenu
activity.json La définition validée et son rattachement à la scène
index.html La page locale autonome
task.md Les consignes modifiables pour l'assistant, avec les commandes exactes du rapport
learner-actions.schema.json Le schéma de la trace exportée
provenance.json Les empreintes des entrées et du générateur, et les limites de validation déclarées

Ce que l'étudiant voit et conserve

La page demande d'abord s'il faut garder une trace en mémoire. Sans trace, l'activité fonctionne quand même, et rien n'est reconstitué ensuite. Avec une trace, Exporter la trace de l’activité peut télécharger une trace partielle avant que les résultats soient révélés ; Terminer et exporter la trace finale ajoute l'événement de fin et verrouille les commandes. L'export porte le SHA-256 d'activity.json : une définition ultérieure avec les mêmes identifiants ne peut pas réinterpréter les événements.

.venv/bin/python tools/learner_trace.py validate LEARNER_ACTIONS.json
.venv/bin/python tools/learner_report.py export REPORT_DIR \
  --actions LEARNER_ACTIONS.json --activity activity-linked/activity.json
.venv/bin/python tools/learner_report.py verify REPORT_DIR

La page n'envoie rien sur le réseau et ne stocke rien automatiquement ; elle ne contient ni identité de l'apprenant ni clé de réponse, et ne garde le texte facultatif de l'apprenant que dans un téléchargement explicite. Le rapport est décrit dans rapport d'apprenant.

Diagnostiquer une analyse

Dans la configuration de diagnostic, les steps ont un id, un label et une description ; les repairs ont un id, un label, une explanation et un result numérique. Renseignez flawed_result, result_unit, supported_repair_id et oracle.repaired_result, qui doit égaler le résultat de la correction référencée. C'est un contrôle de cohérence, pas une vérification scientifique. Les sélections sont enregistrées sous step_<id> et repair_<id> ; l'étape choisie n'est pas notée automatiquement.

Tester la robustesse d'une conclusion

Dans la configuration de robustesse, chaque scenario a un id, un label, une assumption explicite et une value numérique. Renseignez baseline_scenario_id, metric.label, metric.unit et une decision avec operator (gte ou lte), threshold et une claim bornée. oracle.supporting_scenario_ids doit concorder avec les valeurs, dans l'ordre, égalité au seuil comprise. Une sélection est enregistrée sous scenario_<id>.

Les identifiants, préfixes compris, sont limités à 120 caractères. Les modèles comparent des résultats capturés ; aucune équation ni aucun code n'est évalué. Faites tourner les vraies analyses avec votre assistant, conservez leur provenance, puis régénérez l'activité à partir de ces sorties.

D'une discipline à l'autre

Le schéma de diagnostic convient à un mauvais dénominateur en écologie, une conversion d'unités en astronomie, une correction de blanc oubliée en chimie ou une erreur d'agrégation dans une enquête. Le schéma de robustesse convient à des estimations de fond alternatives, des hypothèses sur les données manquantes ou des choix d'étalonnage. Gardez termes et valeurs du domaine dans les fichiers de configuration, avec unités et localisation dans les sources.

Limites

  • Trois scénarios fournis n'estiment pas une probabilité de vérité, et le franchissement d'un seuil n'établit pas une causalité.
  • Les vérifications affichées après la révélation restent des consignes, sauf si un autre processus enregistre qu'elles ont été exécutées.
  • Ni la page ni son rapport ne mesurent l'apprentissage ni n'approuvent quoi que ce soit pour les étudiants : relisez l'objectif et l'interprétation d'un contenu sourcé avant la séance.

Code : tools/experience_templates.py.

Voir la source de cette page sur GitHub