book-to-skill 的 4 种运行模式全解析从完整转换到折叠更新的实用指南【免费下载链接】book-to-skillTurn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.项目地址: https://gitcode.com/GitHub_Trending/bo/book-to-skillbook-to-skill是一款把技术书籍PDF、EPUB、DOCX 等转换成 AI 智能体技能Agent Skill的开源工具。它支持4 种运行模式完整转换、仅分析、从分析生成、折叠更新Update/Fold-in覆盖转换前预览、直接生成、基于已有笔记生成、持续更新旧技能的全部场景。本文用通俗语言带你逐个搞懂这 4 种模式——什么场景用哪种、如何触发、产出什么帮你把书真正变成随时可调用的知识库。先搞懂什么是 book-to-skill买过一本好书读完三个月后就忘了第 7 章讲什么把整本 PDF 丢给 AI它要么答不上来要么一本正经地胡编。book-to-skill 的思路是先把书提炼成一套结构化技能文件再让智能体按需加载。转换一次之后你只需输入类似/my-book replication的命令智能体就会读取对应章节并基于真实内容作答——不靠记忆更不靠猜。生成的技能目录通常包含这些文件详见 docs/usage.md文件作用加载方式SKILL.md核心心智模型 章节索引约 4,000 tokens常驻chapters/ch01-*.md每章一个摘要文件约 1,000 tokens/章按需加载glossary.md术语表按字母排序并标注章节按需加载patterns.md技术、算法、设计模式汇总按需加载cheatsheet.md决策表与速查规则按需加载 章节文件是用到才读的所以查一个问题只需花少量 tokens官方实测比把整本书塞进上下文节省 24~51 倍方法论见 docs/performance.md。它的核心设计哲学写在 SKILL.md 里提取结构而不是写摘要——抓取的是命名框架、原则、技术、反模式而不是一章一章的剧情复述。模式一览4 条路径各自负责什么SKILL.md 的 Modes of Operation 一节定义了 4 种模式智能体会根据你的指令自动路由模式触发方式执行步骤产出1️⃣ 完整转换默认只给文件路径无特殊说明步骤 0–9 全流程完整技能目录2️⃣ 仅分析说 analyze、just extract 等步骤 0–3 后停下分析报告3️⃣ 从分析生成提供已有分析笔记或报告跳过 0–3执行 4–9由分析直接生成的技能4️⃣ 折叠更新指向已存在的技能目录抽取新文件后走更新流程合并后的旧技能模式一完整转换Full Conversion——最常用的默认模式什么时候用你手里有一本或几本想沉淀下来的书希望一步到位生成技能。只要给路径、不加特殊说明就走这条路线。执行流程对应 SKILL.md 的步骤 0–9验证输入—— 检查路径是否包含受支持格式PDF、EPUB、DOCX、TXT、Markdown、HTML、RTF、MOBI 等支持单文件、文件夹、glob 通配或批量路径。识别内容类型—— 工具会先问你这是技术类有代码、表格、公式还是文本密集类技术类会用 Docling 做结构感知提取约 1.5 秒/页文本类走更快的 pdftotext 路线。成本预估—— 生成前先给出页数、词数、token 预算和时间估算你可以确认继续或改口analyze only切到仅分析模式。生成章节摘要 辅助文件 主 SKILL.md—— 每章按核心思想 → 框架 → 反模式 → 要点 → 关联章节的模板输出并生成术语表、模式清单和速查表。产出一个完整的技能目录写入你宿主智能体的技能路径如~/.claude/skills/slug/。之后用/技能名 章节号或/技能名 主题词就能按需查阅。# 单个文件 /book-to-skill ~/books/my-book.pdf my-book # 整个文件夹 自定义技能名 /book-to-skill ~/workspace/project-docs/ project-knowledge⏱ 实测一本 244 页的技术书全流程成本约 0.9 美元级别一次转换长期受用。模式二仅分析Analyze Only——转换前先验货什么时候用书很长、你不确定提炼质量或者想先看看这本书到底有哪些值得沉淀的框架。触发方式在指令里带上 analyze、just extract 或 I want to review before generating 这类词成本预估环节回答 analyze only 也会切换到此模式。它会做什么只执行步骤 0–3验证、识别类型、抽取、结构分析然后输出一份抽取报告就停手不生成任何技能文件。报告结构包括作者核心框架Authors Core Frameworks关键原则Key Principles技术与方法Techniques Methods反模式Anti-patterns建议的技能名检测到的章节列表这份报告既是预览也是模式三的原料——你看完满意后可以让智能体基于它直接进入生成阶段省去重复抽取整本书的开销。模式三从分析生成Generate from Prior Analysis——带着笔记开工什么时候用你已经有了一份分析材料——不管是模式二产出的报告还是自己之前整理的读书笔记——不想再让工具重新读一遍书。它会做什么跳过步骤 0–3不再抽取和分析直接把提供的分析作为输入从步骤 4 开始执行确认用途与深度study 还是 reference、定技能名、建目录、生成章节摘要和辅助文件。实际收益✅ 省 token大书的重复抽取是最贵的环节这一步直接绕开✅ 省时间适合上次预览过、今天想正式落地的场景✅ 灵活分析笔记可以是你自己的 Markdown只要结构清晰即可。 典型工作流第 1 天用模式二跑 analyze only 拿到报告 → 人工核对、删改 → 第 2 天用模式三基于报告生成完整技能。模式四折叠更新Update / Fold-in——让技能跟着你的书库一起长大什么时候用技能已经存在你新来了资料——新一版文档、几篇论文、补充章节——希望把它们合并进旧技能而不是推倒重建。触发方式满足其一即可新路径指向一个已存在的技能目录含SKILL.mdchapters/给出的技能名与技能目录中已有的 slug 一致或明确说出更新某个技能。它会做什么先对新文件执行验证、类型识别和抽取步骤 0–2然后进入专用的更新工作流见 SKILL.md 的 Update / Fold-in Workflow读取旧技能结构—— 解析现有章节索引、术语表和最高章节号区分修订与新增—— 若新内容扩展了已有章节则合并重写该章节文件若是全新主题则从最高章节号之后继续编号已有 ch12 就新建 ch13合并辅助文件—— 术语表去重后按字母重排、重复词条追加新章节引用如(Ch 4, Ch 13)模式清单和速查表同步整合重生成主 SKILL.md—— 更新章节数、日期、索引并保持全文在 4,000 tokens 预算内。# 把新论文折进已有技能 /book-to-skill ~/articles/new-paper.pdf ~/.claude/skills/project-knowledge这正是把内部文档、研究论文集合做成活知识库的关键新资料落袋即更新技能始终和你最新的认知同步。一张图看懂模式怎么选你的处境推荐模式第一次处理这本书想要完整技能模式一完整转换书很大/很贵想先看看提炼质量模式二仅分析已有分析报告或读书笔记模式三从分析生成技能已存在新资料要并入模式四折叠更新常见问题 FAQQ1支持哪些输入格式PDF、EPUB、DOCX、TXT、Markdown、reStructuredText、AsciiDoc、HTML、RTF、MOBI/AZW/AZW3。单个文件、整个文件夹、glob 模式、多路径列表都可以见 docs/usage.md。Q2转换是本地进行的吗我的书会被上传吗抽取与分析都在你机器上执行文件不会被工具上传。生成的是结构化笔记式的衍生内容不是原文复制第三方版权书籍的技能建议保持私有详见 README.md 的 Copyright 一节。Q3在哪些智能体上能用凡是支持开放 Agent Skills 标准的主机都可以GitHub Copilot CLI、Amp、Claude Code、Hermes Agent 等读的都是同一份SKILL.md格式。安装方式见 docs/install.md。Q4PDF 里没有文字层扫描件怎么办提取器会检查前几页发现是纯图片会立即停止并提示——先自行做 OCR如ocrmypdf再转换结果即可。写在最后book-to-skill 的 4 种模式其实是同一条流水线的 4 个开关完整转换负责一次成型仅分析负责先预览再决定从分析生成负责复用已有笔记省 token折叠更新负责让技能随新资料持续进化。配合 docs/how-it-works.md 的完整流程和 docs/architecture.md 的架构说明你可以把每一本反复查阅的技术书都变成智能体随身可查的第二大脑。下一步按 docs/install.md 安装然后对你的第一本书说一句 analyze only从模式二开始体验最稳妥。【免费下载链接】book-to-skillTurn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.项目地址: https://gitcode.com/GitHub_Trending/bo/book-to-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考