p123p2000/synbio-igem-skills

Organise le contenu de synthèse biologique validé (cours, présentations, soutenances) en fiches de présentation structurées avec points de déclenchement, preuves et notes de transition, avec pagination longue, distribution multi-intervenants et index des sources, en HTML ou PDF imprimable.

Qu'est-ce que synbio-igem-skills ?

Cette compétence transforme des contenus de biologie synthétique déjà vérifiés (tels que des cours, des présentations orales ou des soutenances) en fiches de présentation structurées spécialement conçues pour une utilisation en direct. Elle agit comme une interface cognitive pour l'orateur, en évitant les notes réduites et illisibles. Le système génère d'abord une organisation narrative, puis utilise un outil local pour produire des jeux de fiches traçables. Chaque fiche intègre cinq éléments clés : le point de déclenchement (quand tourner la fiche), le discours principal (ce qui doit être dit), l'ancre de preuve (sources, données), l'action de présentation (pause, question, transition) et le détenteur (rôle réel). La compétence prend en charge la pagination des longs contenus, la distribution par intervenant (chaque personne reçoit un sous-jeu avec des identifiants partagés), et un index complet des sources. Elle est destinée aux plateformes comme Cursor, Claude Code et autres outils de codage local. Le workflow inclut la vérification du scénario, l'utilisation d'un modèle JSON, l'exécution du script Python `scripts/cue_cards.py` (HTML avec bibliothèque standard, PDF nécessitant ReportLab et une police TrueType), et une validation rigoureuse avant impression. La compétence ne modifie pas les fichiers existants, ne lit pas les URL, n'exécute pas les commandes, et refuse les contenus en dehors du texte (formules, graphiques, images, texte enrichi).

Compatible avec~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/p123p2000/synbio-igem-skills/tree/HEAD/skills/synbio-cue-cards

Documentation

Fiche de Présentation en Direct

La fiche de présentation est l'interface cognitive en direct, ce n'est pas un script réduit en petits caractères. Cette compétence organise d'abord la tâche de présentation, puis utilise un outil local original pour générer des jeux de fiches traçables ; elle n'effectue pas de révision scientifique et ne produit pas de fichiers Word.

Syntaxe des Fiches

Chaque fiche définit cinq éléments, puis les mappe dans des champs JSON :

Point de déclenchement : Quand tourner cette fiche, écrire dans title ou au début du corps.
Discours principal : Le contenu qui doit être dit en direct, écrit dans body.
Ancre de preuve : Les sources, données ou limites à vérifier, écrit dans source.
Action de présentation : Pause, question, démonstration ou indication de transition, écrit dans notes.
Détenteur : Un ou plusieurs rôles réels, écrit dans speaker ; ne pas deviner la répartition en fonction du nom ou du sexe.

Pour une fiche de question, les points attendus peuvent être placés dans les notes de la version enseignant ; lors de la création de la version étudiant, les réponses sont supprimées de la copie d'entrée. Les notes sont imprimées, ce ne sont pas des commentaires cachés.

Flux de Génération

Confirmer d'abord le scénario, le ou les intervenants, la taille des fiches, la distance d'utilisation et le format de sortie. Les conclusions scientifiques, données expérimentales, accréditations de concours et approbations de personnes doivent être vérifiées avant la création des fiches.
Créer la structure à partir du modèle vierge, remplir selon le guide d'utilisation ; l'exemple de simulation pédagogique ne sert que de référence de format.
Exécuter scripts/cue_cards.py. Le mode HTML n'utilise que la bibliothèque standard Python ; le PDF nécessite ReportLab et une police TrueType fournie par l'utilisateur, librement intégrable et couvrant les caractères chinois requis.
Vérifier l'intégralité du jeu total, des sous-jeux par intervenant, de l'appartenance des fiches communes, des numéros de fiches, de l'ordre de continuation, de l'index complet des sources et des caractères du corps.
Rendu page par page pour le PDF ; utiliser l'aperçu avant impression du navigateur cible pour le HTML. Enregistrer le support vérifié, ne pas assimiler la visualisation sur écran à la validation réelle pour l'impression.

Contrat de Mise en Page

Par défaut, une fiche par page, dimensions 150×100 mm. Corps par défaut en 13 pt ; la taille et la police peuvent être ajustées en ligne de commande.
Le contenu long est prioritairement divisé en suites aux points de phrase ou de saut de ligne ; s'il ne peut pas tenir complètement, il continue à être divisé en fiches sans supprimer silencieusement des caractères.
Le jeu total et les sous-jeux partagent des numéros de fiches stables ; les fiches détenues par plusieurs personnes entrent dans le sous-jeu de chaque détenteur.
Chaque page affiche la source ; si la source est trop longue, elle renvoie vers le fichier index.html inclus dans le paquet, et la valeur complète est conservée à la fois dans le JSON d'index et le HTML.
En cas de police manquante, d'impossibilité de placer le titre, de JSON non valide ou de dossier de sortie déjà existant, une erreur est renvoyée. Le programme ne supprime ni n'écrase activement les anciens résultats.

Le modèle d'entrée ne conserve pas les formules, graphiques scientifiques, images ou texte enrichi. Si la tâche nécessite la conversion fidèle de ces contenus, il faut utiliser un outil de document ou de présentation. Cet outil ne lit que le JSON local, n'accède pas aux URL qu'il contient et n'exécute pas les commandes dans le corps.

Pour une première utilisation, lire l'introduction ; les méthodes de répétition et d'évaluation se trouvent dans le guide pédagogique. Lors de la transition vers une plateforme de cours ou un module vidéo, conserver les numéros de fiches stables et les ancres de source, afin que la présentation en direct puisse être retracée jusqu'au contenu original.