Révision pédagogique - Détection d'ambiguïtés

Ce skill détecte et documente les passages ambigus dans les documents pédagogiques destinés aux étudiants.

Workflow de révision

Étape 1: Lecture et analyse du document

Identifier le type et format du document
- Énoncé de TP, consignes d'évaluation, grille critériée, guide, politique, etc.
- Format: DOCX, PDF, MD, TXT, PPTX, ou image avec texte
Détecter la discipline pédagogique
- Analyser le vocabulaire, les concepts et le contexte
- Identifier la discipline: Sciences, Sciences humaines, Arts, Santé, Gestion, Techniques, Informatique, ou autre
- Cette détection permet d'adapter les exemples dans les suggestions de solutions
Extraire le contenu textuel
- Documents texte: lire directement
- DOCX: utiliser python-docx pour extraction
- PDF: utiliser pdfplumber pour extraction de texte
- PPTX: extraire texte des diapositives
- Images: utiliser reconnaissance optique si texte présent
Charger les références nécessaires
- Lire references/ambiguites-pedagogiques.md pour les 12 types d'ambiguïtés à détecter
- Lire references/format-sortie.md pour le format du tableau de révision
- Lire references/adaptation-discipline.md pour adapter les solutions au contexte disciplinaire

Étape 2: Détection des ambiguïtés

Parcourir le document de façon séquentielle et identifier les ambiguïtés selon les 12 types:

Références floues - Pronoms sans antécédent clair
Instructions contradictoires - Contradictions dans le document
Conditions implicites - Conditions non spécifiées
Termes non définis - Jargon sans définition
Dates/délais ambigus - Indications temporelles imprécises
Quantités floues - Valeurs numériques vagues
Critères subjectifs - Évaluation sans indicateurs mesurables
Séquences imprécises - Étapes sans ordre clair
Portée floue - Inclus/exclu mal défini
Responsabilités ambiguës - Qui fait quoi pas clair
Suppositions non vérifiées - Contexte supposé non partagé
Formats mal spécifiés - Livrables sans spécifications

Pour chaque ambiguïté détectée:

Noter la localisation précise (page/section/diapo)
Extraire l'extrait problématique (contexte suffisant)
Identifier le type d'ambiguïté
Formuler la raison du problème
Proposer une solution concrète

Étape 3: Génération du tableau de révision

Trier les ambiguïtés par ordre d'apparition (séquentiel)
- Par page/section croissante
- Par ordre dans le texte si même page
- ❌ Ne PAS grouper par type (cela force des sauts)
Adapter les solutions à la discipline détectée
- Utiliser un vocabulaire et des exemples appropriés à la discipline
- Sciences: protocoles, expériences, données
- Sciences humaines: analyses, sources, théories
- Arts: œuvres, démarches, créations
- Santé: patients, soins, protocoles cliniques
- Gestion: marchés, stratégies, analyses financières
- Techniques: procédures, spécifications, normes
- Informatique: code, architecture, systèmes
Créer le tableau avec les colonnes obligatoires:
- N° (séquentiel: 1, 2, 3...)
- Localisation (Page X, Section Y, Diapo Z)
- Extrait (citation entre guillemets)
- Type (utiliser termes standardisés)
- Raison (1-2 phrases claires)
- Solution suggérée (action concrète recommandée, adaptée à la discipline)
Ajouter un résumé en haut du document:
- Discipline détectée (préciser la discipline identifiée)
- Total d'ambiguïtés détectées
- Répartition par type
- Optionnel: niveau de priorité (critique/important/mineur)
Format de sortie:
- Document court (< 5 pages): tableau Markdown simple
- Document moyen (5-15 pages): résumé + tableau
- Document long (> 15 pages): résumé exécutif + top problèmes + tableau complet

Étape 4: Livraison du résultat

Créer le fichier Markdown dans /mnt/user-data/outputs/
- Nom: revision_[nom-document]_[date].md
Présenter au format lisible avec:
- Titre clair
- Résumé des statistiques
- Tableau complet séquentiel
- Légende des types d'ambiguïtés
Offrir export optionnel en XLSX si l'utilisateur le demande explicitement

Principes de détection

Contexte pédagogique

Toujours considérer le public cible (étudiants) et se demander:

Un étudiant qui lit ceci pour la première fois comprendrait-il clairement?
Y a-t-il plusieurs interprétations possibles?
Quelles questions l'étudiant pourrait-il se poser?
Les attentes sont-elles explicites et mesurables?

Sensibilité à l'ambiguïté

Être plus strict pour:

Critères d'évaluation (impact direct sur la note)
Dates limites (risque de malentendu sur remise)
Instructions de remise (format, procédure)
Conditions d'application (pénalités, bonus)

Être moins strict pour:

Texte narratif ou explicatif
Exemples illustratifs
Contexte général du cours

Faux positifs à éviter

Ne PAS signaler comme ambiguïté:

Pronoms avec antécédent clair dans la phrase précédente
Termes définis plus tôt dans le document
Références à des ressources externes clairement identifiées
Variations stylistiques acceptables (synonymes, paraphrases)

Cas particuliers

Documents multilingues

Analyser uniquement la langue principale
Signaler si instructions critiques seulement dans une langue

Documents avec annexes

Traiter les annexes comme sections séparées
Vérifier que les références aux annexes sont claires

Documents avec tableaux/diagrammes

Vérifier que les éléments visuels sont référencés clairement dans le texte
Signaler si tableaux complexes sans légende explicative

Versions multiples d'un document

Si plusieurs versions analysées, identifier les changements qui créent ambiguïtés
Signaler les incohérences entre versions

Exemple de sortie

# Révision pédagogique - Laboratoire d'analyse chimique

## Résumé
- **Discipline détectée:** Sciences naturelles (Chimie)
- **Total d'ambiguïtés détectées:** 8
- **Distribution:**
  - Référence floue: 3
  - Date/délai ambigu: 2
  - Condition implicite: 2
  - Format mal spécifié: 1

## Tableau de révision séquentiel

| N° | Localisation | Extrait | Type | Raison | Solution suggérée |
|----|--------------|---------|------|--------|-------------------|
| 1 | Page 1 | "Vous devez le remettre avant..." | Référence floue | Le pronom "le" pourrait référer au rapport, aux calculs ou aux observations. | Remplacer par: "Vous devez remettre **le rapport de laboratoire complet** avant..." |
| 2 | Page 1 | "Deadline: vendredi prochain à minuit" | Date/délai ambigu | "Vendredi prochain" est relatif. "Minuit" peut signifier début ou fin de journée. | Spécifier: "Date limite: vendredi 15 novembre 2025 à 23h59" |
| 3 | Page 2 | "L'équipe doit produire un rapport" | Responsabilité ambiguë | Pas de précision sur la contribution individuelle ou l'évaluation. | Ajouter: "Chaque membre sera évalué selon sa contribution documentée dans le cahier de laboratoire et le rapport d'analyse." |

Notes importantes

Ce skill ne fait PAS de révision linguistique OQLF - il se concentre uniquement sur les ambiguïtés pédagogiques
Le tableau est toujours séquentiel pour faciliter la révision sans sauts dans le document
Les solutions suggérées sont des pistes, pas des corrections imposées
L'analyse considère le contexte pédagogique et la perspective de l'étudiant

Références

references/ambiguites-pedagogiques.md - Guide complet des 12 types d'ambiguïtés avec exemples
references/format-sortie.md - Spécifications détaillées du format de tableau de révision
references/adaptation-discipline.md - Guide d'adaptation du vocabulaire et des solutions selon la discipline détectée