virgiliojr94/book-to-skill
一句话理解
转换时先整理文档结构,提取概念、决策规则和容易踩的坑,再把内容按章节分开保存。提问时,助手从入口文件的索引找章节,按需读取对应内容。这样,同一份材料的整理工作集中在转换阶段,后续问题各自只需查阅相关内容。
它解决什么问题
读过的技术手册,隔一段时间再用,常常只记得有一条规则,却想不起在哪一章。PDF 搜索能找到关键词出现的页面,具体该怎么选、有什么例外,仍得自己翻读。book-to-skill 接收技术书、文档文件夹或一组文件,把它们做成供智能助手查阅的技能。试用时可以用两个标准判断是否达到目的。先确认助手找得到生成的技能,再用一个手头的问题确认它能定位相关章节,给出与原文一致的规则和适用条件。
从输入到输出
第一步,选定文件或文件夹。输入决定生成的技能能依据哪些资料。第二步,提取器按文件格式尝试可用工具,整理出文本和元数据。某种格式没有可用的提取工具时,提取器会提示缺少什么,后续也就拿不到该文档的文本。第三步,助手依照仓库的生成说明组织材料,产出带章节索引的 SKILL.md、分章文件,以及术语表、模式汇总和速查表。第四步,把产物放到当前助手能发现的技能位置。不同宿主的查找位置有差异,文件生成成功后仍需确认它能被发现。第五步,提出具体问题,助手借助索引找到相关章节,再读取其中的规则来作答。
用一个小任务理解
理解示例(未实测):设想用团队自己写的一份两章 CSV 导出手册试用。第一页到末页的文字都可以选中。第一章规定月报只统计已完成订单,第二章介绍文件命名。把整份 PDF 交给转换器,预期得到一个带两章索引的技能入口,以及对应的分章文件。随后在识别到该技能的助手里问“待付款订单要放进月报吗?”预期它查阅第一章,回答“月报只统计已完成订单,因此待付款订单不计入”。把这句话与手册核对,再看生成的第一章有没有保留“已完成”这个限定。
改变一个条件会怎样
预测与验证(待检验):只改变一个条件,把同一本手册换成页面外观相同、但没有文字层的纯图片 PDF,保持宿主和转换环境一致。按文档描述,预期提取器会在检查前几页时停止,提示先做文字识别,因此这次转换不会产出可用于回答月报问题的章节文件。验证时分别转换两份 PDF,将产物分开放,查看两次的提取提示和新生成的文件,避免把第一次的产物算到第二次。
适合谁,哪里会失效
根据资料推断:经常回查技术书、团队手册或规范,并且已经在用支持技能的助手的人,可以优先尝试。只查一次的问题,直接翻原文可能更省事。现有资料缺少生成内容准确率和遗漏率的独立验证。遇到例外条款、表格或代码示例,仍应回查原文。仓库说明提取和分析在本机运行,通过云端模型发送的文本则按该提供商的数据条款处理。处理内部资料前可据此确认使用范围,第三方书籍生成的技能宜按原资料条款保留在私人范围内。
第一次尝试时看什么
根据资料推断:第一次试用可以选一份短小、有明确章节的 Markdown 文档,这种格式无需额外的提取工具。提前从原文挑一道带例外条件的问题,写下期望答案。生成后先检查技能入口和章节文件,再在助手里提问。如果回答漏掉例外,先看生成的章节是否保留了那条规则,再检查助手是否找到了正确章节。
发表回复