用途
read-book 用于从书籍和长 PDF 中提取结构化笔记。它接受多种输入格式，包括 PDF、EPUB、MOBI、Markdown、.txt、粘贴的文本，以及指向公共领域作品（如 Project Gutenberg、archive.org）的 URL。该技能与 watch-video 是同类内容消费模式：摄取 → 分块 → 提取 → 可选捕获到 second-brain。
主要能力
- 多格式输入解析：PDF 通过 Claude 原生分页读取；EPUB/MOBI 需要 pandoc 或 ebook-convert 提取；Markdown/.txt 直接读取；粘贴文本直接使用；公共领域 URL 通过 WebFetch 获取。根据文件扩展名检测类型，若不确定则询问用户。
- 四种输出模式：
notes（默认）：逐章生成 TL;DR、关键概念、引文、行动项和框架。summary：整本书 TL;DR（一段话）+ 3–5 个关键要点 + 适合人群。quotes：仅提取引文亮点，附章节上下文和页码引用。study：notes 模式 + 10–20 张间隔重复问答卡片。
- 智能分块策略：优先按章节（若存在目录），否则 PDF 按每 50 页分块，文本/Markdown 按每 30,000 字符分块。分块计划保存为 chunks.json。
- 逐块提取与聚合：循环读取每个分块，按所选模式提取内容，追加到分块笔记文件，最后合并为完整的 notes.md，包含元数据块和 second-brain 兼容的 frontmatter。
- 可选捕获到 second-brain：询问用户是否将最终笔记写入 second-brain 的 raw/ 目录，默认询问而非自动写入。
- 渲染选项：可通过
--render pdf或--render html将最终笔记渲染为 PDF 或 HTML（使用 pandoc 和指定 CSS）。
使用方式
基本调用：/read-book <input>，默认使用 notes 模式。
指定模式：/read-book <input> summary、/read-book <input> quotes、/read-book <input> study。
附加选项：--capture 跳过询问直接写入 second-brain；--render pdf 或 --render html 渲染输出。
对于超过 200 页的长书且未指定模式，默认使用 notes 但会警告需要多次工具调用。
适用场景
- 阅读并提取书籍或长 PDF 的结构化笔记。
- 为研究问题查找书籍证据，与 deep-research 技能配合。
- 为商业头脑风暴提供结构化证据。
- 为决策提取权威著作的相关章节。
- 将书籍要点转化为演讲材料（与 slide-deck 配合）。
- 研究同类书籍以辅助写作（与 nonfictionskills / fictionskills 配合）。
- 与 second-brain 集成，将笔记合并到 wiki 页面。
限制
- EPUB/MOBI 需要 pandoc 或 ebook-convert（calibre 包含），否则无法提取。
- 扫描版 PDF（无文本层）需要先进行 OCR（如 ocrmypdf）。
- PDF 无目录时回退到每 50 页分块。
- 超过 500 页的书籍会警告成本/时间，并询问是否改用 summary 模式。
- 分块提取为空时跳过该分块并记录，不中断整个流程。
- 笔记质量要求：不要过度压缩导致失真；保留具体名称、数字、日期和引文；引文需逐字复制并尽量标注页码；行动项需明确标出；框架需单独列出。
- 交叉引用建议仅为建议，不会自动应用，需由 /sb compile 处理。
- 默认不自动写入 second-brain，需用户确认。