← Back to Skills Marketplace
xyzach

book-digest

by bruce · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
106
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install book-digest
Description
深度阅读一本书:查书摘、拆章节、苏格拉底式提问检验理解、概念映射到实际应用。适用于非虚构/商业/技术类书籍。
README (SKILL.md)

Book Digest(深度阅读)

帮助用户快速读懂一本书。通过搜索、拆解、提问、对话四种方式,从被动阅读变成主动学习。

触发条件

用户提到以下任一场景时加载此技能:

  • "帮我读一本书" / "帮我理解XX这本书"
  • "检验我对XX的理解"
  • "拆解XX的核心观点"
  • "用苏格拉底方式问我关于XX的问题"
  • 用户提供了一段文本并希望深度分析

模式选择

加载技能后,先向用户确认书的信息和想要的模式:

模式 1:快速概览 (Quick Overview)

一次性给出:作者背景、核心论点、章节脉络、关键概念、这本书在领域中的位置、争议点。

模式 2:深度拆解 (Deep Dive)

按章节或主题逐步拆解:每轮聚焦一个章节/主题 → 提炼关键论证 → 问用户理解 → 继续下一部分。

模式 3:苏格拉底提问 (Socratic)

角色扮演:你读完了书(或提供了文本),我来提问检验你的理解。

  • 每次只问一个问题,等用户回答后再给下一个。不要一次抛多个问题。
  • 从浅到深:事实性问题 → 推理性问题 → 批判性问题 → 应用性问题
  • 不直接给答案,而是通过追问引导用户自己发现
  • 如果用户答不上来,给提示而不是直接揭晓
  • 降级策略(用户连续说「不知道」时):
    1. 第一次「不知道」→ 给一个方向性提示(不涉及答案本身)
    2. 第二次「不知道」→ 给更直接的提示,缩小范围
    3. 第三次「不知道」→ 直接给答案并简要解释,然后进入下一个问题。不要卡在同一个问题上反复追问。
  • 根据用户回答调整下一题难度。答得好 → 加难度;答不上 → 回撤到更基础的问题

模式 4:应用映射 (Application)

把书中的框架/概念映射到用户的实际场景:

  • 先确认用户的工作领域或当前面临的挑战
  • 逐个概念讨论"这对你意味着什么"
  • 帮用户制定行动计划

工作流程

第一步:确认书的信息

  • 书名、作者
  • 用户是否已经读过部分内容?读了多少?
  • 用户的目标是什么?(考试、兴趣、工作需要、写作参考等)
  • 偏好什么模式?如果不确定,默认用「快速概览」开个头

第二步:搜集信息

尝试通过 browser_navigate 或 execute_code(curl)搜索以下内容:

  • 书的官方摘要和目录
  • 作者背景和写作动机
  • 核心概念/框架名称
  • 主要批评或争议
  • 优质书评/读书笔记(豆瓣、Goodreads、博客等)

搜索策略:用多个并行搜索覆盖不同维度。中文书搜中文关键词,英文书搜英文。

"《书名》 核心观点 摘要"
"《书名》 目录 章节"
"书名 作者 书评 解读"
"book title key ideas summary"

Pitfall: web_search 不是 shell 命令,不能用 terminal 直接调用。使用 browser_navigate 访问搜索引擎或 execute_code 跑 curl。如果搜索受阻(CAPTCHA、连接失败等),不要死磕——对于知名度较高的书,直接使用自身知识库即可,不需要等搜索结果才继续。告知用户「基于已有知识直接开始」即可。

第三步:呈现 + 交互

根据选择模式进入对应流程。呈现时遵循以下原则:

  1. 不灌水 — 直接给干货,不要「这本书非常精彩,值得一读」之类的废话
  2. 标注来源 — 关键数据和引用标注来自哪里
  3. 追问 — 每个关键概念呈现后至少问一个确认理解的问题。但如果用户说「继续」「请继续」「下一步」,表示用户要加速,跳过追问直接推进内容
  4. 适应节奏 — 用户说「继续」→ 加速;用户追问细节 → 深挖。深度拆解模式中,如果用户连续两次「继续」,后续章节可以不再插入提问
  5. 中文优先 — 用户用中文交流,用中文回应。英文书名保留原名,概念首次出现括号附英文

示例对话

苏格拉底模式示例

用户:「我用苏格拉底模式,检验我对《思考,快与慢》的理解」

助手:

好,假设我是你的读书伙伴。先热身一下:

卡尼曼把人类的思维分成哪两个系统?用你自己的话描述它们各自的特点。

(等用户回答后,根据回答质量决定下一题难度。)

应用模式示例

用户:「我是产品经理,帮我用《创新者的窘境》的框架看看我现在的处境」

助手:

先确认一下:你现在所在的市场是 A) 成熟大厂,主营产品利润率很高 B) 创业公司,在找颠覆性切入点 C) 其他(说说看)

(确认后开始映射书中的延续性创新 vs 颠覆性创新框架)

收束规则

完成深度阅读(四种模式全部或部分走完)后,主动提议为这本书创建一个独立的决策参考技能。格式参见 thinking-fast-and-slow 技能:

  • 技能名用英文书名转换(如 thinking-fast-and-slow
  • 内容为概念清单 + 决策含义
  • 每个概念三要素:名称、一句话解释、对该者的决策启示
  • 存入 research/ 分类
  • 创建后提醒用户:以后做决策时可以加载此技能辅助判断

注意事项

  • 如果用户只给了书名但网上搜不到足够信息(过于冷门/新书/非英文),诚实地告诉用户并建议用户提供文本摘录或目录
  • 如果用户说读的是小说/文学作品,提醒用户此技能主要针对非虚构类,但可以调整(关注主题、人物弧线、叙事结构等)
  • 【关键】苏格拉底模式一次只问一个问题,不要一次抛多个问题
  • 【关键】如果用户回答"不知道",给最多 1-2 次提示,然后直接给答案。不要反复追问——用户偏好讲解式输入多于发现式学习
  • 【关键】不要用评价性语言评判用户的回答质量。只问不评。不要说"你概念掌握还行,但..."这类话
  • 在结构化内容(拆解章节)时,用户说"继续"就是直接推进,不要每段都问"要继续吗"
  • 苏格拉底模式中,如果用户问了一个和当前问题无关的澄清问题,简洁回答后立即回到原问题
  • 全模式串联时默认顺序为 1→2→3→4,模式 2 结束后自然询问是否进入模式 3
  • 用户随时可以说「跳过」「换模式」「我不确定」来调整节奏
Usage Guidance
This skill appears safe to install as an instruction-only reading assistant. Be aware that it may search the web for book information and may suggest saving a derived reference skill for future decisions; review any saved content and decline browsing or persistence if you do not want those behaviors.
Capability Analysis
Type: OpenClaw Skill Name: book-digest Version: 1.0.0 The 'book-digest' skill is a reading assistant designed to help users analyze non-fiction books through summaries, Socratic questioning, and application mapping. It utilizes standard agent capabilities like 'browser_navigate' and 'execute_code' (specifically for curl) to fetch book metadata and reviews from public sources like Douban or Goodreads. There are no indicators of malicious intent, data exfiltration, or unauthorized persistence; the instructions are clearly aligned with the stated educational purpose.
Capability Assessment
Purpose & Capability
The stated purpose is coherent: helping users understand nonfiction, business, and technical books through summaries, chapter breakdowns, questioning, and application mapping. It may use web browsing or curl-based search to gather public book information.
Instruction Scope
Instructions are mostly bounded to book analysis and user-paced interaction. The skill does tell the agent to try browser navigation or execute_code with curl for search, but this is disclosed and purpose-aligned.
Install Mechanism
No install spec, binaries, environment variables, credentials, or code files are present; the artifact is instruction-only.
Credentials
Optional web/search access is proportionate for finding summaries, tables of contents, author background, and reviews. No local file access, credential access, or privileged environment mutation is requested.
Persistence & Privilege
The skill suggests proposing creation of a separate future-use reference skill after the reading session. This is persistent agent state, but it is framed as a proposal rather than hidden automatic behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install book-digest
  3. After installation, invoke the skill by name or use /book-digest
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Book Digest 1.1.0 introduces flexible, interactive modes for deep reading and understanding of non-fiction, business, or technical books. - 新增多种阅读模式:快速概览、深度拆解、苏格拉底提问、应用映射,支持按需切换 - 支持用户通过对话,主动深挖、检验理解、将概念应用于实际工作场景 - 优化信息搜集方式,自动检索官方摘要、目录、作者背景和优质书评 - 增强用户节奏控制:随时可切换模式、加速推进或深挖细节 - 加强苏格拉底式提问流程,并新增降级与节奏调整规则 - 结束后主动建议为该书自动生成决策参考技能,方便日后复用
Metadata
Slug book-digest
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is book-digest?

深度阅读一本书:查书摘、拆章节、苏格拉底式提问检验理解、概念映射到实际应用。适用于非虚构/商业/技术类书籍。 It is an AI Agent Skill for Claude Code / OpenClaw, with 106 downloads so far.

How do I install book-digest?

Run "/install book-digest" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is book-digest free?

Yes, book-digest is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does book-digest support?

book-digest is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created book-digest?

It is built and maintained by bruce (@xyzach); the current version is v1.0.0.

💬 Comments