# Paper Comic

论文方法图解, , 用视觉图解彻底讲清楚一篇论文到底做了什么、怎么做的。...

- Repository: https://github.com/zsyggg/paper-craft-skills (1427 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-05-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add zsyggg/paper-craft-skills --skill paper-comic -g -a claude-code -y`
Codex: `npx skills add zsyggg/paper-craft-skills --skill paper-comic -g -a codex -y`
Cursor: `npx skills add zsyggg/paper-craft-skills --skill paper-comic -g -a cursor -y`
Gemini CLI: `npx skills add zsyggg/paper-craft-skills --skill paper-comic -g -a gemini-cli -y`

## Description

论文方法图解, , 用视觉图解彻底讲清楚一篇论文到底做了什么、怎么做的。 自动分析论文核心方法，先推荐封面/概述图/机制细节图的生成方案，必须由用户确认范围、张数、语言、风格后再生成。 支持温暖笔记风和论文框架图风。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Paper Method Illustrated, 论文方法图解

把论文的核心方法用视觉图解彻底讲清楚。

## 与其他技能的本质区别

| | 传统paper-comic | baoyu-article-illustrator | **我们：方法图解** |
|---|---|---|---|
| 聊什么 | 什么都聊一点 | 为文章配装饰图 | **只聊方法细节** |
| 深度 | 一页讲很多→浅 | 一张图一段话→中 | **一张图讲透一个机制→深** |
| 页数 | 固定10页 | 按密度5-20张 | **先推荐封面/概述/细节图组合，用户确认后生成1-10张** |
| 重点 | 讲背景+故事 | 美化文章排版 | **可视化"怎么做"** |

## 快速开始

```bash
/paper-comic /path/to/paper.pdf
/paper-comic https://arxiv.org/abs/2512.xxxxx
/paper-comic /path/to/paper.pdf --style sketchnote
/paper-comic /path/to/paper.pdf --style paper-figure --language English --pages 1
```

---

## 图片生成：自动检测

和paper-analyzer一样，不硬编码任何API。运行时自动检测：

| 环境 | 自动使用 |
|------|---------|
| **Codex** | 内置 `imagegen` skill |
| **Claude Code** | 已安装的生图skill（如baoyu-image-gen） |
| **Cursor/其他** | 自动检测 → 没有则提示安装 |

**不写死任何API key、token或endpoint在SKILL.md里。**

---

## 核心哲学

### 我们只画三样东西

1. **方法流程**, 输入→处理→输出，这方法到底怎么走的
2. **核心机制**, 最创新的那个部分，拆开来看内部构造
3. **关键结果**, 只放最重要的实验结果，不放灌水数据

### 我们不画的东西

- ❌ 相关工作/背景介绍（那是paper-analyzer文字部分的事）
- ❌ 抽象的"灵感来源"（没有信息量的图 = 浪费）
- ❌ 文字就能说清楚的东西（一句话能讲完不需要画）
- ❌ 第N个消融实验的柱状图

### 每一张图的标准

> 一个完全没读过论文的人，只看这张图+图上的标注文字，能不能理解这个机制？

能 → 通过。不能 → 拆成两张，或者加更多标注。

---

## 生成前必须确认

默认**不要直接生成图片**。先读论文、给出推荐方案，再向用户确认。

只有当用户已经明确给出足够完整的生成意图时，才可以跳过确认，例如：
- “生成一张中文 sketchnote 方法总览图”
- “生成 4 张：封面、总览、两个机制细节，英文 paper-figure”
- “按你推荐的全部生成，中文，sketchnote”

如果用户只给了论文链接、只说了风格（如“sketchnote”）、或只说“生成图解”，仍然必须确认，因为**风格不等于范围/张数授权**。

确认时必须覆盖：

1. **图片语言**：中文 / English / 双语
2. **生成范围**：只要封面图、只要方法总览图，还是概述图 + 若干机制细节图 + 结果图
3. **推荐张数**：基于论文复杂度给出建议，并说明为什么，如“我建议6张，因为这篇论文有整体架构、两个核心attention机制、编码器/解码器结构和关键实验结果”
4. **视觉风格**：`sketchnote` 或 `paper-figure`
5. **用途**：README/文章封面/小红书/演示文稿/论文阅读笔记（用途决定横竖比例和文字密度）

确认话术示例：

> 我读完后建议生成6张：1张封面、1张方法总览、3张机制细节、1张关键结果。也可以只生成1张总览图，或者扩展到8张把每个机制讲更细。你想生成哪种范围？语言用中文/英文/双语？风格用 sketchnote 还是 paper-figure？

如果用户没有回答，不要继续生成。

---

## 两种视觉风格

The rest: https://github.com/zsyggg/paper-craft-skills/blob/HEAD/skills/paper-comic/SKILL.md