论文解读助手
适用场景
- 用户发来
https://arxiv.org/...链接,并明确要求"论文解读""论文拆解""详细总结""生成报告""下载论文" - 用户希望把论文资料落到本地目录,再生成一份可持续完善的中文报告
- 用户希望后续自动复查,而不是只做一次性总结
如果用户只要一段 200 字左右的推荐语,优先使用 paper-recommendation,不要使用本 skill。
工作流
0. 先确认执行范围(必须先做)
开始前先给用户一个简短确认,至少说清这 3 件事:
- 会把论文下载到本地并生成报告
- 初版完成后还会安排 1 小时后和 2 小时后的两次复查
- 最终以文件为主交付,而不是直接在对话里长篇输出全文
如果用户已经明确接受“下载到本地 + 生成报告 + 后续复查”的工作方式,可以直接继续,不必反复确认。
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 图,至少 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 - 训练或推理阶段:
sequenceDiagram或flowchart - 模块关系:
graph TD
Mermaid 图只保留能帮助理解的图,不要为了凑数量而加图。
6. 安排两次自动复查
初版报告完成后,立即创建定时任务安排 1 小时后和 2 小时后的复查任务。
7. 复查任务的更新原则
复查时不要整篇推倒重写,遵循增量更新:
- 先读取当前报告文件
- 再检查论文原文、PDF、Source 与当前报告的差异
- 优先补充遗漏的实验细节、方法边界、限制条件、图示或术语解释
- 在
复查记录一节写明本次更新时间、主要新增内容、修正内容 - 不删除用户手工补充的内容,除非确认其与论文事实冲突
输出要求
初版报告完成后的必须操作⚠️
第一步:发送报告文件
- 使用渠道提供的文件发送功能(QQ 使用
<qqfile>标签) - 发送
{论文标题}_报告.md文件 - 附带简短说明:
- 初稿已完成
- 复查时间(1 小时后和 2 小时后)
- 当前版本信息
第二步:汇报基本信息
- 论文目录路径
- PDF 文件是否下载成功(以论文标题命名)
TeX Source是否下载成功- 报告文件路径(默认是
{论文标题}_报告.md) - 两个复查任务的提交结果
注意:必须先发送文件,再汇报信息。不要反过来。
如果 TeX Source 不存在或下载失败,要明确说明"源文件不可得",但仍继续完成报告。