把技术书变成你的AI编程助手：一键将PDF文档转为可调用的智能技能

你是否曾对着厚厚的技术书籍（比如《深入理解计算机系统》《Effective Java》或《Designing Data-Intensive Applications》）反复翻查，却在写代码时仍要切出IDE、手动搜索关键词？book-to-skill 正是为此而生——它不是简单的PDF转文本工具，而是一个“知识蒸馏引擎”，能将任意技术书籍、电子文档甚至整套文档集合，自动构建成符合行业标准的Agent Skill（智能体技能），无缝接入 Claude Code、GitHub Copilot CLI 或 Amp 等AI编程环境。从此，你的知识库不再是静态文件，而是随时待命、精准响应的“第二大脑”。

核心功能

• 全格式兼容：原生支持 PDF、EPUB、DOCX、Markdown、HTML、RTF、MOBI 等主流文档格式，无需手动转换或预处理
• 智能语义切分：基于章节结构与上下文逻辑自动分块，保留技术概念完整性（如“TCP三次握手”不会被截断），避免传统文本切割导致的知识碎片化
• 一键生成标准技能包：输出符合Agent Skills开放标准的技能文件（JSON Schema + 嵌入向量），开箱即用于 Claude Code 等支持该协议的AI工具
• 本地私有化处理：所有文档解析、文本提取、向量化均在本地完成，敏感技术资料无需上传云端，保障企业级数据安全
• 多源知识融合：支持混合处理多个来源——例如将《Kubernetes权威指南》PDF + 官方API文档HTML + 自建笔记MD合并为一个统一技能，跨资料即时关联
• 轻量Python CLI工具：无复杂依赖，仅需 Python 3.9+，命令行一行指令即可启动转换流程，开发者友好，CI/CD中也可集成

适合哪些人用

如果你是以下角色之一，book-to-skill 将显著提升你的技术学习与开发效率：

• 工程师/开发者：需要频繁查阅《Redis设计与实现》《Rust编程之道》等技术书，又希望在VS Code中边写Go代码边自然提问“这本书里怎么解释epoll的边缘触发？”
• 技术文档工程师：负责维护内部SDK文档、API手册，想快速将其转化为团队可用的AI问答技能，降低新人上手成本
• 终身学习者：收藏了数十本PDF版经典教材（如《算法导论》《SICP》），渴望让这些沉睡知识真正“活”起来，成为可对话的学习伙伴
• 教育工作者：为学生定制专属学习技能包，将课程讲义、参考文献、习题解析整合为可交互的教学AI

快速上手

只需三步，5分钟内完成首次技能构建：

1. 安装：运行 pip install book-to-skill（推荐使用虚拟环境）
2. 准备文档：将技术书PDF（如 designing-data-intensive-applications.pdf）放入任一文件夹
3. 生成技能：执行命令 book-to-skill build ./my-book --name "DDIA-Skill" --output ./skills/ddia
4. 接入使用：将生成的 ddia 文件夹拖入 Claude Code 的 Skills 面板，或通过 GitHub Copilot CLI 的 copilot skill add 命令加载——现在你就能在编辑器中直接问：“DDIA里如何解释读已提交隔离级别？”

进阶用户还可通过 YAML 配置自定义分块策略、元数据标签或嵌入模型（默认使用免费开源的all-MiniLM-L6-v2）。

项目信息

编程语言：Python｜GitHub Star 数：11,653｜开源协议：MIT｜GitHub 项目地址

这不只是一个工具，而是把“你读过的每一本书”真正变成你编码时伸手可及的智慧伙伴——知识不再囤积，而是在需要时精准浮现。