Édition de Documents LaTeX Éducatifs avec BFCours

Le système skill bfcours-latex + agent latex-main-worker

Formation GT IA & Maths LaTeX automatisé Package bfcours

Au programme

  1. Qu'est-ce que BFCours ?
  2. Le skill bfcours-latex
  3. L'agent latex-main-worker
  4. Workflow complet
  5. Environnements didactiques
  6. Architecture de projet
  7. Serveurs MCP utilisés
  8. Conseils pratiques

Qu'est-ce que BFCours ?

Un package LaTeX éducatif complet pour l'enseignement des mathématiques

  • Conçu pour les niveaux 6ème à Terminale
  • Environnements didactiques pré-stylés
  • Optimisé pour l'impression professionnelle
  • Système de compétences intégré

Appuyez sur ↓ pour voir les types de documents

Types de documents supportés

Cours

  • Définitions
  • Théorèmes & propriétés
  • Démonstrations
  • Exemples

Exercices

  • Énoncés structurés
  • Corrections détaillées
  • Espaces réponses élèves
  • Barèmes automatiques

Évaluations

  • Contrôles
  • Devoirs maison
  • Calcul automatique de points

Activités

  • Activités de découverte
  • Travaux dirigés
  • Fiches méthodes

Le skill bfcours-latex

Expert spécialisé pour l'édition de contenu LaTeX pédagogique

  • Édition de contenu uniquement (pas de compilation)
  • Maîtrise complète des conventions bfcours
  • Respect de l'encodage UTF-8 (accents français)
  • Intégration avec serveurs MCP

Appuyez sur ↓ pour voir les responsabilités

Séparation des responsabilités

IMPORTANT : Le skill se concentre UNIQUEMENT sur l'édition

Tâche Responsable
Créer un nouveau projet tex-document-creator
Compiler un document tex-compiling-skill
Éditer le contenu bfcours-latex

Conventions critiques bfcours

Appuyez sur ↓ pour voir chaque catégorie

Énumérations : tcbenumerate

OBLIGATOIRE : Remplace enumerate

\begin{tcbenumerate}[nbCol][nbStart][style]
    \tcbitem Premier item
    \tcbitem Deuxième item
\end{tcbenumerate}
  • nbCol : Nombre de colonnes (défaut : 1)
  • nbStart : Début de numérotation (défaut : 1)
  • style : num ou alph

Tableaux : tcbtab

OBLIGATOIRE : Remplace tabular

\begin{tcbtab}[Titre du tableau]{l|c|r}
Colonne 1 & Colonne 2 & Colonne 3\\
\hline
a & b & c\\
\end{tcbtab}

Différence critique : La première ligne EST l'en-tête (pas de \hline initial)

Formatage de texte

Commande Usage Exemple
\acc{} Accentuation (remplace \textbf) \acc{Calculer}
\voc{} OBLIGATOIRE pour vocabulaire \voc{dérivée}
\encadrer[]{} Encadrer résultat important \encadrer[red]{$f'(x)=2x$}
a$^{\circ}$ Degrés (format obligatoire) 90$^{\circ}$

\encadrer sort du mode maths : toujours ré-entrer avec $...$

Mise en page : MultiColonnes

\begin{MultiColonnes}{nbCol}[options]
    \tcbitem[raster multicolumn=2] Contenu large
    \tcbitem Contenu colonne 1
    \tcbitem Contenu colonne 2
\end{MultiColonnes}

CRITIQUE : Toujours laisser une ligne vide AVANT \begin{MultiColonnes}

Environnements didactiques

Chaque type de contenu a son environnement dédié

Appuyez sur ↓ pour voir chaque environnement

Syntaxe générale

\begin{Envname}[Titre Court]
contenu avec \acc{emphase} et \voc{vocabulaire}
\end{Envname}

Definition

Définitions mathématiques

Propriete

Propriétés et règles

Theoreme

Théorèmes importants

Demonstration

Démonstrations

Exemple

Exemples illustratifs

Remarque

Remarques pédagogiques

Environnement EXO (exercices)

\def\rdifficulty{1.5}  % Échelle 1 à 3
\begin{EXO}{Titre Compétence}{code_competence}

Énoncé avec instructions claires.
\tcbitempoint{2}\acc{Calculer} la valeur...

\exocorrection

Solution suivant la structure de l'énoncé.
\end{EXO}

Attribution des points :

  • 1 point : Action basique (calcul, rappel)
  • 2 points : Figure, tableau, production complexe
  • 5 points : Recherche (pas de cumul)

Espaces réponses élèves

Ligne courte

\repsim[1.5cm]{contenu}

Ligne adaptative

\tcfillcrep{texte}

Multiligne

\begin{crep}[extra lines=4]
Contenu de réponse
\end{crep}

L'agent latex-main-worker

Expert autonome en création de contenu pédagogique LaTeX

  • Totalement autonome : de la lecture à la compilation
  • Expertise complète en conventions bfcours
  • Utilise les serveurs MCP (compétences, encoding)
  • Responsable de la compilation finale

Appuyez sur ↓ pour voir le workflow

Objectif de l'agent

Rendre un document qui compile et respecte la demande

Édition

Utilise le skill bfcours-latex pour l'édition de contenu

Compilation

Gère la compilation et les corrections d'erreurs

Workflow complet de l'agent

Appuyez sur ↓ pour voir chaque étape

Étapes 1-2 : Lecture

0
Lire le document : Comprendre la structure existante
1
Charger les connaissances : Lire les fichiers de référence bfcours

Fichiers lus :

  • main-latex-knowledge.md : Conventions essentielles
  • usecase/* : Exemples professionnels réels

Étape 3 : Documentation

2
Lire les ressources : Si fournies par l'utilisateur
3
Utiliser les environnements : Appliquer les conventions bfcours

L'agent sélectionne les exemples pertinents via Grep

Étapes 4-6 : Correction et compilation

4
Corriger l'encodage : Utiliser encoding-fixer-server (UTF-8)
5
Compiler : Via quick_compile.py (1 passe)
6
Corriger erreurs : Itération jusqu'à compilation réussie

Étapes 7-8 : Validation finale

7
Analyser le PDF : Vérifier le rendu visuel via pdf-analyzer-server
8
Vérifier les erreurs mathématiques : Détecter les erreurs invisibles dans le code

Résultat : Document compilé et validé !

Architecture de projet type

Nom_projet/ ├── Nom_projet.tex # Fichier principal à compiler │ # Nommé d'après le répertoire ├── VERSION_Nom_projet.tex # Variantes (ex: ELEVE_Nom_projet.tex) ├── enonce.tex # Contenu principal importé ├── enonce_TOOLS.tex # Si présent, prioritaire sur enonce.tex ├── enonce_figures.tex # Figures TikZ indexées ├── images/ # Répertoire d'images [optionnel] │ └── *.png ├── sections/ # Pour gros documents [optionnel] │ └── fichiers.tex # Contenu réparti └── annexes/ # Scripts secondaires [optionnel] └── scripts.py

Appuyez sur ↓ pour voir les détails

Fichiers principaux

Nom_projet.tex

  • Fichier maître à compiler
  • En-têtes LaTeX
  • Imports globaux
  • Tableau des compétences

enonce.tex

  • Contenu principal
  • Importé dans le fichier maître
  • Édité par l'agent

Si enonce_TOOLS.tex existe, il remplace enonce.tex

Fichiers optionnels

enonce_figures.tex

Figures TikZ indexées :

\tikzfig{ABCD}

sections/

Pour gros documents :

  • Contenu réparti
  • Organisation modulaire

Serveurs MCP utilisés

Les serveurs MCP fournissent des capacités spécialisées

Appuyez sur ↓ pour voir chaque serveur

competences-server

Cadre de compétences de l'éducation française

  • advanced_search(query, niveau) : Chercher des compétences
  • get_competence_by_code(code) : Détails d'une compétence
  • filter_by_niveau(niveau) : Compétences par niveau

Exemple :

advanced_search("vecteurs", "1ere_spe")

→ Retourne les codes de compétences pour les exercices

encoding-fixer-server

CRITIQUE pour les accents français

  • fix_file_encoding(file_path, create_backup=false)

Toujours utilisé sans backup dans les workflows bfcours

latex-search-server

Documentation LaTeX et packages

  • search_fuzzy_command(query) : Recherche floue
  • search_exact_command(command) : Documentation exacte
  • search_in_specific_package(package, query) : Package spécifique

pdf-analyzer-server

Analyse du PDF compilé pour validation

  • Vérifier les informations du fichier compilé
  • Détecter des erreurs visuelles
  • Valider le rendu final

latex-compiler-server

Compilation automatisée via quick_compile.py

python .claude\skills\tex-compiling-skill\scripts\quick_compile.py \
  --file "chemin\vers\mon_cours.tex" \
  --passes 2

Compilation avec LuaLaTeX : shell-escape, synctex, nonstopmode

Exemple concret : Créer un cours sur les dérivées

Commande utilisateur :

"Écris un cours sur les dérivées pour la 1ère spécialité"

Appuyez sur ↓ pour voir le processus

Processus automatique (1/3)

1
L'agent lit le projet et les connaissances bfcours
2
Cherche des exemples de cours dans usecase/
3
Crée le contenu avec environnements didactiques

Processus automatique (2/3)

\begin{Definition}[Nombre dérivé]
Soit $f$ une fonction définie sur un intervalle $I$
et $a \in I$. On dit que $f$ est \voc{dérivable}
en $a$ si le taux d'accroissement...
\end{Definition}

\begin{Propriete}[Dérivées usuelles]
Les \acc{fonctions usuelles} admettent les dérivées suivantes :
\begin{tcbenumerate}[2]
    \tcbitem $f(x) = x^n \Rightarrow f'(x) = nx^{n-1}$
    \tcbitem $f(x) = \sin(x) \Rightarrow f'(x) = \cos(x)$
\end{tcbenumerate}
\end{Propriete}

Processus automatique (3/3)

4
Corrige l'encodage UTF-8 automatiquement
5
Compile le document (LuaLaTeX)
6
Vérifie le PDF généré

Résultat : Cours compilé et prêt à imprimer !

Conseils pratiques

Appuyez sur ↓ pour voir chaque conseil

Règles d'or

NE JAMAIS

  • enumerate → Utiliser tcbenumerate
  • tabular → Utiliser tcbtab
  • \textbf → Utiliser \acc

TOUJOURS

  • Utiliser \voc{} pour vocabulaire
  • Corriger l'encodage après édition
  • Ligne vide avant \begin{MultiColonnes}

BONNES PRATIQUES

  • Verbes d'action en \acc{}
  • Utiliser tcbenumerate[2] pour économiser l'espace
  • Attribution réfléchie des points (\tcbitempoint)
  • Tester la compilation fréquemment

Ligatures françaises

IMPORTANT : Toujours utiliser \oe au lieu de œ

Incorrect (Unicode) Correct (LaTeX)
nœud n\oe ud
cœur c\oe ur
œil \oe il
sœur s\oe ur

Optimisation de l'espace

MultiColonnes

  • Utiliser raster multicolumn pour contenu large
  • Imbriquer pour organisation complexe

tcbenumerate

  • Privilégier [2] colonnes
  • Reprendre numérotation avec [nbCol][nbStart]

Niveaux scolaires supportés

Collège

Niveau Code LaTeX
6ème $\mathbf{6^{\text{ème}}}$
5ème $\mathbf{5^{\text{ème}}}$
4ème $\mathbf{4^{\text{ème}}}$
3ème $\mathbf{3^{\text{ème}}}$

Lycée

Niveau Code LaTeX
2nde $\mathbf{2^{\text{nde}}}$
1ère spé $\mathbf{1^{\text{ère}}}$
Terminale $\mathbf{T^{\text{Le}}}$

Avantages du système bfcours

Pour l'enseignant

  • Création rapide de ressources professionnelles
  • Cohérence visuelle garantie
  • Gestion automatique des compétences
  • Calcul automatique des barèmes
  • Correction automatique de l'encodage

Pour les élèves

  • Documents lisibles et aérés
  • Espaces de réponse adaptés
  • Navigation claire (table des matières)
  • Couleurs didactiques cohérentes

Gain de temps considérable : focus sur la pédagogie, pas la mise en forme !

Résultats typiques

Temps de création

  • Lecture des connaissances : 30 sec
  • Création du contenu : 2-5 min
  • Compilation + validation : 1-2 min
  • Corrections éventuelles : 1-2 min

Total : ~5-10 minutes

Qualité

  • Document compilé et validé
  • Conventions bfcours respectées
  • Encodage UTF-8 correct
  • Prêt à imprimer

Zéro intervention manuelle !

vs création manuelle : gain de temps de 70-80%

Structure des références

.claude/skills/bfcours-latex/ ├── SKILL.md # Instructions pour agents ├── references/ │ ├── bfcours-conventions.md # Conventions complètes ⭐ │ └── exemples-usecases.md # Exemples professionnels .claude/agents/ ├── latex-main-worker.md # Agent principal .claude/agents-data/ ├── main-latex-knowledge.md # Connaissances essentielles └── usecase/ # Exemples réels par type ├── cours_partie1/ # Cours complexe atomique ├── cours_partie2/ # Cours simple ├── exercices_*/ # Exercices par partie ├── evaluation/ # Contrôles ├── devoir_maison/ # DM └── td/ # Travaux dirigés

Appuyez sur ↓ pour voir comment les utiliser

Comment utiliser les références

Lecture systématique

bfcours-conventions.md : Toujours lu en premier

Recherche ciblée

Utiliser Grep dans usecase/ pour trouver des patterns spécifiques

Exemple :

Grep "\\begin{EXO}" --path ".claude/agents-data/usecase/"

→ Trouve tous les exemples d'exercices

Cas d'usage avancés

Appuyez sur ↓ pour voir des exemples

Édition d'un cours existant

Commande : "Ajoute une section sur les équations du second degré"

1
Lire la structure actuelle du cours
2
Charger bfcours-conventions.md
3
Écrire nouvelle section avec environnements Definition, Propriete, Exemple
4
Compiler et valider

Création rapide d'exercices

Commande : "Écris 5 exercices sur les vecteurs pour 1ère"

1
Chercher compétences avec competences-server
2
Créer 5 environnements EXO avec codes de compétences
3
Attribution des points avec \tcbitempoint
4
Corrections détaillées

Enrichir avec compétences

Commande : "Ajoute les codes de compétences aux exercices sur les vecteurs"

1
Lire le document existant
2
competences-server: advanced_search("vecteurs", "1ere_spe")
3
Identifier les compétences pertinentes
4
Éditer chaque environnement EXO pour ajouter le code

Limitations et contraintes

Compilation

  • Requiert LuaLaTeX
  • shell-escape nécessaire
  • Peut prendre 10-30 sec

Encodage

  • Toujours UTF-8
  • Correction automatique requise
  • Accents français sensibles

Structure

  • Architecture stricte à respecter
  • Nommage conventionnel
  • Ne pas modifier les fichiers maîtres manuellement

Apprentissage

  • Conventions nombreuses
  • Courbe d'apprentissage initiale
  • Agent automatise mais besoin de compréhension

En résumé

Points forts

  • Création automatisée de ressources LaTeX
  • Qualité professionnelle garantie
  • Conventions bfcours respectées
  • Gestion des compétences intégrée
  • Compilation et validation automatiques
  • Gain de temps considérable

À retenir

  • Toujours utiliser les environnements bfcours
  • Jamais enumerate, tabular, \textbf
  • Toujours \voc{} pour vocabulaire
  • Encodage UTF-8 critique
  • L'agent gère tout automatiquement

Système complet pour créer des ressources pédagogiques LaTeX de qualité professionnelle en quelques minutes !

Ressources

Skill bfcours-latex

  • SKILL.md - Instructions skill
  • bfcours-conventions.md - Conventions complètes
  • exemples-usecases.md - Exemples

Agent latex-main-worker

  • latex-main-worker.md - Configuration agent
  • main-latex-knowledge.md - Connaissances
  • usecase/ - Exemples réels professionnels

Serveurs MCP

  • competences-server - Cadre des compétences
  • encoding-fixer-server - Correction UTF-8
  • latex-search-server - Documentation LaTeX
  • latex-compiler-server - Compilation automatisée
  • pdf-analyzer-server - Validation PDF

Questions ?