read-book 是一个从书籍和长篇 PDF 中提取结构化笔记的技能，定位为 watch-video 的兄弟技能，采用相同的内容消费模式：摄取 → 分块 → 提取 → 可选捕获到 second-brain。
一、用途与输入 它接受多种输入：PDF 文件路径（通过 Read pages:"X-Y" 分块原生读取）、EPUB / MOBI 文件路径（需 pandoc 或 ebook-convert 提取）、Markdown / .txt 文件路径（直接读取）、粘贴文本，以及指向公共领域文本的 URL（使用智能体的 URL 抓取工具或 curl，如 Project Gutenberg、archive.org）。类型从文件扩展名判断，不明确时会询问。
二、模式 notes（默认）：逐章输出 TL;DR + 关键概念 + 引语 + 行动项 + 框架。summary：全书 TL;DR（一段）+ 3–5 条关键要点 + 适合谁读。quotes：仅提取重点引语，附章节背景与页码引用。study：notes 模式 + 10–20 张间隔重复问答卡片。若书超过 200 页且未指定模式，默认 notes 并提示会消耗较多工具调用。
三、分块策略 按优先级混合分块：有目录时按章节（带书签的 PDF、经 pandoc 转换保留章节标题的 EPUB/MOBI）；无目录的 PDF 按页数，每块 50 页；文本/Markdown 按字符数，每块 30,000 字符（约 7,500 词）。可用 pdfinfo <pdf> | grep "Pages" 查看页数，用 pdftotext -layout <pdf> | grep -i "^chapter|^part" 检测章节，或从第 1–5 页读取目录。EPUB 经 pandoc <epub> -o tmp.md 后，块位于 # Chapter X 标题之间。分块计划保存为 ~/Documents/books/<author>-<title-slug>-<YYYY-MM-DD>/chunks.json，包含 source、title、author、type、total_pages、chunking 与 chunks 数组。
四、读取与汇总 循环读取每个分块并按模式提取，追加到 notes-<NNN>-<label-slug>.md；PDF 不要一次读完（Claude 的 PDF 工具上限约 10 页）。分块无有用内容时记录跳过并继续。最后合并为 notes.md，顶部包含元数据块与 second-brain 兼容的 frontmatter（source、captured、type、book_title、author、mode、chunks、chunking），并含 TL;DR、关键要点、章节笔记、跨引用建议（供 /sb compile 使用，不自动应用）。
五、捕获与报告 会询问是否捕获到 second-brain（默认询问、绝不自动写入）：写入 ${SECOND_BRAIN_VAULT:-$HOME/Documents/SecondBrain}/raw/highlights-<slug>.md，并告知路径、建议稍后运行 /sb compile。最后在聊天中报告一行标题、工作目录路径、TL;DR 及要点/引语。
六、快速调用 /read-book <input> 使用 notes；加 summary、quotes、study 切换模式；--capture 跳过询问直接写入 second-brain raw/；--render pdf 或 --render html 通过 pandoc 渲染（使用 ~/.local/share/makerskills/render.css）。
七、组合与错误处理 可与 second-brain（主集成）、deep-research、business-brainstorm、decide、slide-deck、watch-video、nonfictionskills / fictionskills 组合。错误处理：EPUB/MOBI 缺 pandoc / ebook-convert 时提示 brew install pandoc 或 brew install calibre；扫描版 PDF 建议先 OCR（brew install ocrmypdf && ocrmypdf <pdf> <pdf-ocr.pdf>）；无目录 PDF 回退 50 页分块并记录；超 500 页提示成本/时间并询问是否改用 summary；分块提取为空则跳过并继续。质量要求：不要概括到失真、保留具体细节、引语逐字复制并尽量标页码、显式标注行动项、为作者命名的框架单独列出。
使用方式、适用场景与限制：该技能通过斜杠命令调用，适用于从书籍和长篇 PDF 中提取结构化笔记并可选接入 second-brain 工作流；资料未提供具体收费、价格、平台支持范围或效果保证等信息，暂未提供。