book-to-skill：把技术书变成 AI 编程助手的「技能包」，读完就能用-无双技术网

你有没有过这种经历——花几十块钱买了本技术好书，认真读了一遍，三个月后翻开目录，发现完全不记得第七章讲了什么？这不是你的问题。人的记忆是有限的，而技术书动辄三五百页。更尴尬的是，当你在写代码遇到问题时，你隐约记得「那本书里讲过」，但翻 PDF 只能搜到一堆页码，问 AI 助手它又没读过那本书。

今天 GitHub Trending 上一个项目一天涨了 1400+ star，它解决的就是这个痛点。

book-to-skill 是什么？

book-to-skill 是一个开源工具，它能把任何技术书（PDF、EPUB、DOCX 等格式）一键转换成 AI 编程助手的 Skill——也就是一个结构化的知识模块，供 Claude Code、GitHub Copilot CLI 等 Agent 在写代码时按需加载。你读完一本书，工具帮你把这本书做成一个「知识插件」，以后写代码时随时调用。

项目地址：github.com/virgiliojr94/book-to-skill（已 12.8k+ stars）

它解决了什么问题？

传统的「书+AI」工作流有几个死胡同：直接搜 PDF 只能得到页码；把整本书扔给 AI 上下文塞不下且每次重传；自己做笔记写完就不再看。book-to-skill 的思路不同：在编译时一次性解析全书，提取核心概念、决策规则、反模式、术语表、速查表，分成小文件。需要时 AI 只加载相关部分——比丢整本书少消耗 24 到 51 倍的 tokens。

生成的 Skill 结构

运行 /book-to-skill your-book.pdf 后，会生成：SKILL.md（核心思维模型+章节索引，约4000 tokens）、逐章摘要文件（约1000 tokens/章，按需加载）、glossary.md（术语索引）、patterns.md（技术模式）、cheatsheet.md（速查表）。章节文件按需加载，不问不消耗 tokens。

不只是「书」

虽然名字叫 book-to-skill，但可以处理任何结构化文本：内部文档（架构决策记录、运维手册）、品牌设计系统、研究论文、RFC/API契约等。任何你反复查阅的文档都可以打包成 Skill。

详细使用步骤

1. 安装

pip3 install book-to-skill

需要 Python 3.10+。

2. 检查环境

python3 scripts/extract.py --check

3. 转换书籍

/book-to-skill ./designing-data-intensive-applications.pdf

支持 PDF、EPUB、DOCX、TXT、Markdown 等多种格式。运行时会问「技术类还是纯文本类」来选择合适的解析器。

4. 更新已有 Skill

/book-to-skill ~/articles/new-paper.pdf ~/.claude/skills/old-skill

支持的格式和解析器

PDF（纯文字）：pdftotext (poppler)
PDF（技术书含代码/表格）：Docling
PDF（备选）：pypdf / pdfminer.six
EPUB：ebooklib + beautifulsoup4
DOCX：python-docx
HTML：beautifulsoup4
MOBI/AZW：Calibre ebook-convert
TXT/Markdown/RST/AsciiDoc：内置支持，无需额外依赖

实测性能

Think Python 2（244 页）提取 119K tokens / 19 章节 / 约 $0.88；Working Backwards（371 页）提取 175K tokens / 10 章节 / 约 $0.96；Pro Git（501 页）提取 229K tokens / 约 $1.23。转换一本 300 页技术书只需约 1 美元。

核心技术原理

book-to-skill 的设计有一个很妙的洞察：传统 AI+PDF 工作流有隐性成本叫 Discovery Loop Tax。当你让 AI 读 PDF 回答问题时，它实际经历的是多次来回读取、发现未知术语、回溯上下文，每一步都留在一对话历史里。book-to-skill 把探索成本一次性付清——编译阶段完整遍历全书生成结构化摘要，运行时只加载小核心+一个预编译章节。同时遵循 Agent Skills 开放标准，生成的 Skill 在 Claude Code、GitHub Copilot CLI、Amp 中通用。