icarus603/biz-research-skills/paper-note

Paper Note

Typeset a reading note for a single academic paper into a minimal, clean LaTeX PDF.

Input sources (in priority order)

1. deep_note.md from deep-read skill (preferred — already structured)
2. A PDF path — run deep-read first if note doesn't exist yet
3. User-provided text/notes directly

Step 0: Check LaTeX Environment

bash ${CLAUDE_PLUGIN_ROOT}/scripts/check_env.sh

• Exit 0 → proceed
• Exit 1 → note missing packages, continue if pdflatex available
• Exit 2 → stop. Tell user to install:
• macOS: brew install --cask mactex or basictex
• Linux: sudo apt install texlive-full latexmk

Step 1: Ask Two Questions

If not already clear from context, ask (one AskUserQuestion call):

1. Your name — for "Reading note by ___" on title block
2. Chinese content? — Yes → enable xeCJK; No → skip

Skip if both are clear from context.

Step 2: Set Up Working Directory

Check first: if {project}/refs/{slug}/notes/{paper_slug}_note.pdf already exists, warn user and ask whether to overwrite or keep existing.

NOTE_DIR="{project}/refs/{slug}/notes/{paper_slug}_note"
cp -r ${CLAUDE_PLUGIN_ROOT}/assets/template/ "$NOTE_DIR/"

paper_slug = sanitized paper title (lowercase, underscores, no spaces). {slug} = project slug from ebsco convention (e.g. patents-top5). If no slug, use refs/notes/ directly.

Step 3: Populate main.tex

Read assets/template/main.tex. Replace all ← replace placeholders with actual content from the deep_note.md or PDF reading.

Mapping from deep_note.md to LaTeX sections:

Table content: fill booktabs tables from the structured data in the note. Every table needs at least one data row.

Rules:

• No colored boxes, no tcolorbox, no \begin{block}
• Body text \normalsize throughout
• If a section has no content yet: write \textit{待补充} — never leave blank or omit the section
• Chinese text: uncomment \usepackage{xeCJK} in preamble if user said yes
• Math: use amsmath environments already loaded

Step 4: Compile

bash ${CLAUDE_PLUGIN_ROOT}/scripts/build.sh "$NOTE_DIR/main.tex"

PDF lands at $NOTE_DIR/build/main.pdf.

Fix every error. Common issues:

• Chinese tofu (□□□) → xeCJK not loaded or wrong engine → switch to xelatex
• booktabs error → check table syntax
• Overfull hbox → shorten cell text or add \small inside table cells only

Step 5: Visual Check

bash ${CLAUDE_PLUGIN_ROOT}/scripts/preview.sh "$NOTE_DIR/build/main.pdf"

Read preview images. Check:

• No text overflow
• Tables render correctly
• Section rule lines appear
• Header shows correct paper title + author
• Page numbers in footer
• No tofu characters

Fix issues, recompile.

Step 6: Handoff

Tell user:

• PDF path: $NOTE_DIR/build/main.pdf
• Also copy to {project}/refs/{slug}/notes/{paper_slug}_note.pdf for easy access

Clean up build artifacts after user confirms:

rm -rf "$NOTE_DIR"  # removes .tex, build/ logs, template files

Only the final {paper_slug}_note.pdf remains in notes/.

Then ask (AskUserQuestion):

• "Looks good, done"
• "Need edits — specify"

On edits: re-create $NOTE_DIR from template, fix .tex, recompile, preview, return to Step 6. Clean up again when done.

Files