# Paper Explainer

> AI论文解读工具。面向产品经理、运营等非技术背景但对AI感兴趣的读者，将晦涩的学术论文转化为图文并茂的通俗研报：讲清楚”这个技术解决什么问题、有多厉害、对业务意味着什么”，配以极简科技风插图，并输出莫兰迪风格的 HTML 单文件。

- **Type:** Skill
- **Install:** `agentstack add skill-pompeiichan-skills-explainpaper-skills-explainpaper`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [PompeiiChan](https://agentstack.voostack.com/s/pompeiichan)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [PompeiiChan](https://github.com/PompeiiChan)
- **Source:** https://github.com/PompeiiChan/skills-ExplainPaper

## Install

```sh
agentstack add skill-pompeiichan-skills-explainpaper-skills-explainpaper
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Paper Explainer Skill

这是一个专门用于解读 AI/CS 领域技术论文的技能。

**目标读者**：产品经理、运营、业务负责人——对 AI 感兴趣，但没有算法/工程背景。  
**核心目标**：去掉学术腔和工程术语，用”讲故事”的方式说清楚三件事：
1. 这个技术在解决什么痛点？
2. 它怎么做到的？（用类比，不用公式）
3. 对我们的产品/业务意味着什么机会？

## 核心能力
1.  **故事化叙事**：不复述摘要，而是从”旧方案有什么死穴”开始讲，讲到”新突破怎么绕过去的”。
2.  **视觉化解构**：对最难懂的概念画”极简对比图”或”流程演进图”，让不懂技术的人看一眼就明白。
3.  **沉浸式研报**：生成莫兰迪配色的 HTML 单文件，带关键数字卡片、结论高亮块，提供优质的阅读体验。

## 依赖说明
- **图像生成**：本技能将直接生成 **SVG 矢量图代码**，无需外部 API 调用。这能确保生成的图表精准、清晰且风格统一。
- **联网搜索**：需要调用 WebSearch 或 WebFetch 工具来处理 URL 输入。

## 工作流程 (Workflow)

当用户提供一篇论文（PDF、文本或 **URL链接**）并要求解读时，**在开始之前先读取 `prompts/narrative.md` 和 `prompts/visual.md`**，然后按以下步骤执行：

### Step 0: 内容获取

- **本地文件**：直接读取。
- **URL**：用 `WebFetch` 抓取；内容截断时用 `WebSearch` 找 arXiv 纯文本页重新抓取；过滤导航/广告，只保留正文。

### Step 1: 理解论文，构建叙事脉络

读完全文后，在内存中整理三个问题的答案：
1. 旧方案的死穴是什么？（对应 Phase 1）
2. 新方案的核心思路是什么？最适合用什么类比解释？（对应 Phase 2）
3. 对 PM 而言最重要的结论和机会点是什么？（对应 Phase 4）

同时标记 **2-3 个”视觉锚点”**：最抽象、用文字说不清楚、但画一张图就能秒懂的概念。优先考虑 Before/After 对比图。

### Step 2: 按叙事框架撰写正文

严格按照 `prompts/narrative.md` 的五个 Phase 撰写，写到视觉锚点时直接内联生成 SVG（参考 `prompts/visual.md` 的规范）。

**SVG 生成要点**：
- 先选图表类型（对比图/流程图/模块图），再动笔
- SVG 直接嵌入文档，不保存为外部文件
- 每张图只讲一个概念，不超过 5 个元素

### Step 3: 生成 HTML 研报

按照 `prompts/html_style.md` 的规范将正文转为完整 HTML：

1. Phase 0 之后必须插入 `stat-cards`，展示 1-3 个最重要的对比数字
2. Phase 4 的”选型建议”必须用 `insight-box` 呈现
3. 代价/风险用 `warning-box` 标出
4. SVG 直接内联到 HTML 中，不使用 `` 外链
5. 保存为 `./output/{paper_keyword}_report.html`

## 文件管理规范 (File Management)
- **输出根目录**：`./output/` (相对于当前项目工作目录)
- **图片存储路径**：`./output/assets/images/` (自动创建)
- **图片命名格式**：`{paper_keyword}_{concept}.svg`
    - 例如：`deepseek_r1_grpo.svg`
- **HTML 报告路径**：`./output/reports/` (建议新建此目录)
- **提示词记录**：(可选) 将生成的 prompt 保存到 `./output/assets/prompts/` 以便复用。

## 资源索引 (相对于本技能文件夹)
- **叙事框架**：`prompts/narrative.md`
- **绘图规范**：`prompts/visual.md`
- **HTML 样式**：`prompts/html_style.md`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [PompeiiChan](https://github.com/PompeiiChan)
- **Source:** [PompeiiChan/skills-ExplainPaper](https://github.com/PompeiiChan/skills-ExplainPaper)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-pompeiichan-skills-explainpaper-skills-explainpaper
- Seller: https://agentstack.voostack.com/s/pompeiichan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.