← Back to Skills Marketplace
ludiansheng

电子书阅读助理

by ludiansheng · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
131
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ebook-reader
Description
智能电子书阅读助手,支持EPUB/PDF等常见格式解析;提供章节总结、关键内容摘录、深度分析与落地应用建议;当用户需要阅读电子书、做读书笔记或寻求知识转化方案时使用
README (SKILL.md)

电子书智能阅读器

任务目标

  • 本 Skill 用于:系统化阅读和分析电子图书
  • 能力包含:电子书解析、章节总结、关键摘录、深度分析、落地应用建议、全书综合分析、延伸阅读推荐
  • 触发条件:用户上传电子书文件并请求阅读、总结或分析

前置准备

  • 依赖说明:scripts脚本所需的依赖包及版本
    ebooklib==0.18
    pypdf==3.17.0
    beautifulsoup4==4.12.0
    

操作步骤

1. 电子书解析

调用脚本:执行 scripts/ebook_parser.py 解析电子书文件

python /workspace/projects/ebook-reader/scripts/ebook_parser.py \
  --input \x3C电子书文件路径> \
  --output \x3C输出JSON路径>

参数说明

  • --input:电子书文件路径(支持 .epub、.pdf 格式)
  • --output:输出 JSON 文件路径(可选,默认输出到标准输出)
  • --chapter:指定章节编号(可选,不指定则解析全部章节)

输出格式

{
  "book_title": "书名",
  "author": "作者",
  "total_chapters": 10,
  "chapters": [
    {
      "number": 1,
      "title": "章节标题",
      "content": "章节内容文本"
    }
  ]
}

2. 读书笔记结构要求

核心原则:读书笔记必须严格按照电子书的章节结构安排,逐章逐节进行分析和应用

笔记结构模板

# 《书名》读书笔记

## 基本信息
- 书名、作者、出版时间、阅读时间

## 第一部分:章节分析

### 第1章:[章节标题]
#### 一、章节总结
- 核心观点
- 关键论据
- 逻辑结构

#### 二、关键内容摘录
- 启发性观点
- 可执行方法论
- 经典案例与数据
- 金句与隐喻

#### 三、章节深度分析
- 内容层面分析
- 逻辑层面分析
- 价值层面分析

#### 四、落地应用建议
- 具体应用场景
- 可执行步骤
- 预期效果

### 第2章:[章节标题]
(重复上述结构)

...

### 第N章:[章节标题]
(重复上述结构)

## 第二部分:全书综合分析

### 一、横向分析:正确的一面
- 核心价值与贡献
- 创新观点与方法
- 实践验证的成果

### 二、纵向分析:不足的地方
- 论证的局限性
- 观点的片面性
- 适用边界的模糊性

### 三、时代印记分析
- 作者背景的影响
- 时代背景的局限
- 历史条件的制约

## 第三部分:延伸阅读推荐

### 相关领域书籍推荐
- 理论深化类
- 实践应用类
- 批判反思类

3. 章节总结(逐章执行)

智能体处理:根据解析出的章节内容,严格按照章节顺序生成总结

总结框架(参考 references/reading-framework.md):

  • 核心观点(1-3句话概括章节主旨)
  • 关键论据(3-5个支撑观点的论据或案例)
  • 逻辑结构(章节的论证逻辑:因果/并列/递进/对比)

重要提示:每个章节都必须独立完成总结,不得跳过或合并

4. 关键内容摘录(逐章执行)

智能体处理:从每个章节中识别并摘录有价值的内容

摘录标准

  • ✅ 启发性观点(颠覆认知或提供新视角)
  • ✅ 可执行方法论(具体可操作的步骤或框架)
  • ✅ 经典案例与数据(有说服力的实例)
  • ✅ 金句与隐喻(值得记忆的表达)

输出格式

【摘录】\x3C原文内容>
【位置】第X章:\x3C章节标题>
【价值】\x3C为什么值得摘录>

重要提示:摘录内容必须与当前章节紧密相关,标注准确的章节位置

5. 章节深度分析(逐章执行)

智能体处理:对每个章节进行多维度深度分析

分析维度(详见 references/reading-framework.md):

  • 内容层面:主题深度、观点创新性、论据充分性
  • 逻辑层面:论证方式、思维模型、逻辑严密性
  • 价值层面:理论贡献、实践意义、适用边界

分析要求

  • 必须结合当前章节的具体内容进行分析
  • 避免泛泛而谈,要有具体的例子支撑
  • 分析要言之有物,指出具体的优缺点

6. 落地应用建议(逐章执行)

智能体处理:将每个章节的内容转化为具体可执行的行动方案

应用方向框架

  • 个人层面:认知升级、习惯养成、技能提升
  • 工作层面:方法应用、决策优化、流程改进
  • 社会层面:价值传播、体系构建、影响力扩大

输出要求

【应用场景】\x3C具体场景描述,必须与章节内容直接相关>
【关联章节】第X章:\x3C章节标题>中的\x3C具体观点或方法>
【行动建议】\x3C可执行的步骤,必须具体到可以立即执行>
【预期效果】\x3C实施后的预期收益,必须可量化或可验证>
【注意事项】\x3C实施过程中可能遇到的问题和解决方法>

关键要求

  • 应用建议必须与当前章节内容直接相关
  • 必须具体、可操作,避免空泛的口号
  • 必须考虑实际可行性,给出具体的执行步骤

7. 全书综合分析(读完所有章节后执行)

智能体处理:在完成所有章节分析后,对全书进行综合分析

分析框架(详见 references/reading-framework.md):

横向分析:正确的一面

  • 核心价值:本书最重要的贡献是什么
  • 创新观点:提出了哪些新概念、新框架、新方法
  • 实践验证:书中观点在实践中取得了哪些成果
  • 理论贡献:对相关领域的理论发展有何推动

纵向分析:不足的地方

  • 论证局限:哪些论证不够充分或有逻辑漏洞
  • 观点片面:哪些观点存在偏颇或绝对化
  • 适用边界模糊:哪些方法的应用边界不清晰
  • 时代局限:哪些观点已经过时或不适用于当前环境

时代印记分析

  • 作者背景:作者的职业、经历如何影响其观点
  • 时代背景:成书时代的社会环境、技术水平、思想潮流
  • 历史条件:当时的知识储备、研究方法、数据来源
  • 跨时代价值:哪些观点具有超越时代的普适性

8. 延伸阅读推荐

智能体处理:基于全书内容,推荐相关的延伸阅读书籍

推荐框架(详见 references/reading-framework.md):

理论深化类

  • 与本书理论相关的经典著作
  • 对本书理论进行深化或扩展的书籍
  • 不同理论流派的代表性作品

实践应用类

  • 应用本书方法的实践案例集
  • 相关领域的实操指南
  • 行业应用的成功案例

批判反思类

  • 对本书观点提出质疑或批判的著作
  • 不同立场的代表性作品
  • 相关领域的最新研究成果

推荐格式

【书名】《XXX》
【作者】XXX
【推荐理由】与本书的关系、阅读价值
【阅读顺序】建议在阅读本书之前/之后阅读
【关联章节】与本书第X章内容相关

资源索引

注意事项

  • 首次使用需安装依赖:pip install ebooklib==0.18 pypdf==3.17.0 beautifulsoup4==4.12.0
  • EPUB格式解析效果最佳,PDF可能存在格式损失
  • 对于扫描版PDF,建议先使用OCR工具转换为文本版
  • 章节分析必须逐章进行,不得跳过或合并章节
  • 落地应用建议必须具体可行,避免空泛的口号
  • 全书分析要客观全面,既要看到正确的一面,也要看到不足之处
  • 时代印记分析要深入,考虑作者和时代的局限性
  • 延伸阅读推荐要有针对性,帮助读者深化理解

使用示例

示例1:生成完整读书笔记

用户:请帮我阅读《原子习惯》这本epub电子书,并生成完整的读书笔记
执行:
1. 调用脚本解析电子书,获取所有章节
2. 逐章执行:总结、摘录、分析、应用建议
3. 全书综合分析:横向、纵向、时代印记
4. 延伸阅读推荐
5. 输出结构化读书笔记

示例2:特定章节分析

用户:请分析《深度工作》第3章,并给出具体的应用建议
执行:
1. 调用脚本解析第3章内容
2. 按框架进行总结、摘录、分析
3. 生成与第3章内容直接相关的落地应用建议
4. 输出章节分析报告

示例3:全书综合分析

用户:请对《原则》进行全书综合分析,并推荐延伸阅读
执行:
1. 基于已完成的章节分析
2. 横向分析:核心价值、创新观点
3. 纵向分析:论证局限、观点片面
4. 时代印记:作者背景、时代局限
5. 延伸阅读推荐:理论深化、实践应用、批判反思
6. 输出全书分析报告
Usage Guidance
该 Skill 从代码和文档层面看是内部一致的:它只解析用户提供的 EPUB/PDF 并输出结构化文本,没有网络请求或凭据使用。使用前请注意:1) 在隔离/受控环境(如虚拟环境或沙箱)中安装并运行依赖,以防第三方库有安全问题;2) 示例中有一个绝对路径示例(/workspace/...),运行时请改用包内相对路径(scripts/ebook_parser.py)或确认路径存在;3) 对扫描版 PDF 需先做 OCR;4) 确保对上传的电子书拥有使用权(版权/隐私);5) 如果对代码有疑虑,可在本地审阅 scripts/ebook_parser.py 并在受限权限下执行(只允许访问指定输入文件和输出目录)。
Capability Analysis
Type: OpenClaw Skill Name: ebook-reader Version: 1.0.0 The ebook-reader skill bundle is a legitimate tool designed for parsing and analyzing EPUB and PDF documents. The core logic in `scripts/ebook_parser.py` uses standard libraries to extract text and metadata, and it lacks any high-risk behaviors such as network requests, credential theft, or unauthorized file access. The instructions in `SKILL.md` and `references/reading-framework.md` are strictly focused on providing a structured framework for book analysis and do not contain any malicious prompt injection or hidden commands.
Capability Assessment
Purpose & Capability
Skill 名称/描述、SKILL.md 和脚本都聚焦于 EPUB/PDF 解析并生成章节级别的总结与建议;请求的 Python 库(ebooklib、pypdf、beautifulsoup4)与该用途相符,没有要求与功能无关的凭据或外部服务。
Instruction Scope
SKILL.md 指示智能体运行包含在包内的解析脚本并按章节逐章处理,说明清晰且限定在用户上传的电子书文件上。需要注意的地方:示例中运行脚本的绝对路径 (/workspace/projects/ebook-reader/...) 与包内相对路径 (scripts/ebook_parser.py) 表述不完全一致,可能导致执行时尝试访问不存在的绝对路径;此外,SKILL.md 强调“必须逐章执行”的规则是功能性约束而非安全问题。
Install Mechanism
没有 install spec(instruction-only + 附带解析脚本),不会在安装阶段从不明 URL 下载或写入可执行文件。SKILL.md/README 建议通过 pip 安装三个明确列出的第三方包,这与功能需求相称。
Credentials
不要求任何环境变量、密钥或系统配置路径,也不访问其他技能的凭据。所需资源仅限于用户提供的电子书文件和可选的本地输出路径,凭据需求与用途一致。
Persistence & Privilege
flags(always:false,agent 可调用)为默认且合理,Skill 不请求持续驻留、修改其他技能配置或提升平台权限。
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ebook-reader
  3. After installation, invoke the skill by name or use /ebook-reader
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the ebook-reader skill. - Supports parsing and analysis of common ebook formats (EPUB, PDF). - Provides structured book notes: chapter summaries, key excerpts, in-depth analysis, and actionable application advice. - Outputs comprehensive full-book analysis and curated further reading recommendations. - Requires Python dependencies: ebooklib==0.18, pypdf==3.17.0, beautifulsoup4==4.12.0.
Metadata
Slug ebook-reader
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 电子书阅读助理?

智能电子书阅读助手,支持EPUB/PDF等常见格式解析;提供章节总结、关键内容摘录、深度分析与落地应用建议;当用户需要阅读电子书、做读书笔记或寻求知识转化方案时使用. It is an AI Agent Skill for Claude Code / OpenClaw, with 131 downloads so far.

How do I install 电子书阅读助理?

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

Is 电子书阅读助理 free?

Yes, 电子书阅读助理 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 电子书阅读助理 support?

电子书阅读助理 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 电子书阅读助理?

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

💬 Comments