Communitygithub.com

Paper Deep Reading

Convertit des PDFs d'articles de recherche en notes Obsidian structurées, avec traductions automatiques, analyse des figures et explications de concepts pour une étude approfondie.

Qu'est-ce que Paper Deep Reading ?

Paper Deep Reading est un outil conçu pour transformer des articles de recherche au format PDF en notes Obsidian riches et bien structurées. Il automatise l'extraction du contenu, la traduction paragraphe par paragraphe avec des identifiants (P01, P02, etc.), et l'insertion des figures à proximité du texte correspondant. Ce skill génère également des notes détaillées pour chaque figure, expliquant leur type, leurs panels, les affirmations soutenues et leur importance. Il inclut un support pour les débutants avec des explications des concepts clés, un journal des questions pour suivre les apprentissages, et peut exporter en PDF sur demande. Compatible avec Obsidian, il utilise des workflows de référence (lecture, figures, explications débutant, style Obsidian, journal de questions) et des scripts de validation pour garantir la qualité de la sortie. L'utilisateur peut aisément analyser des articles complexes en un format de révision optimisé pour la rétention et l'approfondissement.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add Robertmorrisluminousenergy177/paper-deep-reading-skill

Demander à votre IA préférée

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

Documentation

Lecture Approfondie d'Articles

Objectif

Transformer un article de journal en un artefact d'apprentissage soigné : une note principale Obsidian Markdown avec traduction au niveau du paragraphe, figures placées, notes détaillées sur les figures, explications pour débutants, support de glossaire, un journal des questions et une exportation PDF optionnelle.

Utilisez le skill PDF ou un workflow équivalent de rendu et d'inspection lorsque la source est un PDF. Pour les articles sur deux colonnes, les pages rendues sont la source de vérité pour l'ordre de lecture et le placement des figures.

Workflow par défaut

  1. Inspectez le PDF source : titre, auteurs, sections, nombre de pages, figures, légendes, tableaux, références aux suppléments et toute contrainte liée au droit d'auteur.
  2. Créez un dossier de sortie de type coffre avec assets/figures/, exports/ et une note Markdown principale, sauf si l'utilisateur demande plusieurs notes.
  3. Traduisez et expliquez paragraphe par paragraphe. Numérotez les paragraphes naturels sous la forme P01, P02, etc. ; corrigez l'ordre de la reconnaissance optique de caractères ou d'extraction par rapport aux rendus de page.
  4. Insérez chaque figure près du paragraphe qui l'utilise pour la première fois. Stockez les images sous assets/figures/ avec des noms descriptifs stables.
  5. Pour chaque figure principale, rédigez une note de figure qui explique de quel type de figure il s'agit, ce que fait chaque panneau, quelle affirmation elle soutient, pourquoi elle est importante et pourquoi les auteurs l'ont incluse.
  6. Ajoutez un support pour débutants lors de la première utilisation des concepts clés, méthodes, axes, formules, matériaux et mécanismes. Marquez les limites des affirmations : mesuré, calculé, déduit ou proposé.
  7. Tenez à jour un journal des questions pour les questions de connaissances. Fusionnez les questions répétées avec l'entrée existante la plus proche au lieu de dupliquer de longues explications.
  8. Vérifiez les liens Markdown, les chemins des figures, la couverture des sections et si la sortie est lisible dans Obsidian.
  9. Exportez au format PDF uniquement sur demande. Rendez la note, inspectez visuellement les pages représentatives et placez les fichiers PDF finaux dans exports/.

Références requises

Lisez uniquement les fichiers de référence nécessaires à la demande de l'utilisateur :

  • references/reading-workflow.md : workflow complet de l'article à la note et contrôles de qualité.
  • references/figure-note-guide.md : comment recadrer, placer et expliquer les figures.
  • references/beginner-explanation-guide.md : comment expliquer un domaine difficile à un novice sans trop simplifier.
  • references/obsidian-note-style.md : structure de la note, encadrés, liens et attentes CSS.
  • references/question-log-guide.md : comment tenir à jour le journal des questions d'apprentissage et fusionner les concepts répétés.

Ressources fournies

  • assets/note-template.md : structure de départ pour la note principale de l'article.
  • assets/question-log-template.md : structure pour le journal des questions séparé.
  • assets/figure-note-template.md : bloc réutilisable pour les notes de figure.
  • assets/obsidian-css-snippet.css : extrait CSS optionnel pour Obsidian afin d'obtenir des encadrés et figures lisibles.
  • scripts/validate_note_structure.py : validation légère pour les titres, images, encadrés et identifiants de questions répétés.
  • scripts/export_obsidian_note_pdf.js : rendu d'images Markdown/Obsidian en PDF via Playwright.
  • scripts/extract_pdf_assets.py : outil PyMuPDF optionnel pour rendre les pages et extraire les images intégrées.

Normes de sortie

  • Préférez une seule note Markdown substantielle à de nombreux petits fichiers.
  • Gardez les images proches du texte qui les explique.
  • Rédigez des notes de figure spécifiques à l'article, pas des légendes génériques.
  • Expliquez les axes des graphiques avant d'interpréter les tendances.
  • Évitez les affirmations non étayées. Précisez lorsqu'un point est une déduction de l'article.
  • N'incluez pas publiquement de traductions complètes protégées par le droit d'auteur dans des exemples de dépôts, sauf si la licence de la source le permet.
  • Avant de terminer, indiquez le chemin de la note, le nombre de figures, l'état du journal des questions et tout chemin d'exportation.

Skills associés