Communitygithub.com

flyer-Li/paper-analyst

Analyse d'articles académiques et de PDF de recherche. Utilisez cette compétence lorsque l'utilisateur télécharge ou colle un article de recherche et souhaite le comprendre. Déclencheurs : 'analyse cet article', 'lis ce PDF', 'résume cette recherche', 'résumé d'article', 'décryptage d'article de recherche', 'explique cette étude', 'critique d'article', 'analyse d'article académique', '论文分析', '帮我看这篇论文', '解读这篇文章', '这篇 paper 讲什么', '帮我分析这个 PDF', '论文解读', '文献分析', '读一下这篇论文', '帮我总结这篇文章', '这篇论文的创新点', '论文方法分析', '论文结果', '帮我准备组会汇报', '生成 PPT 大纲'. Ne PAS utiliser pour les PDF non académiques, les feuilles de calcul ou les tâches documentaires générales.

Qu'est-ce que paper-analyst ?

Paper Analyst est une compétence puissante pour analyser en profondeur des articles académiques, que ce soit à partir d'un PDF téléchargé ou d'un texte collé. Elle prend en charge plusieurs modes, notamment rapide, standard, étendu (avec contexte des travaux antérieurs des auteurs), présentation et présentation avec figures. La production par défaut est en chinois. La compétence s'appuie sur un ensemble de fichiers de référence structurés (schéma de sortie, rubrique de type d'article, liste de contrôle anti-hallucination, etc.) pour garantir une analyse cohérente et fiable. Elle dispose de règles anti-hallucination strictes : chaque contribution doit être étiquetée comme provenant explicitement de l'article ou inférée par le modèle, les incertitudes doivent être clairement signalées, et aucune fabrication de contenu n'est autorisée, en particulier pour les PDF dégradés (numérisés ou partiels). La compétence prend en charge la génération de plans de diapositives et, via un module complémentaire, la création automatique de présentations PowerPoint, avec la possibilité d'extraire les figures du PDF pour le mode présentation avec figures. Elle est conçue pour être utilisée avec des agents IA comme Claude, Cursor ou Codex, et couvre tous les besoins d'analyse d'articles académiques : résumé, décryptage, évaluation, préparation de réunions ou de présentations.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/flyer-Li/paper-analyst/tree/main

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Paper Analyst

Analysez des articles académiques à partir d'un PDF ou d'un texte collé. La sortie est par défaut en chinois. Toutes les sorties suivent references/output-schema.md. La détection du type d'article utilise references/paper-type-rubric.md. Les règles anti-hallucination se trouvent dans references/quality-checklist.md.

Référence rapide

FichierObjectif
references/output-schema.mdStructure des sections et règles des champs
references/paper-type-rubric.mdComment classer le type d'article
references/quality-checklist.mdListe de contrôle anti-hallucination
references/presentation-schema.mdSchéma JSON du plan de diapositives
references/presentation-style-guide.mdRègles de compression du contenu pour les diapositives
references/pptx-handoff.mdComment appeler la compétence pptx pour le rendu
scripts/extract_pdf_meta.pyOptionnel : extraire les métadonnées PDF en JSON

Sélection du mode

Mode par défaut : standard. Détecter à partir de la demande de l'utilisateur :

ModeDéclencheurSortie
quick"quick", "简单说", "一句话", "简要"En-tête + infos + résumé + 3 contributions
standard(par défaut)Analyse complète : sections 1 à 5
extended"前作", "课题组", "prior work"standard + travaux antérieurs de l'auteur/groupe
presentation"PPT", "组会", "汇报大纲", "slides"standard + plan de diapositives
presentation_with_figures"图表", "figures", "带图", "关键图"présentation + annotations de figures

En cas d'ambiguïté, utiliser standard et proposer de changer.

Flux de travail

Étape 1 : Évaluer la qualité de l'entrée

Classer la qualité du PDF avant l'analyse :

  • Bon : Le texte intégral est extractible
  • Dégradé : Texte partiel, sections scannées, encodage altéré
  • Gravement dégradé : Texte minimal, PDF image uniquement

Si dégradé : indiquer la raison dans la ligne d'en-tête, poursuivre avec le contenu disponible, marquer explicitement toutes les lacunes. Ne jamais fabriquer de contenu pour combler les lacunes.

Optionnel : si l'utilisateur dispose de Python, suggérer d'exécuter d'abord scripts/extract_pdf_meta.py pour des métadonnées structurées.

Étape 2 : Classer le type d'article

Lire references/paper-type-rubric.md et classer. Ne PAS supposer IA/ML. Afficher l'étiquette du type et 2 à 3 indicateurs de preuve avant de continuer.

Étape 3 : Exécuter l'analyse

Suivre references/output-schema.md pour le mode sélectionné. Appliquer toutes les règles de references/quality-checklist.md dans chaque section.

Étape 4 : Auto-vérification avant la sortie

Vérifier avant de finaliser :

  • Chaque champ incertain marqué [不确定] ou [未明确给出]
  • Chaque contribution étiquetée [原文声明] ou [模型归纳]
  • Aucune section silencieusement omise — les sections ignorées indiquent pourquoi
  • L'étiquette du type d'article correspond aux preuves de la rubrique

Règles anti-hallucination

Règles complètes dans references/quality-checklist.md. Contraintes non négociables :

  1. Étiquetage des sources : [原文声明] = directement énoncé dans l'article (citer l'emplacement) ; [模型归纳] = inféré par le modèle (indiquer la base du raisonnement)
  2. Incertitude : [未明确给出] lorsque absent ; [不确定] lorsque ambigu
  3. Aucune hypothèse de domaine : classer d'abord le type d'article, toujours
  4. Aucune fabrication : lieu, DOI, année, affiliations non dans le texte → [未明确给出]
  5. Lien avec la preuve : chaque contribution doit citer la section/figure/tableau/citation
  6. PDF dégradé : indiquer quelles sections étaient illisibles ; ne pas combler les lacunes

Solution de repli pour entrée dégradée

SituationAction
Seul le résumé est disponibleMode quick, noter la limitation
PDF scanné, pas de texteDemander d'abord le texte ou l'OCR à l'utilisateur
Section des références manquanteIgnorer l'analyse des travaux antérieurs, noter l'absence
Figures illisiblesIgnorer l'analyse des figures, noter l'absence
Article non anglaisTraduire les sections clés, noter la langue source

Mode étendu : Travaux antérieurs de l'auteur

Uniquement en mode extended :

  1. Extraire tous les noms d'auteurs de l'article
  2. Identifier les auto-citations dans la liste de références (auteurs partagés)
  3. Inférer le thème du groupe de recherche à partir des affiliations + du titre de l'article
  4. Lister les travaux antérieurs uniquement à partir de la liste de références — pas de recherche web, pas de connaissance externe
  5. Étiqueter toute sortie : [基于论文内引用,非外部检索]
  6. Si les informations sont insuffisantes : indiquer explicitement "信息不足,无法判断前作关系"

Mode présentation : Génération de diapositives PPT

Uniquement en mode presentation ou presentation_with_figures.

Étape A : Collecter les surcharges

Avant de construire le plan de diapositives, vérifier si l'utilisateur a spécifié :

  • audience (laboratoire / conférence / général) — défaut : laboratoire
  • duration_hint (10min / 20min / 30min) — défaut : 20min
  • talk_style (technique / aperçu / discussion) — défaut : technique
  • emphasis (quelles sections développer)
  • skip (quelles sections omettre)

Si non spécifiés, utiliser les valeurs par défaut silencieusement.

Étape B0 : Extraire les figures du PDF (presentation_with_figures uniquement)

Avant de construire le plan de diapositives, exécuter :

python scripts/extract_pdf_figures.py <chemin_vers_pdf>

Cela enregistre toutes les figures dans figures/ et écrit figures/index.json avec name, path, et page pour chaque image. Utiliser cet index lors de l'attribution des chemins figure_ref dans le transfert.

Étape B : Construire le plan de diapositives

Suivre references/presentation-schema.md pour la structure. Suivre references/presentation-style-guide.md pour les règles de compression.

  • Mapper chaque rôle de diapositive à la section correspondante du schéma de sortie
  • Appliquer les surcharges utilisateur (emphasis → développer, skip → omettre)
  • Pour presentation_with_figures : définir figure_needed: true sur les diapositives de méthode/résultat où une figure est la preuve principale ; ajouter figure_ref et figure_hint
  • Nombre de diapositives basé sur l'indice de durée (10min→6-7, 20min→9-10, 30min→12-14)

Étape C : Appeler la compétence pptx

Suivre references/pptx-handoff.md pour le format exact du transfert.

  • Supprimer toutes les balises [原文声明] / [模型归纳] avant de passer à pptx
  • Ne PAS inclure les notes du présentateur dans le transfert
  • Appeler la compétence pptx automatiquement — ne pas demander d'abord à l'utilisateur
  • Exception : si l'utilisateur dit "只要大纲" / "just the outline", afficher le plan de diapositives sous forme de texte et ignorer pptx

Skills associés