Skills

Paper Analyzer

将学术论文转化为深度HTML长文。6轮强制工作流、代码仓库搜索、公式渲染、Mermaid图表。 3种写作风格,输出可直接分享的精美HTML页面。

Install

npx skills add zsyggg/paper-craft-skills --skill paper-analyzer -g -a claude-code -y
Category
Engineering
Updated
5mo ago
License
See repository
Context cost
Mediumabout 1,862 tokens
Runs scripts
Yes, review before use

What it does

将学术论文转化为深度HTML长文。6轮强制工作流、代码仓库搜索、公式渲染、Mermaid图表。 3种写作风格,输出可直接分享的精美HTML页面。

Paper Analyzer, 学术论文深度解析

⚠️ 这是生产级指令。你的唯一任务:产出一篇让读者觉得"比我读论文还清楚"的深度HTML长文。

快速使用

/paper-analyzer https://arxiv.org/abs/2605.07363
/paper-analyzer /path/to/paper.pdf
/paper-analyzer  粘贴文本

强制工作流(每一步必须执行,不可跳过)

Round 1:获取论文全文 ⛔

输入执行
arxiv URL同时读 arxiv.org/abs/(摘要)和 arxiv.org/html/(全文HTML)
PDF路径用PDF读取工具读全文。分多次直到全部获取
文本全部使用

自检:有没有完整内容?没有 → 换方式继续。

Round 2:搜索开源代码 ⛔

  1. 从论文中提取代码仓库链接(通常在页脚或 Introduction 末)
  2. 没有则用论文标题+作者名搜索 GitHub
  3. 克隆:git clone --depth 1 <url> /tmp/paper_code
  4. 阅读 README → 核心源码文件 → 配置文件

根据代码状态分支处理:

状态处理文章体现
✅ 已发布读核心文件,找 ≥2 处论文方法↔源码对应贴代码段(≤30行),标注 文件路径:行号
⏳ 待发布检查 README/Release 标记标注状态+仓库链接
❌ 无代码搜索替代实现/相关项目注明"本文未提供公开代码"

Round 3:深度分析 ⛔ 内部完成,不展示过程

  1. 核心创新:论文做了什么别人没做的?(1-3个,每个一句话提炼)
  2. 方法细节:输入→处理→输出→为什么更好(每个创新画清楚这条线)
  3. 关键实验:哪个结果最有说服力?为什么?
  4. 论文弱点:作者自述 + 你的判断
  5. 代码对应:每个 component 对应哪个文件/函数

Round 4:询问用户 ⛔

必须问风格选择,用户未回则默认 academic。

Round 5:写作输出HTML ⛔

按选定风格的要求写,输出完整HTML。模板见下文。

Round 6:自我审查 ⛔

逐项检查,不通过则修改直到通过。


三风格详细要求


storytelling(故事型), 像一篇公众号爆文

硬标准:

  • 字数 ≥ 3000
  • 段落 ≥ 15
  • 引用论文原文 ≥ 3 处
  • 生动类比/比喻 ≥ 2 个
  • 结尾金句 1 句

结构要求(按顺序,缺一不可):

1. 钩子开头(2-3段), 反常识问题 / 引人共鸣的场景 / 让人"等等再说一遍?"的事实, 不要直接讲技术。先让读者好奇。

2. "为什么会这样"(3-4段), 解释现有方法的逻辑和它的瓶颈, 用简单例子说明, 让读者感到"确实需要一种新方法"

3. 核心洞察(1-2段), 论文最关键的那一句话发现, 用一句话说清楚 + 一个类比强化

4. 方法详解(5-8段,全文最重点), 分步骤展开:怎么做 → 为什么这样设计 → 和旧方法的关键区别, 每个步骤配一个类比, 引用论文原文(公式/算法描述)≥ 3 处, 用对比表呈现新旧方法差异

5. 实验效果(3-4段), 最重要的实验结果 + 数据解读, 不只是报数字,要解释"这意味着什么", 用表格呈现关键对比数据

6. 深层意义(2-3段), 这个工作对行业意味着什么, 不止一个角度:技术意义、产业意义、方法学意义

7. 局限(1-2段), 作者自述的局限 + 你的判断

8. 收束(1段), 回到开头的场景/问题,形成闭环, 读者带着"我懂了"的感觉离开

9. 金句, 一句话,让人能记住并转述

写法要求:

  • 多用"你"和读者对话("你有没有想过""你猜怎么着")
  • 段落短,一段不超过 4 句话
  • 技术词出现时要立刻给"人话解释"
  • 数据要翻译成可感知的东西("15 斤荔枝"而不只是"15 斤")

academic(学术型), 比论文更清晰的深度解析

Read the whole SKILL.md on GitHub

More in Engineering