Création Automatique de Projets LaTeX

Le skill tex-document-creator et l'agent document-creator-worker

Formation GT IA & Maths Automatisation LaTeX

Au programme

  1. Présentation du système
  2. Le skill tex-document-creator
  3. L'agent document-creator-worker
  4. Types de documents disponibles
  5. Workflow complet en 9 étapes
  6. Scripts Python disponibles
  7. Architecture de projet
  8. Exemples pratiques

Le problème à résoudre

Création manuelle de documents LaTeX

  • Temps : 15-30 min par document
  • Répétitif : copier-coller de templates
  • Erreurs : oublis de fichiers, structure incohérente
  • Organisation : arborescence à créer manuellement
  • Remplissage : champs à modifier un par un

La solution : Automatisation complète

Créer un projet LaTeX complet en une seule commande

Le skill

  • Modèles prédéfinis
  • Scripts Python automatisés
  • Structure cohérente
  • Remplissage intelligent

L'agent

  • Analyse de requête
  • Choix du template
  • Placement intelligent
  • Rapport détaillé

Le skill tex-document-creator

Système expert pour l'initialisation automatique de projets LaTeX

  • Création de structure de dossiers
  • Remplissage intelligent de templates
  • Configuration initiale automatique
  • Utilisation proactive lors de création

Appuyez sur ↓ pour voir la règle critique

RÈGLE CRITIQUE

NE JAMAIS créer manuellement des fichiers ou dossiers LaTeX

TOUJOURS utiliser les scripts Python via Bash

Pourquoi ?

  • ✅ Création automatique de tous fichiers/dossiers
  • ✅ Remplissage correct des templates
  • ✅ Structure cohérente garantie
  • ✅ Rapport détaillé de création

Types de documents disponibles

Enseignement

  • Cours - Cours avec sections
  • Exercices heavy - Avec corrections
  • Exercices light - Sans corrections
  • Découverte - Activité investigation
  • AP - Accompagnement personnalisé

Évaluation

  • Devoir - DS / Contrôle
  • Devoir_maison - DM avec date rendu

Organisation

  • Plan sequence - Planification
  • Recap_seance - Récapitulatif
  • Rapport incident

Appuyez sur ↓ pour voir d'autres modèles

Autres modèles disponibles

Activités

  • Groupe - Travail de groupe
  • Jeux - Jeux mathématiques
  • Info - Activité algorithmique

Divers

  • SOUAP - Documents spécifiques
  • Nouveau - Document générique

15 modèles disponibles couvrant tous les besoins pédagogiques

Scripts Python disponibles

Localisation : .claude/skills/tex-document-creator/scripts/

Appuyez sur ↓ pour voir chaque script

1. create_document.py

SCRIPT PRINCIPAL - Création automatique de documents LaTeX

python .claude/skills/tex-document-creator/scripts/create_document.py \
  --destination "CHEMIN_ABSOLU" \
  --name "Nom_Document" \
  --template "Nom_Template" \
  --field "niveau=..." \
  --field "theme=..." \
  [--create-sections] \
  [--create-images] \
  [--create-annexes]
  • --field : Format recommandé (répétable)
  • --fields '{"json":"..."}' : Format legacy

2. Scripts de consultation

list_templates.py

Liste tous les templates disponibles

python list_templates.py

get_template_info.py

Informations sur un template

python get_template_info.py \
  --template "Cours"

3. Scripts de préférences

  • get_user_preferences.py - Affiche les préférences
  • update_user_preferences.py - Met à jour les préférences
  • add_user_habit.py - Enregistre une habitude
  • remove_user_habit.py - Supprime une habitude

Exemple : Enregistrer établissement par défaut

python update_user_preferences.py \
  --preference "nom_etablissement" \
  --value "Lycée Eugène Belgrand"

4. get_help.py

Affiche l'aide générale du système

python .claude/skills/tex-document-creator/scripts/get_help.py

8 scripts disponibles pour tous les besoins

L'agent document-creator-worker

Expert autonome pour la création de projets LaTeX

  • Analyse de requête utilisateur
  • Choix du template approprié
  • Création via serveur MCP
  • Placement dans l'arborescence
  • Rapport détaillé

Appuyez sur ↓ pour voir comment il fonctionne

Serveur MCP document-creator-server

Interface entre l'agent et les scripts Python

Fonctions disponibles

  • list_templates()
  • get_template_info()
  • create_document()
  • get_user_preferences()
  • update_user_preferences()

Avantages

  • Appels directs depuis Claude
  • Pas de Bash nécessaire
  • Gestion d'erreurs intégrée
  • Retour structuré JSON

Ce que l'agent fait automatiquement

1
Analyse : type, niveau, thème du document
2
Vérifie l'arborescence existante (LS/Glob)
3
Consulte les modèles disponibles (MCP)
4
Remplit intelligemment les champs
5
Crée le projet via MCP

Workflow complet en 9 étapes

Exemple : "Je veux une évaluation sur les vecteurs en seconde"

Appuyez sur ↓ pour suivre le processus

Étape 1 : Analyse de la requête

Extraction

  • Type : Devoir
  • Niveau : 2nde
  • Thème : vecteurs

Normalisation

  • Modèle : Devoir
  • Niveau : 2nde
  • Thème : vecteurs

Étape 2 : Vérification de l'arborescence

# L'agent vérifie avec LS ou Glob
1. Cours/
  └── 2nde/
      ├── Sequence-Vecteurs/  # Existe ?
      └── ...

Si la séquence existe : Utiliser son nom exact

Sinon : Créer Sequence-Vecteurs

Étape 3 : Consultation MCP

1
list_templates() - Lister les modèles
2
get_template_info("Devoir") - Champs requis

Champs retournés :

  • niveau, theme, type_etablissement
  • nom_etablissement, duree
  • type_document_principal, contenu_principal

Étape 4 : Détermination du chemin

Chemin de base :

C:\Users\Utilisateur\Documents\Professionnel\1. Reims 2025 - 2026\1. Cours\
+
Niveau : 2nde
+
Séquence : Sequence-Vecteurs

Résultat :

...\1. Cours\2nde\Sequence-Vecteurs\

Nom : Evaluation_vecteurs

Étape 5 : Remplissage intelligent des champs

Champs communs

  • niveau: "$\mathbf{2^{\text{nde}}}$"
  • theme: "Vecteurs"
  • type_etablissement: "Lycée"
  • nom_etablissement: ""

Champs spécifiques

  • duree: "55"
  • type_document_principal: "Devoir :"
  • contenu_principal: "\input{enonce},"

Étape 6 : Options de création

Option Valeur Description
create_folder true Créer le dossier du document
create_sections_folder false Pour Cours uniquement
create_images_folder false Si demandé explicitement
create_figures_file true Fichier enonce_figures.tex
include_claude_instructions true Fichier CLAUDE.md

Étape 7 : Création via MCP

create_document(
    destination_path = "C:\\...\\1. Cours\\2nde\\Sequence-Vecteurs",
    document_name = "Evaluation_vecteurs",
    template_name = "Devoir",
    field_values = {
        "niveau": "$\\mathbf{2^{\\text{nde}}}$",
        "theme": "Vecteurs",
        "type_etablissement": "Lycée",
        "nom_etablissement": "",
        "duree": "55",
        "type_document_principal": "Devoir :",
        "contenu_principal": "\\input{enonce},"
    },
    create_folder = true,
    create_figures_file = true,
    include_claude_instructions = true
)

Étape 8 : Enrichissement pédagogique

Compétences associées

Utilisation de competences-server pour identifier les compétences pertinentes

Exemple pour "Vecteurs - 2nde" :

  • Chercher : Coordonnées de vecteurs
  • Représenter : Vecteurs dans un repère
  • Calculer : Somme de vecteurs

Étape 9 : Rapport de création

📄 DOCUMENT LATEX CRÉÉ AVEC SUCCÈS

Type : Devoir | Niveau : 2nde | Thème : Vecteurs

📂 EMPLACEMENT

Dossier : ...\1. Cours\2nde\Sequence-Vecteurs\

Fichier : Evaluation_vecteurs.tex

✅ VÉRIFICATIONS

  • ✓ Encodage UTF-8 corrigé
  • ✓ Structure complète créée
  • ✓ Instructions Claude intégrées

Architecture de projet type

Exemple : Cours sur les vecteurs en 2nde

Appuyez sur ↓ pour voir la structure

Structure complète générée

Cours_Vecteurs/ ├── Cours_Vecteurs.tex # Fichier maître ├── enonce.tex # Contenu principal ├── enonce_figures.tex # Figures/images ├── CLAUDE.md # Instructions pour Claude └── sections/ # Sections du cours ├── section_1.tex ├── section_2.tex └── section_3.tex

Tout est créé automatiquement en une seule commande

Avec options supplémentaires

Evaluation_vecteurs/ ├── Evaluation_vecteurs.tex # Fichier maître ├── enonce.tex # Énoncé du devoir ├── enonce_figures.tex # Figures ├── CLAUDE.md # Instructions ├── images/ # Si --create-images │ └── .gitkeep └── annexes/ # Si --create-annexes └── .gitkeep

Options activées selon le type de document

Exemples pratiques

Appuyez sur ↓ pour voir chaque exemple

Exemple 1 : Évaluation simple

Requête : "Une évaluation sur les vecteurs en seconde, 55 minutes"

1
Analyser : type=Devoir, niveau=2nde, theme=vecteurs, duree=55
2
Vérifier répertoire : 1. Cours\2nde\Sequence-Vecteurs
3
Créer : Evaluation_vecteurs

Exemple 2 : Cours avec sections

Requête : "Nouveau cours sur les fonctions pour la première"

python create_document.py \
  --destination "...\1. Cours\1ere_spe\Sequence-Fonctions" \
  --name "Cours_Fonctions" \
  --template "Cours" \
  --field "niveau=$\\mathbf{1^{\\text{ère}}}$" \
  --field "theme=Fonctions de référence" \
  --field "type_etablissement=Lycée" \
  --field "nom_etablissement=Amadis Jamyn" \
  --field "type_document_principal=Cours :" \
  --field "contenu_principal=\\input{enonce}," \
  --create-sections

Exemple 3 : DM complexe

Requête : "Un DM sur le produit scalaire et les équations de droites en première"

Analyse

  • Type : Devoir_maison
  • Niveau : 1ere_spe
  • Thème : produit_scalaire

Champs spécifiques

  • date_rendu: "lundi 20 janvier"
  • contenu_secondaire pour solutions

Exemple 4 : Exercices avec corrections

Requête : "Des exercices sur les probabilités en terminale avec corrections détaillées"

1
Modèle : Exercices heavy (corrections détaillées)
2
Champ : contenu_secondaire: "\rdexocorrection[columns=1]{0},"

Astuce : Pour exercices simples sans corrections → Exercices light

Champs communs à tous les modèles

Tous les modèles utilisent ces champs dans \chapitre[]

Appuyez sur ↓ pour voir chaque champ

Niveau et thème

niveau

Niveau LaTeX formaté

  • Sixième : $\mathbf{6^{\text{ème}}}$
  • Seconde : $\mathbf{2^{\text{nde}}}$
  • Première : $\mathbf{1^{\text{ère}}}$
  • Terminale : $\mathbf{T^{\text{Le}}}$

theme

Thème du document

  • Vecteurs
  • Équations
  • Probabilités
  • Produit scalaire
  • etc.

Établissement

type_etablissement

Type d'établissement

  • "Collège" (6e-3e)
  • "Lycée" (2nde-Term)

nom_etablissement

Nom de l'établissement

  • "Amadis Jamyn"
  • "Eugène Belgrand"
  • "Othe et Vanne"
  • Ou vide ""

Type et contenu

type_document_principal

Type affiché en en-tête

  • "Cours :"
  • "Devoir :"
  • "Exercices"
  • "Activité"

contenu_principal

Contenu du document

Par défaut : \input{enonce},

Supplément optionnel

supplement

Éléments supplémentaires optionnels

Pour cours :

  • \tableofcontents
  • \tableauPresenteEvalSixieme{}{10}

Par défaut :

Vide ""

Champs spécifiques selon modèle

Chaque modèle peut avoir des champs supplémentaires

Appuyez sur ↓ pour voir par modèle

Modèle Devoir

duree

Durée en minutes de l'évaluation

Valeurs courantes :

  • 10 minutes (contrôle rapide)
  • 15 minutes
  • 30 minutes
  • 55 minutes (1 heure)

Format dans template :

\tableauEval{55}

Modèle Devoir_maison

date_rendu

Date de rendu du DM

Formats acceptés :

  • "JJ/MM/AAAA"
  • "lundi 15 janvier"
  • "15 janvier 2025"

Utilisation :

\messageDevoir

"Devoir à rendre pour le ..."

Modèles Exercices heavy/light

type_document_secondaire

Pour la page de solutions

Par défaut : "Solution"

contenu_secondaire

Contenu des solutions

  • \input{solutions}
  • \rdexocorrection[columns=1]{0}
  • \rdexocorrection[columns=2]{0}

Modèle Cours

Le cours inclut automatiquement :

  • \tableaucompetence{\competence{nobug}}
  • \printvocindex
  • \voc{nobug}

Option recommandée :

--create-sections pour créer le dossier sections/

Règles critiques

JAMAIS de création manuelle
Toujours via scripts Python

Vérifier modèle existant
list_templates.py d'abord

Tous les champs requis
get_template_info.py avant

Chemins absolus
Jamais de chemins relatifs

Corriger l'encodage
encoding-fixer après création

Confirmer avant écrasement
Ne jamais écraser sans demander

Avantages du système

Appuyez sur ↓ pour voir tous les avantages

Gain de temps

Avant

  • Créer dossiers : 2 min
  • Copier template : 3 min
  • Remplir champs : 5 min
  • Vérifier structure : 3 min
  • Créer fichiers auxiliaires : 2 min

Total : 15 minutes

Maintenant

  • Demande à l'agent : 10 sec
  • Création automatique : 5 sec
  • Vérification : 1 min

Total : ~1-2 minutes

Gain : ~90%

Qualité et cohérence

  • Structure garantie : tous les fichiers nécessaires
  • Pas d'oublis : templates complets
  • Cohérence : formatage identique
  • Encodage correct : UTF-8 automatique
  • Instructions Claude : CLAUDE.md inclus

Flexibilité

Personnalisation

  • Préférences utilisateur
  • Habitudes enregistrées
  • Templates personnalisables

Évolutivité

  • Nouveaux modèles faciles
  • Champs ajustables
  • Scripts extensibles

Workflow typique

1
Demande à Claude : "Je veux un cours sur les suites en première"
2
L'agent analyse → type=Cours, niveau=1ere_spe, theme=suites
3
Vérification arborescence → Sequence-Suites existe ?
4
Création via MCP → tous fichiers générés
5
Rapport détaillé → Vous commencez à remplir le contenu

Simple, rapide, efficace !

Commande vague → Résultat expert

Vous dites

"Je veux des exercices sur les fractions"

L'agent comprend

  • Type : Exercices light
  • Niveau : à préciser ?
  • Thème : fractions
  • Structure complète

Appuyez sur ↓ pour voir le processus

L'agent fait le travail pour vous

  • Analyse intelligente du besoin
  • Choix optimal du modèle
  • Remplissage automatique des champs
  • Placement cohérent dans l'arborescence
  • Configuration adaptée (sections, images, etc.)

Vous n'avez plus qu'à remplir le contenu pédagogique !

Structure du skill

.claude/skills/tex-document-creator/ ├── SKILL.md # Instructions pour agents ├── scripts/ │ ├── create_document.py # Script principal │ ├── list_templates.py # Liste templates │ ├── get_template_info.py # Info template │ ├── get_user_preferences.py # Préférences │ ├── update_user_preferences.py # MAJ préférences │ ├── add_user_habit.py # Ajouter habitude │ ├── remove_user_habit.py # Supprimer habitude │ └── get_help.py # Aide générale ├── references/ │ └── scripts_to_use.md # Guide des scripts └── templates/ ├── Cours.tex ├── Devoir.tex ├── Devoir_maison.tex ├── Exercices_heavy.tex ├── Exercices_light.tex └── ...

Serveur MCP document-creator

Interface entre l'agent et les scripts Python

Appuyez sur ↓ pour voir les fonctions

Fonctions MCP disponibles

list_templates()

Liste tous les modèles

get_template_info()

Info détaillée sur un modèle

create_document()

Création du projet

get_user_preferences()

Récupère préférences

update_user_preferences()

MAJ préférences

get_help()

Aide générale

Avantages du serveur MCP

  • Appels directs depuis Claude
  • Pas de Bash nécessaire
  • Gestion d'erreurs intégrée
  • Retour JSON structuré
  • Appels synchrones fiables

Résultats typiques

Temps de création

  • Requête utilisateur : 10 sec
  • Analyse agent : 5 sec
  • Création projet : 5 sec
  • Vérification : 1 min

Total : ~1-2 minutes

Qualité

  • Structure complète : 100%
  • Champs remplis : 100%
  • Encodage correct : 100%
  • Erreurs : 0%

Perfection garantie !

vs création manuelle : gain de temps de 90%

En résumé

Points forts

  • Création automatique complète
  • 15 modèles prêts à l'emploi
  • Gain de temps : ~90%
  • Structure cohérente garantie
  • Agent intelligent
  • Serveur MCP intégré

Conseils

  • Toujours passer par les scripts
  • Vérifier l'arborescence avant
  • Utiliser get_template_info
  • Enregistrer vos préférences
  • Laisser l'agent travailler

Concentrez-vous sur le contenu pédagogique, pas sur la structure technique !

Ressources

Documentation skill

  • SKILL.md - Instructions agents
  • references/scripts_to_use.md - Guide scripts

Documentation agent

  • .claude/agents/document-creator-worker.md

Scripts

.claude/skills/tex-document-creator/scripts/

Questions ?