夜雨聆风
把技术书变成 AI 技能？这个开源工具让每本书都成为你的"专属教练"
一本买了就忘的书，终于有了救星
你有没有过这样的经历？
花几百块买了一本技术经典——《设计数据密集型应用》《Pro Git》《Think Python》。翻开读了一遍，觉得收获满满。三个月后，你想回顾第七章讲的内容，打开 PDF 一看……完全想不起目录里有这一章。
这不是你记忆力差，而是传统知识管理方式有个致命缺陷：书读完之后，知识就锁在了 PDF 里。
今天介绍的这个开源项目，可能彻底改变你和书籍的交互方式——book-to-skill，只需一行命令，就能把任何技术书籍变成 AI Agent 的技能文件。
江达小记 🔗 项目地址：https://github.com/virgiliojr94/book-to-skill⭐ 13,900+ Stars | 🍴 1,500+ Forks | MIT 开源协议
💡 它到底是什么？
简单说：book-to-skill 是一个将技术书籍转化为 AI Agent 技能（Skill）的工具。
安装到你的 Claude Code、GitHub Copilot CLI 或 Amp 之后，你可以用自然语言跟书对话——问它任何内容，它会精准定位到对应章节并给出答案，不会幻觉，不会瞎编。
整个流程只有三步：
指向一本书 —— /book-to-skill ./my-book.pdf
AI 自动提炼 —— 生成框架、决策规则、反模式、按章节拆分的文件
按需加载 —— 问 /your-book replication，它读取对应章节回答你
听起来像是"RAG"？作者说不是。RAG 是运行时检索，book-to-skill 是编译时深度分析。
江达小记 RAG 回答："这里有你查询相关的片段。"Skill 回答："这本书的作者构建了 12 个框架，每个都标注了何时使用。"
🚀 它能生成什么？
运行一次命令后，会在你的 Agent Skills 目录生成一套完整的文件结构：
| SKILL.md | ||
| chapters/ch01-*.md | ||
| glossary.md | ||
| patterns.md | ||
| cheatsheet.md |
关键设计：章节文件按需加载。 只有当你问到某个主题时，对应的章节才会被读取，不会占用你的 token 预算。
📊 数据说话：24 倍到 51 倍的效率提升
作者做了一个硬核对比实验，用三本真实书籍测试了三种方式回答一个问题的 token 消耗：
| 24× / 2.4× | ||||
| 35× / 6.7× | ||||
| 51× / 15.6× |
这意味着什么？
直接倒入全文：每轮对话都要消耗全部 token，永无止境
发现循环：AI 自己翻 PDF、找目录、回溯，每次都在重复劳动
book-to-skill：一次性编译，之后每轮只需加载核心 + 对应章节
而且这个优势会随章节大小放大——章节越大，效果越明显。
🛠️ 支持哪些格式？
几乎你能想到的所有文档格式都支持：
PDF（文本型/技术型自动识别）
EPUB、DOCX、TXT、Markdown
reStructuredText、AsciiDoc、HTML、RTF
MOBI / AZW / AZW3（Kindle 格式）
技术型 PDF 推荐用 Docling（保留表格和代码块），纯文字型用 pdftotext（秒级提取）。工具会自动帮你选择最佳方案。
🏢 不只是书
虽然名字叫"book-to-skill"，但它的适用场景远不止技术书籍：
📋 内部文档 —— 架构决策记录、运维手册、入职指南，整个 docs/ 文件夹打包成一个技能
🎨 品牌设计系统 —— 语音指南、设计规范，把 60 页的 PDF 变成团队随时可查的技能
🔬 研究论文集群 —— 多篇论文+笔记合并为一个统一技能，新论文来了还能增量更新
📐 规范与标准 —— RFC、API 合同、合规文档，你经常查阅但永远不会背下来的东西
判断标准很简单：如果你会反复打开一份文档，它就是一个候选。
⚡ 快速上手
安装
# 方式一：作为 Agent Skill（推荐） git clone https://github.com/virgiliojr94/book-to-skill.git ~/.agents/skills/book-to-skill # 方式二：作为独立 CLI 工具 pip install book-to-skill 江达小记
转换一本书
# 在 Claude Code / Copilot CLI / Amp 中运行 /book-to-skill~/books/designing-data-intensive-apps.pdf ddia 江达小记
使用技能
/ddia # 加载核心心智模型 /ddia replication # 查找并解释某个主题 /ddia ch05 # 深入第五章 /ddia"what chapters do you have?"# 看看它有哪些章节 江达小记
每本书的转换成本大约 $1（按 Claude Sonnet 4.5 定价估算），远低于反复翻阅 PDF 的时间成本。
🧠 设计哲学：密度优于完整
作者总结了五个核心设计原则，非常值得借鉴：
密度大于完整 —— 1,000 token 的精华摘要胜过 10,000 token 的原文摘录
从业者视角 —— "Y 场景下用 X"，而不是"这本书解释了 X"
SKILL.md 前置 —— 最重要的内容放在前面约 5,000 tokens
按需加载章节 —— 话题索引告诉 AI 读哪一章，不用的不加载
永远不做原文堆砌 —— 始终做提炼、总结、提取信号
✅ 优点 & ⚠️ 注意事项
优势
🎯 精准回答：基于真实书籍内容，不幻觉
💰 成本极低：每本书约 $1 的转换费，之后每轮对话 token 消耗大幅降低
🔧 多 Agent 兼容：Claude Code、Copilot CLI、Amp 通用
📦 增量更新：新资料可以随时折叠到已有技能中
🌍 多语言章节识别：阿拉伯数字、罗马数字、中文、韩文、泰文等
注意事项
⚠️ 需要清晰的章节标题：如果书籍没有标准章节标记（如"第 N 章"），自动分段可能不准确
⚠️ 适合反复查阅的知识：一次性阅读的书用普通 PDF Agent 就够了
⚠️ 依赖外部提取工具：PDF 技术型提取需要安装 Docling，有一定学习成本
🎯 总结
book-to-skill 解决了一个真实且普遍的问题：我们读了很多书，但大部分知识都在读完之后就锁进了抽屉。
它不只是一个"把 PDF 喂给 AI"的工具，而是通过编译时深度分析，将书籍的结构化知识提取为 Agent 可直接推理的技能。每一次对话，AI 加载的不再是整本书的原文，而是作者花数年构建的框架、原则和心智模型。
在这个 AI 能力飞速发展的时代，book-to-skill 提供了一个全新的思路：不是让 AI 读你的书，而是让你的书成为 AI 的能力。
如果你经常阅读技术书籍、内部文档或研究论文，这个工具绝对值得试试。
💬 互动话题：你读过哪本书后悔没有好好利用？或者你有什么独特的知识管理方法？欢迎在评论区聊聊！
🔗 相关链接：
GitHub：https://github.com/virgiliojr94/book-to-skill
Agent Skills 标准：https://github.com/agentskills/agentskills
Trendshift 排行榜：https://trendshift.io/repositories/27038
