Skills paper-interpreter

论文解读助手。适用于用户发送 arXiv 论文链接，并希望下载论文、解读论文、生成读书笔记、做论文拆解或输出详细报告时使用。会在工作目录创建论文文件夹、下载 PDF 与 TeX Source（如有）、生成中文 Markdown 报告。默认先交付初稿，不自动复查；如果用户明确同意，再安排后续复查。不适用于只要简短推荐语的情况。

install

source · Clone the upstream repo

git clone https://github.com/chujianyun/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/chujianyun/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/paper-interpreter" ~/.claude/skills/chujianyun-skills-paper-interpreter && rm -rf "$T"

manifest: skills/paper-interpreter/SKILL.md

source content

论文解读助手

适用场景

用户发来
```
https://arxiv.org/...
```
链接，并明确要求"论文解读""论文拆解""详细总结""生成报告""下载论文"
用户希望把论文资料落到本地目录，再生成一份结构完整、适合持续完善的中文报告
用户接受以本地文件为主交付，而不是只在对话里看一段摘要

如果用户只要一段 200 字左右的推荐语，优先使用

paper-recommendation

，不要使用本 skill。

设计模式

本 skill 主要采用：

Pipeline：严格按“下载资料 → 阅读材料 → 生成初稿 → 交付 → 如有需要再复查”的顺序执行
Generator：基于固定报告结构生成可长期迭代的文档
Inversion（轻度）：开始前先确认范围，复查前再次征求用户同意

Gotchas

不要把“论文推荐语”误判成“论文解读”，这两者要分流到不同 skill
不要默认安排复查；是否复查必须先征求用户确认
不要假装已经读完全文；如果只重点看了摘要、方法、实验，要明确说明
不要编造论文中不存在的实验、公式、结论或数据
不要只发路径不发文件；如果当前渠道支持发文件，应优先直接发送报告文件

工作流

0. 先确认执行范围（必须先做）

开始前先给用户一个简短确认，至少说清这 3 件事：

会把论文下载到本地并生成报告
初版默认先完成一版，不自动安排复查
最终以文件为主交付，而不是直接在对话里长篇输出全文

如果用户已经明确接受“下载到本地 + 生成报告”的工作方式，可以直接继续，不必反复确认。

1. 确定保存目录

按以下优先级选择基础目录：

用户明确指定的目录
当前上下文中明显属于用户常用工作区的目录
```
~/Documents/working/papers
```

不要凭空发明新目录。无法确定时直接使用默认值。

2. 初始化论文工作区

先运行脚本，创建论文目录并下载资源：

python3 skills/paper-interpreter/scripts/bootstrap_arxiv_paper.py '<arxiv_url>' '<base_dir>'

脚本会：

解析 arXiv ID
使用论文标题创建子文件夹
下载 PDF（以论文标题命名）
尝试下载
```
TeX Source
```
可识别时自动解包到
```
source/
```
写入
```
metadata.json
```
如报告文件
```
{论文标题}_报告.md
```
不存在，则创建报告骨架

优先读取脚本输出中的

paper_dir

、

report_path

、

pdf_path

、

source_path

。

3. 阅读材料并生成初版报告

生成报告前，按以下顺序获取信息：

```
metadata.json
```
arXiv 摘要页
```
TeX Source
```
（如果下载成功，优先用它确认公式、模块名、算法步骤）
PDF 文件（以论文标题命名）

报告必须写入论文目录下的

{论文标题}_报告.md

，并满足：

中文输出
结构完整，适合长期迭代
不编造论文中不存在的实验、公式或结论
对不确定内容明确写"论文未明确说明"或"需要进一步核对"
在合适位置调用
```
mermaid
```
skill 生成 Mermaid 图，至少 1 张，通常 2-3 张更合适
如果需要产出多份报告，继续沿用标题做前缀，并通过后缀区分，例如
```
{论文标题}_报告_复查1.md
```
、
```
{论文标题}_报告_分享版.md
```

优先使用 report-outline.md 中的结构。

4. 初稿完成要求（必须执行）⚠️

生成初版报告后，必须立即把报告文件交付给用户：

交付报告文件：
```
{论文标题}_报告.md
```
如果当前渠道支持文件发送，优先直接发送文件
如果当前渠道不支持文件发送，至少明确给出可访问路径
提醒用户这是初稿
如果你判断值得继续复查，可以补一句“如有需要我可以再复查一轮”，但不要默认已安排

示例：

✅ 论文初稿已生成！

📄 报告文件：<报告文件路径或文件>
📝 当前版本：v1.0 初稿
如果你要，我可以再复查一轮，补实验细节和边界条件。

5. 报告写作要求

报告至少覆盖这些内容：

论文基本信息
一句话总结
要解决的问题与研究动机
方法拆解
训练或推理流程
实验设置与关键结果
亮点、局限、适用边界
对实际应用或研究延展的判断
术语解释
复查记录

调用

mermaid

skill 时可优先考虑这些图：

方法总览：
```
flowchart LR
```
/
```
flowchart TD
```
训练或推理阶段：
```
sequenceDiagram
```
或
```
flowchart
```
模块关系：
```
graph TD
```

只保留真正能帮助理解的图；调用

mermaid

skill 时不要为了凑数量而加图。

6. 如需复查，必须先征得用户确认

初版报告完成后，默认流程到此结束。

只有在用户明确同意“继续复查”之后，才可以进入后续完善流程。具体要求如下：

先问用户要不要复查，不要自己默认安排
用户同意后，才可安排 1 次或多次延迟复查
如果当前环境支持定时任务、后台任务或提醒能力，可以在获得确认后再安排
如果当前环境不支持真正的定时执行，要明确告诉用户限制，并在报告中写明建议复查方向

7. 复查任务的更新原则

复查时不要整篇推倒重写，遵循增量更新：

先读取当前报告文件
再检查论文原文、PDF、Source 与当前报告的差异
优先补充遗漏的实验细节、方法边界、限制条件、图示或术语解释
在
```
复查记录
```
一节写明本次更新时间、主要新增内容、修正内容
不删除用户手工补充的内容，除非确认其与论文事实冲突

输出要求

初版报告完成后的必须操作⚠️

第一步：交付报告文件

如果当前渠道支持文件发送，直接发送
```
{论文标题}_报告.md
```
如果当前渠道不支持文件发送，提供清晰可访问的文件路径
附带简短说明：
- 初稿已完成
- 当前版本信息
- 如需复查可继续提出

第二步：汇报基本信息

论文目录路径
PDF 文件是否下载成功（以论文标题命名）
```
TeX Source
```
是否下载成功
报告文件路径（默认是
```
{论文标题}_报告.md
```
）
是否建议复查，以及如需复查必须先征求用户确认

注意：必须先发送文件，再汇报信息。不要反过来。

如果

TeX Source

不存在或下载失败，要明确说明"源文件不可得"，但仍继续完成报告。