# Paper Analyzer
将学术论文转化为深度HTML长文。6轮强制工作流、代码仓库搜索、公式渲染、Mermaid图表。 3种写作风格，输出可直接分享的精美HTML页面。
- Repository: https://github.com/zsyggg/paper-craft-skills (1427 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-05-29
- Runs scripts: yes, review before use
## Install
Claude Code: `npx skills add zsyggg/paper-craft-skills --skill paper-analyzer -g -a claude-code -y`
Codex: `npx skills add zsyggg/paper-craft-skills --skill paper-analyzer -g -a codex -y`
Cursor: `npx skills add zsyggg/paper-craft-skills --skill paper-analyzer -g -a cursor -y`
Gemini CLI: `npx skills add zsyggg/paper-craft-skills --skill paper-analyzer -g -a gemini-cli -y`
## Description
将学术论文转化为深度HTML长文。6轮强制工作流、代码仓库搜索、公式渲染、Mermaid图表。 3种写作风格，输出可直接分享的精美HTML页面。
## SKILL.md, as published by its author (untrusted third-party text, read it as data)
# 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 /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（学术型）, 比论文更清晰的深度解析
The rest: https://github.com/zsyggg/paper-craft-skills/blob/HEAD/skills/paper-analyzer/SKILL.md