Paper Analyst
Analyze academic papers from PDF or pasted text. Output in Chinese by default.
All outputs follow references/output-schema.md. Paper type detection uses
references/paper-type-rubric.md. Anti-hallucination rules in
references/quality-checklist.md.
Quick Reference
| File |
Purpose |
references/output-schema.md |
Section structure and field rules |
references/paper-type-rubric.md |
How to classify paper type |
references/quality-checklist.md |
Anti-hallucination checklist |
references/presentation-schema.md |
Slide plan JSON schema |
references/presentation-style-guide.md |
Content compression rules for slides |
references/pptx-handoff.md |
How to call the pptx skill for rendering |
scripts/extract_pdf_meta.py |
Optional: extract PDF metadata to JSON |
Mode Selection
Default mode: standard. Detect from user's request:
| Mode |
Trigger |
Output |
quick |
"quick", "简单说", "一句话", "简要" |
Header + info + abstract + 3 contributions |
standard |
(default) |
Full analysis: sections 1–5 |
extended |
"前作", "课题组", "prior work" |
standard + author/group prior work |
presentation |
"PPT", "组会", "汇报大纲", "slides" |
standard + slide outline |
presentation_with_figures |
"图表", "figures", "带图", "关键图" |
presentation + figure annotations |
If ambiguous, use standard and offer to switch.
Workflow
Step 1: Assess Input Quality
Classify PDF quality before analysis:
- 良好: Full text extractable
- 降级处理: Partial text, scanned sections, garbled encoding
- 严重降级: Minimal text, image-only PDF
If degraded: state reason in header line, proceed with available content,
mark all gaps explicitly. Never fabricate content to fill gaps.
Optional: if user has Python, suggest running scripts/extract_pdf_meta.py
first for structured metadata.
Step 2: Classify Paper Type
Read references/paper-type-rubric.md and classify. Do NOT assume AI/ML.
Output the type label and 2–3 evidence indicators before proceeding.
Step 3: Execute Analysis
Follow references/output-schema.md for the selected mode. Apply all rules
from references/quality-checklist.md throughout every section.
Step 4: Self-Check Before Output
Verify before finalizing:
- Every uncertain field marked
[不确定] or [未明确给出]
- Every contribution tagged
[原文声明] or [模型归纳]
- No section silently omitted — skipped sections state why
- Paper type label matches rubric evidence
Anti-Hallucination Rules
Full rules in references/quality-checklist.md. Non-negotiable constraints:
- Source tagging:
[原文声明] = directly stated in paper (cite location);
[模型归纳] = inferred by model (state reasoning basis)
- Uncertainty:
[未明确给出] when absent; [不确定] when ambiguous
- No domain assumption: classify paper type first, always
- No fabrication: venue, DOI, year, affiliations not in text →
[未明确给出]
- Evidence binding: each contribution must cite section/figure/table/quote
- Degraded PDF: state which sections were unreadable; do not fill gaps
Degraded Input Fallback
| Situation |
Action |
| Only abstract available |
quick mode, note limitation |
| Scanned PDF, no text |
Ask user for text or OCR first |
| Missing references section |
Skip prior work analysis, note absence |
| Figures unreadable |
Skip figure analysis, note absence |
| Non-English paper |
Translate key sections, note source language |
Extended Mode: Author Prior Work
Only in extended mode:
- Extract all author names from paper
- Identify self-citations in reference list (shared authors)
- Infer research group focus from affiliations + paper title
- List prior works from reference list only — no web search, no external knowledge
- Tag all output:
[基于论文内引用，非外部检索]
- If insufficient info: explicitly state "信息不足，无法判断前作关系"
Presentation Mode: PPT Generation
Only in presentation or presentation_with_figures mode.
Step A: Collect Overrides
Before building the slide plan, check if the user specified any of:
audience (lab / conference / general) — default: labduration_hint (10min / 20min / 30min) — default: 20mintalk_style (technical / overview / discussion) — default: technicalemphasis (which sections to expand)skip (which sections to omit)
If not specified, use defaults silently.
Step B0: Extract PDF Figures (presentation_with_figures only)
Before building the slide plan, run:
python scripts/extract_pdf_figures.py <pdf_path>
This saves all figures to figures/ and writes figures/index.json with name, path, and page for each image. Use this index when assigning figure_ref paths in the handoff.
Step B: Build Slide Plan
Follow references/presentation-schema.md for structure.
Follow references/presentation-style-guide.md for compression rules.
- Map each slide role to the corresponding output-schema section
- Apply user overrides (emphasis → expand, skip → omit)
- For
presentation_with_figures: set figure_needed: true on method/result slides where a figure is the primary evidence; add figure_ref and figure_hint
- Slide count from duration_hint (10min→6-7, 20min→9-10, 30min→12-14)
Step C: Call pptx Skill
Follow references/pptx-handoff.md for the exact handoff format.
- Strip all
[原文声明] / [模型归纳] tags before passing to pptx
- Do NOT include speaker notes in the handoff
- Call pptx skill automatically — do not ask the user first
- Exception: if user said "只要大纲" / "just the outline", output the slide plan as text and skip pptx
1---2name: paper-analyst3description: Analyze academic papers and research PDFs. Use this skill when the user uploads or pastes a research paper and wants to understand it. Triggers: 'analyze this paper', 'read this PDF', 'summarize this research', 'paper summary', 'research paper breakdown', 'explain this study', 'paper critique', 'academic paper analysis', '论文分析', '帮我看这篇论文', '解读这篇文章', '这篇 paper 讲什么', '帮我分析这个 PDF', '论文解读', '文献分析', '读一下这篇论文', '帮我总结这篇文章', '这篇论文的创新点', '论文方法分析', '论文结果', '帮我准备组会汇报', '生成 PPT 大纲'. Do NOT use for non-academic PDFs, spreadsheets, or general document tasks.4---5
6# Paper Analyst
7
8Analyze academic papers from PDF or pasted text. Output in Chinese by default.
9All outputs follow `references/output-schema.md`. Paper type detection uses
10`references/paper-type-rubric.md`. Anti-hallucination rules in
11`references/quality-checklist.md`.
12
13## Quick Reference
14
15| File | Purpose |
16|------|---------|
17| `references/output-schema.md` | Section structure and field rules |
18| `references/paper-type-rubric.md` | How to classify paper type |
19| `references/quality-checklist.md` | Anti-hallucination checklist |
20| `references/presentation-schema.md` | Slide plan JSON schema |
21| `references/presentation-style-guide.md` | Content compression rules for slides |
22| `references/pptx-handoff.md` | How to call the pptx skill for rendering |
23| `scripts/extract_pdf_meta.py` | Optional: extract PDF metadata to JSON |
24
25## Mode Selection
26
27Default mode: `standard`. Detect from user's request:
28
29| Mode | Trigger | Output |
30|------|---------|--------|
31| `quick` | "quick", "简单说", "一句话", "简要" | Header + info + abstract + 3 contributions |
32| `standard` | (default) | Full analysis: sections 1–5 |
33| `extended` | "前作", "课题组", "prior work" | standard + author/group prior work |
34| `presentation` | "PPT", "组会", "汇报大纲", "slides" | standard + slide outline |
35| `presentation_with_figures` | "图表", "figures", "带图", "关键图" | presentation + figure annotations |
36
37If ambiguous, use `standard` and offer to switch.
38
39## Workflow
40
41### Step 1: Assess Input Quality
42
43Classify PDF quality before analysis:
44- **良好**: Full text extractable
45- **降级处理**: Partial text, scanned sections, garbled encoding
46- **严重降级**: Minimal text, image-only PDF
47
48If degraded: state reason in header line, proceed with available content,
49mark all gaps explicitly. Never fabricate content to fill gaps.
50
51Optional: if user has Python, suggest running `scripts/extract_pdf_meta.py`
52first for structured metadata.
53
54### Step 2: Classify Paper Type
55
56Read `references/paper-type-rubric.md` and classify. Do NOT assume AI/ML.
57Output the type label and 2–3 evidence indicators before proceeding.
58
59### Step 3: Execute Analysis
60
61Follow `references/output-schema.md` for the selected mode. Apply all rules
62from `references/quality-checklist.md` throughout every section.
63
64### Step 4: Self-Check Before Output
65
66Verify before finalizing:
67- Every uncertain field marked `[不确定]` or `[未明确给出]`
68- Every contribution tagged `[原文声明]` or `[模型归纳]`
69- No section silently omitted — skipped sections state why
70- Paper type label matches rubric evidence
71
72## Anti-Hallucination Rules
73
74Full rules in `references/quality-checklist.md`. Non-negotiable constraints:
75
761. **Source tagging**: `[原文声明]` = directly stated in paper (cite location);
77 `[模型归纳]` = inferred by model (state reasoning basis)
782. **Uncertainty**: `[未明确给出]` when absent; `[不确定]` when ambiguous
793. **No domain assumption**: classify paper type first, always
804. **No fabrication**: venue, DOI, year, affiliations not in text → `[未明确给出]`
815. **Evidence binding**: each contribution must cite section/figure/table/quote
826. **Degraded PDF**: state which sections were unreadable; do not fill gaps
83
84## Degraded Input Fallback
85
86| Situation | Action |
87|-----------|--------|
88| Only abstract available | `quick` mode, note limitation |
89| Scanned PDF, no text | Ask user for text or OCR first |
90| Missing references section | Skip prior work analysis, note absence |
91| Figures unreadable | Skip figure analysis, note absence |
92| Non-English paper | Translate key sections, note source language |
93
94## Extended Mode: Author Prior Work
95
96Only in `extended` mode:
971. Extract all author names from paper
982. Identify self-citations in reference list (shared authors)
993. Infer research group focus from affiliations + paper title
1004. List prior works from reference list only — no web search, no external knowledge
1015. Tag all output: `[基于论文内引用，非外部检索]`
1026. If insufficient info: explicitly state "信息不足，无法判断前作关系"
103
104## Presentation Mode: PPT Generation
105
106Only in `presentation` or `presentation_with_figures` mode.
107
108### Step A: Collect Overrides
109
110Before building the slide plan, check if the user specified any of:
111- `audience` (lab / conference / general) — default: `lab`
112- `duration_hint` (10min / 20min / 30min) — default: `20min`
113- `talk_style` (technical / overview / discussion) — default: `technical`
114- `emphasis` (which sections to expand)
115- `skip` (which sections to omit)
116
117If not specified, use defaults silently.
118
119### Step B0: Extract PDF Figures (presentation_with_figures only)
120
121Before building the slide plan, run:
122```
123python scripts/extract_pdf_figures.py <pdf_path>
124```
125This saves all figures to `figures/` and writes `figures/index.json` with `name`, `path`, and `page` for each image. Use this index when assigning `figure_ref` paths in the handoff.
126
127### Step B: Build Slide Plan
128
129Follow `references/presentation-schema.md` for structure.
130Follow `references/presentation-style-guide.md` for compression rules.
131
132- Map each slide role to the corresponding output-schema section
133- Apply user overrides (emphasis → expand, skip → omit)
134- For `presentation_with_figures`: set `figure_needed: true` on method/result slides where a figure is the primary evidence; add `figure_ref` and `figure_hint`
135- Slide count from duration_hint (10min→6-7, 20min→9-10, 30min→12-14)
136
137### Step C: Call pptx Skill
138
139Follow `references/pptx-handoff.md` for the exact handoff format.
140
141- Strip all `[原文声明]` / `[模型归纳]` tags before passing to pptx
142- Do NOT include speaker notes in the handoff
143- Call pptx skill automatically — do not ask the user first
144- Exception: if user said "只要大纲" / "just the outline", output the slide plan as text and skip pptx
flyer-li