paper-interpreter

论文解读助手。适用于用户发送 arXiv 论文链接并希望下载论文、解读论文、生成读书笔记、做论文拆解或输出详细报告的场景。会在工作目录创建论文文件夹,下载 PDF 与 TeX Source(如有),生成中文 Markdown 报告并安排后续复查;不适用于只要简短推荐语的情况。

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "paper-interpreter" with this command: npx skills add chujianyun/skills/chujianyun-skills-paper-interpreter

论文解读助手

适用场景

  • 用户发来 https://arxiv.org/... 链接,并明确要求"论文解读""论文拆解""详细总结""生成报告""下载论文"
  • 用户希望把论文资料落到本地目录,再生成一份可持续完善的中文报告
  • 用户希望后续自动复查,而不是只做一次性总结

如果用户只要一段 200 字左右的推荐语,优先使用 paper-recommendation,不要使用本 skill。

工作流

0. 先确认执行范围(必须先做)

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

  • 会把论文下载到本地并生成报告
  • 初版完成后还会安排 1 小时后和 2 小时后的两次复查
  • 最终以文件为主交付,而不是直接在对话里长篇输出全文

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

1. 确定保存目录

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

  1. 用户明确指定的目录
  2. 当前上下文中明显属于用户常用工作区的目录
  3. ~/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_dirreport_pathpdf_pathsource_path

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

生成报告前,按以下顺序获取信息:

  1. metadata.json
  2. arXiv 摘要页
  3. TeX Source(如果下载成功,优先用它确认公式、模块名、算法步骤)
  4. PDF 文件(以论文标题命名)

报告必须写入论文目录下的 {论文标题}_报告.md,并满足:

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

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

4. 初稿完成要求(必须执行)⚠️

生成初版报告后,必须立即向用户发送报告文件

  • 发送报告文件:{论文标题}_报告.md
  • 使用渠道提供的文件发送功能(QQ 使用 <qqfile>标签
  • 提醒用户这是初稿,后续会有复查任务完善内容
  • 说明复查时间(1 小时后和 2 小时后)

发送示例(QQ):

✅ 论文初稿已生成!

📄 报告文件:<qqfile>报告文件路径</qqfile>
⏰ 初稿复查时间:22:12 和 23:12(自动完善)
📝 当前版本:v1.0 初稿

5. 报告写作要求

报告至少覆盖这些内容:

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

Mermaid 图建议:

  • 方法总览:flowchart LR / flowchart TD
  • 训练或推理阶段:sequenceDiagramflowchart
  • 模块关系:graph TD

Mermaid 图只保留能帮助理解的图,不要为了凑数量而加图。

6. 安排两次自动复查

初版报告完成后,立即创建定时任务安排 1 小时后和 2 小时后的复查任务。

7. 复查任务的更新原则

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

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

输出要求

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

第一步:发送报告文件

  • 使用渠道提供的文件发送功能(QQ 使用 <qqfile>标签
  • 发送 {论文标题}_报告.md 文件
  • 附带简短说明:
    • 初稿已完成
    • 复查时间(1 小时后和 2 小时后)
    • 当前版本信息

第二步:汇报基本信息

  • 论文目录路径
  • PDF 文件是否下载成功(以论文标题命名)
  • TeX Source 是否下载成功
  • 报告文件路径(默认是 {论文标题}_报告.md
  • 两个复查任务的提交结果

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

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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

prompt-optimizer

No summary provided by upstream source.

Repository SourceNeeds Review
General

sync-skills

No summary provided by upstream source.

Repository SourceNeeds Review
General

openclaw-wiki

No summary provided by upstream source.

Repository SourceNeeds Review
General

qoder-wiki

No summary provided by upstream source.

Repository SourceNeeds Review