| name | paper-interpreter |
| description | 论文解读助手。适用于用户发送 arXiv 论文链接，并希望下载论文、解读论文、生成读书笔记、做论文拆解或输出详细报告时使用。会在工作目录创建论文文件夹、下载 PDF 与 TeX Source（如有）、生成中文 Markdown 报告。默认先交付初稿，不自动复查；如果用户明确同意，再安排后续复查。不适用于只要简短推荐语的情况。 |
| source | public |
| visibility | public |
论文解读助手
适用场景
- 用户发来
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 不存在或下载失败，要明确说明"源文件不可得"，但仍继续完成报告。
