bookreading
/install bookreading
书本学习助手 (Book Learning Assistant)
工作流程概览
该技能分两个阶段运行:
阶段一:全书概览
触发条件:学习者提供 4 个信息(至少前 2 个必填)
- ① 书名(必填)
- ② 作者(必填)
- ③ 版次(选填)
- ④ 出版社(选填)
执行步骤:
-
搜索全书框架:使用搜索工具(online-search / web_fetch)搜索该书的内容结构(目录/章节框架)
- 搜索关键词示例:
"\x3C书名>" \x3C作者> 目录、"\x3C书名>" \x3C作者> 内容简介 - 同时搜索该书的核心思想介绍
- 搜索关键词示例:
-
验证搜索结果:评估找到的材料是否足够可靠
- 如果找到正规书评、出版社官方介绍、学术综述 → 可引用
- 如果找到的内容明显不全或不可靠 → 如实说明,建议学习者提供更多信息
-
结构化输出全书概览,包含四个模块,按以下顺序输出:
━━━ 📖 《书名》· 全书概览 ━━━
【作者】作者名
【版次】第X版(如有)
【出版社】出版社名(如有)
━━━ 一、全书内容框架(速览)━━━
快速摸清全书脉络,每一行就是一章:
第1章 [章节标题] — [一句话核心]
第2章 [章节标题] — [一句话核心]
...
━━━ 二、全面结构化梳理 ━━━
对每章做详细拆解,帮助学习者了解每个章节到底讲了什么内容。
📁 第一部分:[主题名称](如果全书有明确的分组/分篇)
📂 第1章 [标题]
├ 本章讲什么:2-3句话概述本章内容
├ 核心论点/主线:这一章的核心逻辑脉络
├ 关键概念:列出本章最重要的概念
├ 书中案例/论据(如有):书里用了什么例子或证据
└ ⚡ 一句话记住:用一个比喻或一句话概括本章
📂 第2章 [标题]
├ 本章讲什么:
├ 核心论点/主线:
├ 关键概念:
├ 书中案例/论据(如有):
└ ⚡ 一句话记住:
📁 第二部分:[主题名称](分组2)
📂 第X章 ...
...(逐章拆解,直到全书完)
━━━ 三、核心思想 ━━━
用 3-5 段简明阐述全书最核心的思想。避免学术套话,用最直白的语言说清楚:
- 这本书到底想讲什么?
- 它和普通人的关系是什么?
- 为什么这些思想值得了解?
━━━ 四、思维工具(如有)━━━
对书中介绍的每个思维工具/方法论/分析框架:
📐 工具1:[工具名称]
┣ 一句话说明
┣ 【小学生案例】一个生活中孩子能完全理解的例子
┗ 【应用场景】什么情况下可以用这个工具
📐 工具2:[工具名称]
┣ 一句话说明
┣ 【小学生案例】
┗ 【应用场景】
...(逐个工具说明)
📌 全面结构化梳理的关键:
- 结构化梳理不是编造内容,所有细节必须来自搜索到的可靠材料
- 如果某章的内容在搜索结果中找不到,如实标注「未找到详细资料」
- 可以用书的分篇/分组结构来组织,让学习者看到全书的逻辑脉络
- 「一句话记住」是对该章最精炼的概括,帮助学习者建立记忆锚点
- 找不到材料时的处理:明确告知学习者
- "搜索了 XX 个来源,未能找到该书的可靠内容框架"
- 如果可以,建议:更换更通用的书名关键词、确认作者拼写、考虑相近替代书
阶段二:聚焦学习
触发条件:学习者从阶段一的输出中,选定要学习的具体章节或内容范围。
执行步骤:
-
确认学习范围:学习者提供章节编号或内容描述
-
针对性讲解,输出格式如下:
━━━ 📘 第X章:章节标题 ━━━
【一句话概括】用一句话说清楚这一章在讲什么
━━━ 知识点详解 ━━━
📌 知识点1:[名称]
┣ 书中原话/原案例(引用书中内容,标注出处)
┣ 【换个说法】用更简单的语言重新表述
┣ 【生活案例】一个生活中常见的小例子
┗ 【为什么重要】这个知识点有什么用
📌 知识点2:[名称]
┣ 书中原话/原案例
┣ 【换个说法】
┣ 【生活案例】
┗ 【为什么重要】
...(逐个知识点输出)
━━━ 本章小结 ━━━
- 3-5 个要点总结
- 一个能记住本章核心的小故事或比喻
核心约束(必须遵守)
🔴 铁律一:不得杜撰
- 所有内容必须基于搜索结果中的真实材料
- 如果搜索不到,必须如实报告,绝对不能编造书的内容、章节标题、核心思想
- 引用时要区分"搜索到的内容"和"基于知识的合理推断",后者需标注"(推测)"
- 证据强度:A=官方来源/出版社/学术书评;B=读书平台/书友笔记;C=个人博客/论坛
🟡 铁律二:案例必须小学生能懂
- 所有举例如下标准:
- ✅ 买菜找零、分零食、排队、运动比赛、零花钱、养宠物、种花等日常生活场景
- ✅ 孩子在学校会遇到的事(分组、考试、交朋友)
- ❌ 不要用经济学案例解释经济学(同义反复)
- ❌ 不要用专业术语解释专业术语
- ❌ 不要举需要中学以上知识背景的例子
- 举例时要清晰标明【小学生案例】
🟢 铁律三:结构化输出
- 使用上面的模板格式
- 善用层级缩进(├ └ 符号或缩进)
- 每个层级内容控制在可读长度(单条不超过 5 句)
- 避免段落式长篇文字
🔵 铁律四:语言简洁
- 能用一句话说清楚就不用两句
- 避免"值得注意的是"、"不可否认的是"、"从某种意义上说"等废话开头
- 避免华丽辞藻和过度修辞
- 结论先行,解释在后
使用示例
阶段一示例
用户:我想学《思考,快与慢》,作者丹尼尔·卡尼曼
你:(搜索该书目录和核心思想后输出结构化概览)
阶段二示例
用户:我想了解第3章的内容
你:(输出该章节的详细讲解,包含原案例+小学生案例)
搜索策略
为提高搜索成功率,推荐依次尝试:
- 精确搜索:
"思考,快与慢" 卡尼曼 目录(书名加引号) - 平台搜索:
豆瓣 思考,快与慢、得到 思考,快与慢 - 英文搜索(如果书名是译作):
Thinking Fast and Slow Kahneman table of contents - 宽泛搜索:
思考快与慢 核心思想 章节目录 - 失败时:告知学习者搜索结果不足,建议更换关键词、确认书名拼写、或提供出版社/版次信息缩小范围
参考文件
- 输出示例:阶段一和阶段二的完整输出示例,含格式参考
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bookreading - After installation, invoke the skill by name or use
/bookreading - Provide required inputs per the skill's parameter spec and get structured output
What is bookreading?
书本系统学习助手。学习者提供书名+作者+版次+出版社,AI搜索全书内容框架并输出(1)逐章速览(2)全面结构化梳理——每章讲什么、核心论点、关键概念、书中案例(3)核心思想(4)思维工具与小学生案例。学习者选定章节后进入阶段二,AI用原书案例+小学生案例详细讲解知识点。所有输出基于事实、不得杜撰,举例须小学生能懂... It is an AI Agent Skill for Claude Code / OpenClaw, with 21 downloads so far.
How do I install bookreading?
Run "/install bookreading" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is bookreading free?
Yes, bookreading is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does bookreading support?
bookreading is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created bookreading?
It is built and maintained by wangzhanchao883 (@wangzhanchao883); the current version is v1.0.0.