关于 distill-book
用于提炼书籍及其他长文档内容的工作流技能。它将章节交给多个子 Agent 并行处理,避免协调者把全文载入上下文。
主要功能
- 01按章节拆分文档
- 02并行提炼章节内容
- 03按目标综合要点
- 04兼容多种文档格式
- 05清理中间文件
适用场景
- 01将长篇书籍提炼为可复用指南
- 02把手册或报告整理成结构化概览
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ maragudk/ fabrik --skill distill-book安装后在 Claude Code 中输入/distill-book确认已加载。
详细介绍
提炼一本书
核心理念
一本书太长,无法全部载入一个上下文窗口并进行有效推理。因此,要把任务分发出去:将书拆分成各章,分别交给各自的子 Agent 独立提炼,然后读取简短的概要(而不是原始章节),再综合整理。
关键在于保持上下文整洁:每个子 Agent 只载入一章,编排器从不读取完整章节,因此这种方法可以扩展到任意篇幅的书。如果你发现自己把原始章节文本载入了自己的上下文,就失去了这种方法的优势——把它委派出去。
这项技能刻意保持高层级且不依赖具体格式。书籍可能是 PDF、EPUB、Markdown、HTML、纯文本或其他格式;请使用适合该格式的工具和方法。重要的是下面的工作流,而不是具体操作细节。
何时使用这项技能
当有人希望从一份太长、无法一次读完的文档(书籍、手册、报告)中提取核心要点时,请使用这项技能;尤其是他们希望将结果整理成技能或结构化概要时。对于能够放进上下文的短文档,直接阅读即可;这套流程过于繁琐。
工作流
-
检查源文件是否可用,并在费力处理前指出问题。 确认无论文档是什么格式,都能从中提取真实、可用的文本。有些格式需要先处理一步——扫描版 PDF 需要 OCR,HTML 可能需要去除标记——而 Markdown 或纯文本则可以直接使用。根据格式选择合适的工具(例如,PDF 可使用
pdf技能)。如果源文件无法提取可用文本,请一开始就说明,而不是等漫长处理之后才说。 -
拆分成章节(或自然段落)。 阅读书籍本身的结构——目录、标题——以确定边界。不同书籍的惯例差异很大,因此需要自行判断,而不是遵循固定规则;在消耗 Token 处理之前,先确认拆分合理。如果没有明确章节,则改按部分、节或合适的篇幅分块,并说明你的处理方式。通常可跳过前言、索引、附录等前后附加内容,除非它们值得提炼。
-
并行提炼各章。 每章启动一个子 Agent,并指定
model: "opus"——逐章提炼不需要最昂贵的模型;真正需要判断力的是综合整理步骤。一次批量启动所有子 Agent,使其并发运行。每个子 Agent 的提示词都必须完整自洽,并应包含:- 要阅读的章节,以及用于提供背景信息的书名和章节标题;
- 与最终目标匹配的关注角度——这一点比其他任何事项都重要。对于编码技能,应要求提取工程师能够实际应用的原则和实践(定义、原因、具体技巧、反模式、经验法则),而不是平铺直叙的摘要。对于读书报告,则应要求提取叙事性要点。关注角度会影响后续所有内容。
- 要求将概要写入文件,并且只回复一个简短标记(例如“done ch5”)。写入文件可以让概要在你决定读取之前,不进入编排器的上下文。
- 目标篇幅,以及“不要凑字数”的提醒。
-
综合整理。 读取各概要(内容都很短,但合在一起可能很长——可以分批阅读,或在书籍篇幅很大时使用综合整理子 Agent)。然后产出交付内容:按主题而非章节顺序组织的提炼文档;或者,如果目标是可复用的指导内容,则将任务交给
skill-creator技能来创建技能。用自己的话提炼;通常无需引用原书内容。 -
清理任何中间工作文件,除非用户希望保留。
请牢记
- 子 Agent 彼此独立,没有共享记忆——每条提示词都必须独立完整。
- 尊重版权:此流程用于将用户合法获取的书籍提炼成自己的笔记或工具,而不是大篇幅复制书籍内容。