rhetorical-analysis

# Skill d'analyse rhétorique et épistémologique Ce skill permet d'analyser systématiquement la qualité argumentative d'un texte en combinant plusieurs frameworks établis. ## Frameworks d'analyse intégrés ### 1. Modèle de Toulmin (structure argumentative) Pour chaque argument identifié, extraire : - **Claim** : La thèse défendue - **Grounds** : Les preuves/données avancées - **Warrant** : Le lien logique implicite entre preuves et thèse - **Backing** : Les éléments qui soutiennent ce lien logique - **Qualifier** : Les nuances ou restrictions de la thèse - **Rebuttal** : Les contre-arguments reconnus ou ignorés ### 2. Test CRAAP (fiabilité des sources) Pour chaque source citée, évaluer : - **Currency** : Actualité de l'information - **Relevance** : Pertinence pour le propos - **Authority** : Crédibilité de l'auteur/source - **Accuracy** : Vérifiabilité et exactitude - **Purpose** : Intention (informer, persuader, vendre...) ### 3. Catalogue des sophismes Voir `references/fallacies-catalog.md` pour la liste complète des sophismes à détecter. ### 4. Échelle de fiabilité (1-5) - **5** : Fait établi, consensus scientifique, sources multiples vérifiables - **4** : Sources sérieuses, raisonnement logique valide, nuances possibles - **3** : Mélange faits/interprétations, sources partielles - **2** : Raisonnement contestable, sophismes identifiés - **1** : Affirmations non sourcées, erreurs logiques majeures ## Workflow d'analyse 1. **Segmentation** : Identifier les arguments distincts du texte 2. **Décomposition Toulmin** : Analyser chaque argument selon le modèle 3. **Évaluation des sources** : Appliquer le test CRAAP aux références 4. **Détection des sophismes** : Scanner pour les erreurs de raisonnement 5. **Synthèse** : Produire le tableau d'analyse et la synthèse critique ## Format de sortie ### Option 1 : Génération automatique via script 1. Produire l'analyse au format JSON (voir `assets/example_analysis.json` pour le schéma) 2. Exécuter le script de génération : ```bash python scripts/generate_analysis.py analysis.json output.[xlsx|json|md] --format [xlsx|json|md] ``` **Exemples :** ```bash python scripts/generate_analysis.py analysis.json rapport_analyse.xlsx --format xlsx python scripts/generate_analysis.py analysis.json analysis_output.json --format json python scripts/generate_analysis.py analysis.json rapport.md --format md ``` Le script génère un fichier de sortie selon le format choisi. Pour le format XLSX, il contient 5 feuilles : - **Analyse rhétorique** : Tableau principal - **Détail Toulmin** : Structure complète de chaque argument - **Évaluation sources (CRAAP)** : Scores des sources citées - **Synthèse** : Points forts, faibles, patterns - **Légende** : Échelles et définitions ### Option 2 : Génération manuelle Utiliser le skill `xlsx` pour créer un fichier avec les colonnes : - N° de l'argument - Argument traité (résumé) - Texte original (extrait clé) - Affirmation / Thèse (Claim) - Type de raisonnement (Warrant + évaluation) - Fiabilité (1-5) - Évaluation détaillée de la fiabilité - Commentaire critique ## Précautions - **Distinguer la conclusion de l'argument** : Un argument peut être faible mais mener à une conclusion juste - **Éviter le biais de confirmation** : Analyser avec la même rigueur les textes qu'on approuve ou désapprouve - **Reconnaître les limites** : Certaines affirmations sont impossibles à évaluer sans expertise domaine - **Contexte militant assumé** : Si le texte est explicitement militant, le noter sans que cela invalide l'analyse