Paper Interpretation

Goal

Read the whole paper, including text, tables, figures, captions, appendices, and experiment details, then write a Chinese Markdown article that helps non-specialists understand the paper while preserving its academic and industrial value.

Always save the final Markdown under the current project's markdown/ directory. Create the directory if missing. Use a descriptive filename derived from the paper title, for example markdown/论文标题-通俗解读.md.

Intake

Accept either:

• A local PDF path.
• A PDF URL.

If the user gives a URL, download the PDF or use scripts/extract_paper_assets.py to download and extract it. If the PDF is scanned or extraction is incomplete, use OCR or available PDF/image tooling before writing. Do not rely only on abstract/introduction unless the PDF cannot be fully processed; state any limitation explicitly.

Extraction Workflow

Use the helper script when useful:

python3 /Users/digoal/.codex/skills/paper-interpretation/scripts/extract_paper_assets.py INPUT_PDF_OR_URL --out .paper-work

The script creates:

• paper.pdf for the normalized PDF.
• paper_text.md with page-level text.
• paper_tables.md with table candidates when pdfplumber is available.
• figures/ with extracted embedded images when PyMuPDF is available.
• manifest.json with extraction status and warnings.

Read the extracted files and inspect important figures/tables directly when they carry evidence, architecture, or results. If a library is unavailable, use other local tools if present; otherwise continue with the available extraction and mention the gap only if it affects confidence.

Reading Checklist

Before writing, identify: