Valhalla 静态工程审阅 book-to-skill 超级省钱实用·源码证据驱动评测【Agent Skill 特辑 #001】硬核工业风技术文章建议搭配封面图阅读。本文基于固定 Commit 快照开展只读静态工程审阅不代表动态安全结论所有观测均以可复查源码证据为边界。 本文档声明性质本文系基于固定代码快照442aaaa的静态工程特征分析属于开源组件尽职调查参考材料不构成任何形式的安全漏洞最终判定或法律合规意见。证据锚定所有结论均以文内引用的源码文件路径为唯一证据边界未经验证的动态运行数据不纳入本文分析范畴。使用建议若将 book-to-skill 纳入生产或核心业务系统建议结合内部 SAST/DAST 扫描及实际部署测试形成完整的评估报告。摘要技术书买了读完了三个月后连第 7 章的存在都忘了——这是每个技术人的真实困境。传统的解法各有各的痛搜 PDF 返回一堆页码而不是答案问 AI 要么幻觉要么说没读过边读边记笔记最后得到一份 200 行的文档再也没打开过。book-to-skill给出了一个完全不同的答案把书“编译”成 Agent Skill让 Agent 在需要时按章节按需加载——而不是把整本书塞进上下文。它的效果很直接24 倍到 51 倍的 Token 节省实测 103 页技术书转换成本约$1单本书 Skill 的核心骨架约4,000 tokens每章按需加载约1,000 tokens。本文从 Valhalla 静态工程审阅视角拆解 book-to-skill 的架构底层与工程特征。1. 评测基础信息字段内容评测类型证据驱动只读静态审阅目标项目virgiliojr94/book-to-skill项目性质技术书籍 → Agent Skill 转换工具分析快照442aaaa2d21dbe5ae0f7c6a396585ef3a9d2534e分析范围仓库文件、模块结构、风险标签排除范围动态执行、渗透测试、性能压测、商业生态判断、法律合规意见2. 项目全景把技术书“编译”成 Agent 的随身外挂2.1 一句话定位把任意技术书 PDF、文档文件夹或资料合集变成一个统一的 Agent Skill——让你在 Claude Code、GitHub Copilot CLI、Amp 里一边干活一边查阅。2.2 核心洞察RAG 是检索Skill 是推理book-to-skill 的作者在 FAQ 里做了一个极其关键的区分维度RAGbook-to-skill工作时机查询时Query Time编译时Compile Time输入把书切成块 → Embed → 找相似向量一次深度分析提取作者的框架、命名、决策规则输出“这里有和你查询相近的段落”“这里有作者构建的 12 个框架准备好用于推理”适用场景宽而浅几十本书找提到 X 的部分窄而深一本书或紧密相关的资料集群工作中反复应用RAG 是检索Skill 是推理。RAG 索引一个书架book-to-skill 精通一本书的脊梁。2.3 技术书读完就忘是这本书最大的“未完成价值”技术书的价值不在于“读过”而在于“能用上”。但现实是痛点传统解法的问题“让我搜一下 PDF”返回页码列表不是答案“我问问 AI 关于这本书”要么幻觉要么说没读过“我边读边记笔记”200 行文档再也没打开过“把整本书塞进上下文”每轮对话都烧 Token400 页 ≈ 200K tokensbook-to-skill 把“读过的书”从负担变成了资产——Agent 按需加载章节只问当下需要的部分。3. 资产微观面板指标观测值工程解读受支持源文件29全部 Python轻量级代码基主导语言Python29 个文件纯 Python易扩展一级模块根4book_to_skill/、scripts/、tests/、tools/构建/依赖文件pyproject.toml标准 Python 打包入口证据book_to_skill/__main__.py可执行模块版本v1.3.0活跃迭代中许可证MIT商业友好静态风险命中4 条全部为RISK-SHELL-INVOCATION4. 核心机制三步把书变成 Skill4.1 整体流程技术书纯文本用户输入: PDF/EPUB/DOCX/文件夹Step 1: 提取文本Step 1.5: 识别书籍类型Docling 解析表格代码块→Markdownpdftotext/pypdf/pdfminerStep 2: 合并文本/tmp/book_skill_work/Step 3: Claude 分析结构标题/作者/章节/目录Step 4: 生成 Skill 文件输出到 ~/.claude/skills/slug/4.2 生成的 Skill 文件结构运行/book-to-skill your-book.pdf后会在 Agent 的 Skills 目录下生成一套结构化文件文件用途大小SKILL.md核心心智模型 章节索引~4,000 tokenschapters/ch01-*.md每章独立文件按需加载~1,000 tokens eachglossary.md术语表按字母排序 章节引用~1,500 tokenspatterns.md所有技术、算法、设计模式~2,000 tokenscheatsheet.md决策表 速查规则~1,000 tokens章节文件是按需加载的——在你问到那个主题之前它们不消耗 Skill 预算。4.3 不止是书文档文件夹、资料合集都行“book”在名字里但输入可以是任何结构化文本输入类型示例内部文档架构决策记录、Runbook、Onboarding 指南品牌与设计系统品牌手册、语气指南、组件原则研究资料集群论文堆 个人笔记合并成一个 Skill规范与标准RFC、API 契约、合规文档把整个docs/文件夹变成一个 Skill一边写代码一边问。5. 性能与成本5.1 Token 节省24×–51×book-to-skill 最核心的价值主张是 Token 效率方法Token 消耗相对 book-to-skill把整本书塞进上下文200K400 页书51×每次重新搜索 PDF每次都是全量持续烧钱book-to-skill按需加载~5K核心骨架 1 章基准大上下文窗口让“把整本书塞进去”可行但并没有让它便宜。Skill 加载的是 KB 级别不是 MB 级别。5.2 实际转换成本实测数据在 Claude Sonnet 4.5 上$3/$15 per MTok书籍页数Token章节估算成本Think Python 2244119K19$0.88Working Backwards371175K10$0.96Pro Git501229K—$1.23Moby-DickEPUB—301K—$1.42一本技术书的完整 Skill 转换成本约为 $1——远低于每轮对话都把整本书塞进上下文的累计成本。5.3 解析速度103 页技术书实测方法耗时表格代码块pdftotext0.1s00Docling技术书专用164s4836技术书用 Docling 虽然慢但能正确提取表格和代码块——这是技术书 Skill 质量的关键。6. 静态风险标签风险标签命中文件定级RISK-SHELL-INVOCATIONbook_to_skill/dependencies.py需人工复核RISK-SHELL-INVOCATIONbook_to_skill/parsers/calibre.py需人工复核RISK-SHELL-INVOCATIONbook_to_skill/parsers/pdf.py需人工复核RISK-SHELL-INVOCATIONtests/test_repo_hygiene.py测试代码可降低优先级解读四条 Shell 调用命中分布在三个核心区域区域文件性质依赖检查dependencies.py运行时检查外部依赖如 Calibre、pdftotext是否可用Calibre 解析parsers/calibre.py调用 Calibre 转换 MOBI/AZW 格式PDF 解析parsers/pdf.py调用 pdftotext 或 Docling 提取 PDF 文本测试tests/test_repo_hygiene.py测试辅助脚本非生产路径book_to_skill/parsers/pdf.py作为 PDF 解析的核心入口其中的 Shell 调用需重点确认是否涉及用户可控的输入如文件路径是否经过充分校验建议在使用前进行人工复核。7. 适用场景与生态位置7.1 适用场景场景推荐度说明技术书深度学习★★★★★把读过的书变成 Agent 可随时查阅的“外挂大脑”内部文档 Skills 化★★★★★把团队 Wiki、ADRs、Runbooks 变成可查询的 Skill研究资料集群管理★★★★☆把论文堆 笔记合并成一个 Skill编码时即时参考★★★★★在 Claude Code / Copilot CLI 中直接/book-to-skill查询7.2 与同类工具的生态关系book-to-skill 遵循开放Agent Skills 标准与 RAG 工具是互补关系而非竞争关系工具定位适用场景RAG 工具如 CandleKeep宽而浅几十本书找“提到 X 的部分”book-to-skill窄而深一本书或紧密资料集群工作中反复应用8. 对话式总结问book-to-skill 是什么答把技术书 PDF、文档文件夹或资料合集“编译”成 Agent Skill 的工具。遵循开放 Agent Skills 标准支持 Claude Code、GitHub Copilot CLI、Amp。问它和“把书塞进上下文”有什么不同答塞书是每轮对话都烧 Token400 页 ≈ 200K tokensSkill 是按需加载~5K tokens。实测24 倍到 51 倍的 Token 节省。问一本书的转换成本是多少答实测约$1每本书。244 页的 Think Python 2 转换成本 $0.88。问和 RAG 有什么区别答RAG 是查询时检索“找到提到 X 的段落”book-to-skill 是编译时提取结构“这里有一组作者构建的框架准备好用于推理”。两者是互补关系不是替代关系。9. 后续验证建议优先级验证动作目的P1审查book_to_skill/parsers/pdf.py中的 Shell 调用参数校验排除路径注入风险P1在隔离环境中执行/book-to-skill转换测试验证实际转换效果P2测试不同格式PDF/EPUB/DOCX的解析质量确认格式覆盖完整性P2评估 Calibre 依赖在目标环境中的可用性确认 MOBI/AZW 格式支持 本文档声明性质本文系基于固定代码快照442aaaa的静态工程特征分析属于开源组件尽职调查参考材料不构成任何形式的安全漏洞最终判定或法律合规意见。证据锚定所有结论均以文内引用的源码文件路径为唯一证据边界未经验证的动态运行数据不纳入本文分析范畴。使用建议若将 book-to-skill 纳入生产或核心业务系统建议结合内部 SAST/DAST 扫描及实际部署测试形成完整的评估报告。本文不是 Agent Skill 质量评测或转换效果对比而是一次基于固定 Commit 快照的开源组件静态工程尽职画像。更新日志版本号发布日期修订内容v2.02026-08-10发布完成项目核心架构评测、安全风险审计与场景落地建议本文由 Valhalla Matrix V2 评测体系出品仅作技术研究与风险提示不构成任何部署建议。