一键转换多种资料格式：支持 PDF、EPUB、DOCX、TXT、Markdown、reStructuredText、AsciiDoc、HTML、RTF、MOBI/AZW/AZW3 等格式，且可指向单个文件、文件夹或通配符批量处理。

生成结构化知识体系：每次转换会生成一整套文件——SKILL.md（核心心智模型 + 章节索引）、chapters/（每章独立提炼文件）、glossary.md（术语表）、patterns.md（技巧与设计模式库）、cheatsheet.md（决策速查表）。

智能识别书籍类型：自动区分“技术书”与“纯文字书”，技术书走 Docling 保留表格与代码，纯文字书走 pdftotext 追求速度。

按需加载、防止幻觉：运行时仅常驻约 4,000 token 的核心文件，章节按需加载，回答均基于真实内容，避免 AI 胡编乱造。

显著节省 Token：实测相比把整本书丢进上下文省 24–51 倍 token，把导航成本集中在编译时一次性支付。

跨平台兼容：遵循开放 Agent Skills 标准，一次安装即可在 Claude Code、GitHub Copilot CLI、Amp 等多个宿主中使用。

第一步：安装提取依赖。运行 python3 scripts/extract.py --check 体检环境；纯文字书安装 pdftotext（poppler-utils），技术书安装 docling（pip3 install docling），纯文本与 Markdown 等格式无需额外安装。

第二步：指向你的资料。在支持 Agent Skills 的工具中输入命令，例如 /book-to-skill ./my-book.pdf，也可指向文件夹或通配符。

第三步：选择书籍类型。提取前回答是“技术书（technical）”还是“纯文字书（text-heavy）”，工具会自动匹配对应提取工具，选错会丢失表格与代码。

第四步：等待生成技能。工具会自动分析标题、作者、章节与目录，生成每章提炼、术语表、模式库、速查表和核心 SKILL.md，并写入对应目录：~/.claude/skills//、~/.copilot/skills// 或 ~/.agents/skills//。

第五步：像用技能一样使用。输入 /<书名slug> 加载核心心智模型，输入 /<书名slug> replication 定位讲解某个主题，输入 /<书名slug> ch05 直接钻入第 5 章。

结构优先于摘要：它提炼的是“为应用而结构化”的知识——命名框架、决策规则、反模式，而非一段段原文摘录，Agent 拿到的是可直接推理的素材，而不是一堆待翻页的关键词。

省钱省时间：编译一本书约 1 美元，之后每次问答仅需约 5,000 token，相比每次会话重新喂 PDF，边际成本趋近于零；章节越大优势越明显，实测最大节省 51 倍。

消除“探索循环税”：把 Agent 反复翻页、跳转、回退的导航成本压缩到编译时一次性支付，避免运行时上下文爆炸与摘要失真，完整原文仍留档可核对。

开放与可扩展：遵循开放 Agent Skills 标准，不被单一厂商绑定；提供 CLI 与 Python 包，可脚本化、可更新，新资料可随时“折叠”进既有技能，持续保鲜。

技术开发者：经常阅读技术书籍、需要在工作流中快速引用书中框架与算法的人，例如在 Claude Code、GitHub Copilot CLI 中边写代码边查《设计数据密集型应用》。

文档维护者与团队：需要把内部文档（架构决策记录、运维手册、新人指南）、品牌设计系统、规范与标准（RFC、API 契约、合规文档）沉淀为团队共享技能的组织。

研究者与学生：需要把论文合集、课程资料和自己的笔记合并成统一技能，并在新材料到来时持续更新的研究者与深度学习者。

知识长期主义者：想把读过的每一本书都转化为“AI 随叫随到、还不瞎编的外挂大脑”，提升学习转化率、避免知识折旧的人。

Q1: book-to-skill 支持哪些输入格式？
A1: 支持 PDF、EPUB、DOCX、TXT、Markdown、reStructuredText、AsciiDoc、HTML、RTF、MOBI/AZW/AZW3 等常见格式，并支持指向文件、文件夹或通配符批量处理。
Q2: 生成的文件存放在哪里？
A2: 依据宿主不同而不同：Claude Code 存于 ~/.claude/skills//，GitHub Copilot CLI 存于 ~/.copilot/skills//，Amp 存于 ~/.agents/skills//。
Q3: 使用 book-to-skill 需要付费吗？
A3: 项目本身基于 MIT 协议完全开源免费；编译一本书仅需调用一次大模型，按 Claude Sonnet 4.5 估算约 1 美元，远低于反复把整本书喂给 AI 的成本。
Q4: 支持中文书籍吗？
A4: 支持。v1.2.0 起章节检测真正实现了多语言，中文技术书、中文文档均可正常转换与使用。
Q5: 转换后 AI 会幻觉吗？
A5: 不会。Agent 按需加载对应章节，从真实内容中回答，且核心 SKILL.md 明确标注“仅覆盖本书内容”，有效避免胡编乱造。
Q6: 新资料如何更新进已有技能？
A6: 把新文件、新章节再次指向既有技能目录运行 book-to-skill，即可将新材料“折叠”进原技能，保持知识持续更新。