信息卡

一句话定位

它是一个转换器兼 Agent 技能：把任意技术书籍、文档文件夹或源码集按照开放的 Agent Skills 标准（SKILL.md 格式）蒸馏成结构化"笔记型技能"，供 Claude Code、Copilot CLI、Amp 按需加载，官方宣称比把全书塞入上下文节省 24–51 倍 token。

趋势解读：为什么火

Agent Skills（SKILL.md）生态正在成为连接人与模型的通用接口层，而上下文成本是所有重度使用者的共同痛点。book-to-skill 把"反复查 PDF、凭记忆胡编"这两个高频抱怨一并解决：一次转换，永久按需调用。它同时踩中了技能生态、token 经济学和企业内部知识资产化三条上升曲线，因此能在 8 月出现接近翻倍式增长。

核心功能拆解

• 三步工作流：指定文件、文件夹或 glob，自动提炼框架、决策规则与反模式，并按章节生成独立文件。
• 标准产物结构：SKILL.md 约 4000 token，每章文件约 1000 token，另附 glossary.md、patterns.md、cheatsheet.md；章节文件在被请求前不计入预算。
• 广格式支持：PDF、EPUB、DOCX、MD、HTML、RTF、MOBI/AZW3 及纯文本、reST、AsciiDoc 均可原生解析。
• 不止于书：内部文档、品牌与设计系统、论文簇、RFC 与规格说明同样适用，凡需反复查阅皆可转换。
• 增量折叠更新：新材料可合并进既有技能，还能发布到 GitHub（默认私有）供多个宿主一键安装。
• 隐私立场明确：全程本地处理、不上传原文，输出是综合笔记而非逐字摘录，README 称其性质类似手写学习笔记。

架构与技术栈浅析

核心是 Python 编写的提取器，解析逻辑模块化置于 scripts/extractor/parsers/ 下。PDF 提供多级工具选择：通用文本走 pdftotext（poppler）、pypdf 或 pdfminer.six，含代码、表格与公式的技术书优先使用 docling（约每页 1.5 秒）以保留 markdown 表格与代码块。EPUB 采用 ebooklib 加 beautifulsoup4 并以标准库 zipfile 兜底；MOBI/AZW3 依赖 Calibre 外部的 ebook-convert。配套 pytest 测试、tools/discovery_tax.py 做 token 成本基准、tools/validate_skill.py 按 claude/copilot/amp 三种镜头校验产物合规性。

安装与环境要求

推荐一条命令安装：`npx skills add virgiliojr94/book-to-skill`。也可手动克隆到 `~/.claude/skills/book-to-skill`（Copilot CLI 目标目录为 `~/.copilot/skills/`，Amp 为 `~/.agents/skills/`）。先用 `python3 scripts/extract.py --check` 检查依赖；扫描版 PDF 需先执行 OCR，例如 `ocrmypdf input.pdf output.pdf`。

快速上手示例

装好后在 Claude Code 内输入：

/book-to-skill ./my-book.pdf

或写成 `/book-to-skill [skill-name]`。转换完成后即可针对性提问，例如 `/my-book replication`，回答会定位并引用对应章节文件，而不是通读全书。

进阶使用要点

• 转换前技能会询问书籍偏技术还是偏文字叙述，据此自动选择 docling 或轻量文本引擎，兼顾质量与速度。
• 面对扫描版 PDF，提取器会先探测前几页是否有文本层，若无则尽早中止而非产出空壳技能。
• 用 discovery_tax.py 实测你那本书的问答 token 成本，判断收益是否值得。
• validate_skill.py 的 --lens 参数保证同一技能在 Copilot、Amp 上也能过审。
• 将生成的技能推送为私有仓库，可在不同机器用 npx skills add 复现整套知识库。

典型应用场景

• 把 O'Reilly 类厚书转成 Claude Code 技能，写代码时随问随答、答案带章节出处。
• 团队将内部架构手册蒸溜成共享技能并私有发布，新成员的 Agent 即装即用。
• 论文集批量生成 glossary 与 patterns 笔记，辅助文献综述。
• RFC 或 API 规范转成 cheatsheet，接口评审时直接检索决策规则。

同类生态位对比

相比向量数据库加 chunking 的传统 RAG，它无需 embedding 流水线，产出的是人类可直接阅读维护的 Markdown 笔记，检索发生在文件名与目录层面。相比把全文塞进上下文的做法，节省 24 至 51 倍 token。它与 archify、strix 等一起构成 SKILL.md 技能生态的应用样本，分工上专攻"长文档知识封装"这一格。

资源导航

仓库主页见 github.com/virgiliojr94/book-to-skill；许可证 MIT，仅覆盖转换器代码与技能定义，不含被处理文档；OCR 前置工具参考 ocrmypdf 项目，高质量解析参考 docling 项目；技能校验细节见 tools/validate_skill.py，社区贡献的扫描版处理见 PR #130。