# Guided Book Reader

> 带读英文技术书 PDF 的工作流 skill。用于用户想认真阅读一本英文技术书、论文集或长篇 PDF，并希望 Codex 先读取和解析 PDF、转成 txt、按章节拆分，然后用中文为主的 teach 风格逐小节讲解、出选择题检查理解，并把每节阅读总结追加到 notes markdown。

- Skill: `shyxin/guided-book-reader` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add shyxin/guided-book-reader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shyxin/guided-book-reader/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: shyxin (https://skillmd.com/u/shyxin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/shyxin/guided-book-reader

---


# Guided Book Reader

## 目标

把一本英文技术书 PDF 变成可持续阅读的学习项目：

1. 读取 PDF。
2. 转成全文 txt。
3. 按章节拆分成独立 txt。
4. 创建 `notes/`。
5. 用中文为主、对话式深读的方式逐小节带读。
6. 每小节后用选择题确认理解。
7. 每读完一节，更新对应 markdown 笔记。

## 工作流

### 1. 准备文本

当用户给出 PDF 路径时，先检查文件是否存在。然后运行：

```powershell
python <skill_dir>/scripts/split_pdf_by_chapters.py "<pdf_path>"
```

脚本会优先调用本机的 `pdftotext -layout`，将 PDF 转成全文 txt，再根据正文中的章节标题自动切分。

如果脚本输出的章节明显不完整，先不要继续讲书。把 `MANIFEST.txt` 展示给用户，让用户确认或提供需要修正的章节标题/边界。

### 2. 建立阅读目录

默认在 PDF 同级目录下创建同名目录，例如：

```text
book.pdf
book/
  00-Preamble.txt
  01-Chapter.txt
  notes/
  MANIFEST.txt
```

如果用户指定输出目录，使用用户指定目录。

### 3. 带读方式

读取对应章节 txt。进入新章节时，先给 5-8 行中文路线图，说明本章要解决什么问题、和上一章如何连接、内部小节大致怎么推进。

正式带读时，一次只讲一个小节；如果小节很长，再拆成 2-3 个阅读块。不要一次讲完整章，除非用户明确要求。

每小节使用这个结构：

1. 说明这一小节在本章中的作用：承接什么、铺垫什么、为什么现在讲。
2. 处理必要英文术语：给中文翻译、在本书语境里的意思、常见误解。
3. 说明作者在反对什么误解、建立什么区分或工具。
4. 用中文解释核心意思，默认保持对话式深度，不要压成提纲。
5. 给一个贴近日常、工程或书中主题的例子，把概念落地。
6. 说明这个点为什么重要，以及它如何影响后续阅读。
7. 用一句话总结。
8. 给一道选择题，并标出推荐答案。

详细风格见 `references/teaching-style.md`。

### 4. 笔记更新

每读完一节，都更新 `notes/chapter-XX-<slug>-notes.md`。

笔记保持中文复习版，不要和聊天讲解一样长，也不要堆英文原文：

- 核心意思
- 例子
- 结论

只保留必要英文术语，例如 `facts`、`concepts`、`categories`、`modalities`。

聊天里讲得丰富，notes 只保留复习地图。

### 5. 继续阅读

用户说“继续”时：

1. 找到当前章节和上次读到的小节。
2. 继续下一小节。
3. 保持同样讲解粒度。
4. 更新 notes。

如果无法确定进度，读取 `notes/` 和当前章节 txt，推断最近读到的位置；推断不稳时，简短询问用户。

## PDF 切分策略

优先使用已经验证过的路线：

```text
pdftotext -layout -> full.txt -> Python 按章节标题切分
```

不要默认依赖 `pypdf`、`PyPDF2`、`pdfplumber` 等 Python 包。只有在 `pdftotext` 不可用时，才考虑其它方案或提示用户安装 Poppler/Git for Windows。

## 交互原则

- 中文为主。
- 英文术语不只是列词表：要解释中文含义、本书语境和容易误解的地方。
- 不要大段复制原文。
- 用户说“太简洁”时，补充例子和解释。
- 用户说“太多”时，拆小节、缩短输出。
- 用户希望选择题时，固定用 A/B/C/D。
- 用户要求写 notes 时，立即落盘，不只在聊天里总结。
- 不要每次都输出 notes 文件完整路径。notes 照常写，聊天里最多一句“笔记已同步”，除非用户要路径。