如何用 book-to-skill 的 Update/Fold-in 模式把新材料更新进已有 skill

如何用 book-to-skill 的 Update/Fold-in 模式把新材料更新进已有 skill【免费下载链接】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如果你已经用 book-to-skill 把一本书或一个文档文件夹转成了统一 skill并把它放在 agent 的 skills 目录里Claude Code、GitHub Copilot CLI、Amp、Hermes Agent 均可那么后续到达的新论文、新章节或新笔记不必重新跑一次完整转换。Update/Fold-inMode 4会把新材料合并进已有 skill保留原有目录结构和索引只重写受影响的章节文件与支持文件并重新生成主SKILL.md。准备条件转换器已作为 agent skill 安装/book-to-skill命令由此注册。一条命令适配所有宿主npx skills add virgiliojr94/book-to-skill也可以手动把仓库 clone 到对应 skills 目录Claude Code 用~/.claude/skills/book-to-skillCopilot CLI 用~/.copilot/skills/book-to-skillclone 后在 copilot 会话里运行/skills reload。注意pip安装的是独立的文本抽取 CLI不注册/book-to-skillagent skill不是本场景的入口见 docs/install.md。已存在一个先前完整转换生成的 skill目录里同时有SKILL.md和chapters/子文件夹例如~/.claude/skills/project-knowledge/。新材料属于支持的格式PDF、EPUB、DOCX、TXT、Markdown、reStructuredText、AsciiDoc、HTML、RTF、MOBI/AZW/AZW3。运行找不到任何受支持文件时会在 Step 1 停止并报错。可选的环境预检在转换器 clone 目录内执行python3 scripts/extract.py --check它按格式打印各抽取器是否已安装以及安装缺失项的准确命令不处理任何文件。触发 Update/Fold-in 流程进入 Mode 4 有两条路径SKILL.md 的 Modes of Operation 与 Step 0直接把已有 skill 目录作为参数传入docs/usage.md 中的原始示例# Update/fold new material into an existing skill folder /book-to-skill ~/articles/new-paper.pdf ~/.claude/skills/project-knowledge第二个参数是已有 skill 的目录路径不是一个新 skill 名。 2.末尾参数是SKILLS_HOME中已存在的 skill slug或明确表达更新已有 skill的意图。判定规则是固定的任一输入路径是已有 skill 目录含SKILL.md与chapters/子文件夹或SKILL_NAME匹配SKILLS_HOME中已存在的 slug本次运行即被标记为 Update/Fold-inMode 4。如果你没有指明已有 skill但选定的名字与已有 skill 冲突转换器也会停下来询问给出三个选项Update / Fold-in合并、Overwrite删除后重新生成、Rename追加-2或换一个新 slug。选择 Update / Fold-in 后流程在 Step 2.5 之后直接进入 fold-in 工作流跳过 Steps 3、4、6、7、8、9。触发后流程会先执行Step 1确认INPUT_PATHS中至少存在一个受支持的文件、目录或 globStep 1.5询问内容类型——technical有代码、表格、公式走 Docling约 1.5s/页或 text-heavy以散文为主走 pdftotext 等秒级完成结果存为BOOK_TYPEStep 2运行scripts/extract.py抽取新材料产出一个 per-run 工作目录默认tempdir/book_skill_work-pid/或BOOK_SKILL_WORKDIR指定的路径其中full_text.txt是合并后的全文metadata.json是汇总统计加逐来源列表Step 2.5读取本次的metadata.json先给出 token 与成本估算并等待你确认才继续生成输入 analyze only 则先出分析报告、不生成文件。合并阶段做了什么进入 Update / Fold-in Workflow 后agent 对已有 skill 目录$SKILLS_HOME/skill_name/依次做六步读取现有结构。解析现有SKILL.md的 Chapter Index、Topic Index、元数据作者、总章节数和 Core Frameworks列出chapters/找到最大章节号例如ch12读取glossary.md、patterns.md、cheatsheet.md了解哪些术语和框架已经被索引。区分修订与新增。分析本次full_text.txt判断每段新内容属于哪种情况Updates/Revisions to existing chapters直接更新或扩展现有章节主题的内容——读取该章节文件把新细节合并进去并重写该文件New additions引入全新章节、论文或独立部分——在chapters/下创建新文件编号接在已有最大章节号之后已有章节停在ch12就创建ch13-*.md、ch14-*.md。写章节文件。每个新增或修订章节沿用 Step 7 的模板结构Core Idea → Frameworks Introduced → Key Concepts → Mental Models → Anti-patterns → Key Takeaways → Connects Totechnical 来源优先保留 Code Examples 与 Reference Tables。合并支持文件。glossary.md新旧术语合并后按字母排序术语已存在时在其行上追加新的章节引用文档示例**Term** — definition (Ch 4, Ch 13)patterns.md按一致格式追加新模式总长度控制在 2,500 tokens 以内cheatsheet.md把新抽出的决策规则、对比表、参数指引整合进现有结构。重新生成主SKILL.md。章节数加一、更新页数估计与来源列表、Generated日期改为当前日期把新内容中影响最大的心智模型折进 Core Frameworks整个文件保持在 4,000 tokens 以内Chapter Index 追加新章节行并链接到新文件Topic Index 按字母序合并已有主题若也被新章节覆盖则在该行追加章节链接文档示例- **Topic** → ch05, ch13。扫描、清理、报告。执行 Step 9.5 的扫描然后进入 Step 10 做清理并打印更新报告。验证更新结果确认抽取的是你要的文档。在生成任何文件之前检查metadata.json里的filename/source_file或full_text.txt首行的SOURCE:头。工作目录每次运行都不同路径要取自本次运行的输出Workdir -、Text -、Meta -不要假设固定位置——轮询共享路径可能读到另一次运行的输出。安全扫描闸门。agent 会对更新后的 skill 目录运行建议性扫描文档中的原始写法是$PYTHON_BIN $SKILL_CONVERTER_ROOT/tools/scan_generated_skill.py $SKILLS_HOME/skill_name其中$SKILL_CONVERTER_ROOT是转换器根目录skill_name是你的 skill slug。扫描以非零退出时停止并交由人工审查其 file/line 级发现在发现被解决或明确接受之前不加载、不发布该 skill。更新报告与清理。Step 10 只删除本次运行实际使用的工作目录取自输出或metadata.json的workdir字段随后打印一份更新报告列明新增章节、合并的术语和更新后的索引。按用途验证。像平时一样查询更新后的 skill/project-knowledge replication查主题/project-knowledge ch13直接打开新编号的章节。GitHub Copilot CLI 中文件写完后可能需要/skills reload才能看到变化Claude Code 与 Amp 在下次会话自动拾取。已发布远端的后续推送可选如果该 skill 曾通过 Step 11 发布到 GitHubskill 目录就是这个远端的 git 工作副本fold-in 完成后转换器会提议把更新 commit 并 push 到同一远端。例外情况若 skill 目录位于另一个 git 仓库之内当初是从 scratch 副本发布的本地目录没有自己的远端——此时应重跑 Step 11或 clone 已发布的仓库、把新材料 fold 进 clone而不是对本地目录推送。边界与限制Update/Fold-in 只做合并不删除已有内容。Overwrite删除重建与 Rename 是独立选项不属于本流程。两条硬性 token 预算在 fold-in 中同样适用主SKILL.md整体不超过 4,000 tokenspatterns.md不超过 2,500 tokens。扫描 PDF纯页面图片、无文本层会在开头检查处立刻停止并给出说明先用ocrmypdf input.pdf output.pdf之类工具做 OCR再 fold 结果见 docs/faq.md。由第三方版权书籍生成的 skill 必须保持私有只有来源是你自己的写作、开放许可材料或你明确确认有权公开再分发时才考虑公开。【免费下载链接】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），仅供参考