paper-digest

Paper Digest — 單篇論文內容整理（快速吸收）

What this is (and is NOT)

/paper-review answers 「這篇可不可信、做得好不好」. /paper-digest answers 「這篇講了什麼、我怎麼最快把全部內容吸收進腦袋」. It is for papers read as content / knowledge material（綜論、技術介紹、機制整理、指引）. The two are independent and can both run on one paper (combined note). A digest additionally feeds the 複習迴圈: it generates self-test cards that go to the review web page so learning doesn't end at "note written".

Tone, language, and clinical framing are driven by ${persona} (see Configuration). Follow vault note rules (Tab indent, > [!type] callouts, ${persona.highlight_style} for cut-offs, no code blocks for clinical content).

Configuration (read FIRST, every run)

Read config.yaml in the sibling paper-review/ skill directory (shared config; copy config.example.yaml → config.yaml on first setup). Keys this skill uses: ${vault.papers_dir}, ${vault.medicine_dir}, ${vault.inbox_note}, ${vault.daily_section}, ${review_site.url}, ${review_site.push_script}, ${persona}. Substitute every ${...} with the config value; a blank value means "skip that route" (e.g. empty review_site.push_script → no card push).

Input

DOI / PMID / title / PDF path / pasted full text. Optional flags:

• --into <note path> — instead of creating a standalone note, prepend the digest as a ## 內容整理（快速吸收） section into an existing note (used by /paper-sync when both 🔬+📚 picked, so content sits above the appraisal in one file).
• --no-cards — skip review-card generation/push (default is to generate).

Phase 0 — Full text is MANDATORY (hard gate)

Acquire full text per the shared protocol ~/.claude/skills/paper-review/fulltext-acquisition.md (user-provided → ${fulltext.inbox_dir} → Zotero → OA auto-fetch → Elsevier TDM → institutional SFX resolver).

If no route yields full text → STOP. Do NOT write an abstract-only digest. Report: 缺全文：{title} — 需要 PDF 才能做內容整理. When called from /paper-sync this routes to the 缺全文 handoff (logged to ${vault.inbox_note} # 缺全文待補; user supplies PDF then says「繼續」). Abstract-only is exactly the over-simplification this skill exists to avoid.