| name | book-note-writer |
| description | 生成深度读书笔记的专用 Skill。输入书籍的豆瓣链接（或书名+作者），自动搜索书籍信息、高质量书评、学术评价等素材，结合 Claude 的深度思考，生成图文并茂、观点鲜明、适合分享的读书笔记，以 Markdown 格式保存到项目 markdown/ 目录。触发条件：用户提供豆瓣链接、提到"读书笔记"、"书评"、"帮我分析这本书"、"写一篇XX书的笔记"，或任何希望深度理解一本书的场景。即使用户只说"帮我写一下这本书的感悟"，也应使用本 skill。 |
Book Note Writer — 深度读书笔记生成器
Skill 定位
这不是书籍摘要，也不是简单的内容提炼，而是一次思想的重建与对话。
目标：生成一份「读者能讲给别人听」的读书笔记，有观点、有结构、有温度、图文并茂。
Step 0：理解输入
用户可能提供：
- 豆瓣链接（如
https://book.douban.com/subject/XXXXXXX/）
- 书名 + 作者名
- 只有书名
如果输入不明确（只有书名无作者），暂停并确认：
「找到了多本同名书，请确认您指的是哪本：[列表]，或者补充作者名」
确认书名和作者后再继续。
Step 1：信息收集（Research Phase）
1.1 从豆瓣抓取基础信息
如果用户提供了豆瓣链接，使用 web_fetch 抓取：
- 书名、作者、出版年份、出版社、页数
- 豆瓣评分与评分人数
- 豆瓣简介（官方简介）
- 豆瓣标签
web_fetch(url=豆瓣链接)
1.2 搜索高质量素材
围绕书籍进行多轮搜索，优先选择高质量来源：
优先级（从高到低）：
- 学术评论、学术期刊书评
- 知名媒体书评（NYT、The Guardian、FT、《读书》杂志等）
- 豆瓣长评（1000字以上，点赞数高）
- 作者访谈、演讲、TED
- 维基百科（背景信息）
- 其他读者笔记（仅参考，不复制）
搜索策略（使用 web_search，每类至少2条）：
# 必做搜索
"{书名} {作者} 书评" → 找豆瓣/媒体书评
"{书名} {作者} 读后感" → 找读者笔记
"{作者} 访谈/演讲" → 作者本人怎么说
# 深度搜索（至少选1个）
"{书名} 批评/反思" → 找争议性评论
"{作者} 思想体系/核心观点" → 找学术分析
"{书名} 时代背景/历史意义" → 找背景资料
# 英文备选（上述搜索少于5条时触发）
"{BookTitle} {Author} review"
"{Author} interview/talk"
搜索结果质量判断：
- 有实质观点（至少300字以上）→ 高质量，可直接
web_fetch
- 短评/感慨 → 低质量，跳过
- 广告/引流 → 过滤，不用
注意：
- 只参考内容丰富、有观点的素材，过滤纯广告、无实质内容的页面
- 对每个来源都要判断质量，低质量来源宁可不用
- 用
web_fetch 获取重要长文的完整内容
冷门书处理（搜索结果极少）：
- 豆瓣无评分或评价人数 < 50 → 在笔记开头注明「冷门书，素材有限」
- 搜索结果 < 5 条 → 降低高质量来源门槛，豆瓣短评/知乎讨论也可参考
- 完全找不到资料 → 询问用户「这本书比较小众，我手上没有足够素材，您可以提供1-2段摘录或核心观点吗？」
搜索无结果时的 fallback：
- 换用英文关键词搜索
"{书名} {作者} review"
- 用作者英文名搜索
"{作者英文名} biography"
- 仍无结果 → 告知用户并继续用已有素材，笔记中注明素材来源有限
1.3 了解作者
搜索作者背景：
- 生平、学术/职业经历
- 写作这本书的动机和背景
- 作者的其他重要作品
- 作者在领域内的地位和争议
✅ 检查点：素材确认
收集完素材后，展示已获取的关键信息：
已获取：
- 书名 / 作者 / 出版年
- 豆瓣评分（X.X，X人评价）
- 找到 X 篇高质量书评/评论
- 找到 X 条作者访谈/背景资料
确认继续还是补充？
- 直接继续 → 进入深度分析
- 补充某个方向 → 请说明（如：我更想了解XX视角）
如果素材严重不足（高质量来源 < 2个）：
「这本书记载较少，可参考素材有限，笔记质量可能受限。是否继续？」
Step 2：深度分析（Analysis Phase）
对收集到的素材，逐一完成以下分析，每项输出留痕（哪怕只有一句话）：
2.1 时代坐标
- 输出：1段2-3句话的时代背景描述 + 写作动机一句话
2.2 核心命题（1-3个）
- 输出：每个命题用一句话概括，列出编号
- 判断：这些观点在当时是否颠覆性？（是/否/部分）
2.3 论证解剖
- 输出：列出2-3个关键论据（数据/案例/故事），标注可信度（高/中/低）
- 识别：有没有论证漏洞或过度简化？（有/无，简述）
2.4 逻辑链条
2.5 前提假设（批判性视角）
- 输出：列出2-3个隐含假设，标注每个假设在今天是否仍成立
2.6 思想内核
- 输出：作者的思想传统一句话描述 + 与同时代思想的关系一句话
✅ 检查点：分析完成确认
分析完成，准备进入写作阶段。
核心命题：X个
关键论据：X个（高可信度X个）
逻辑图：已绘制
前提假设：X个（X个今天仍成立）
确认进入写作还是调整分析方向？
- 继续 → 进入 Step 3
- 重新聚焦某个维度 → 请说明
Step 3：撰写读书笔记（Writing Phase）
3.1 整体风格要求
- 有观点：笔记本身要有立场，不只是转述
- 有温度：写作者（Claude）的真实思考要融入其中
- 通俗易懂：不依赖读过原书才能看懂
- 图文并茂：关键结构用图示呈现
- 适合分享：可以直接发给没读过这本书的朋友
3.2 标准结构模板
# 《书名》读书笔记
> **一句话**：[最能概括这本书的一句话]
> **适合谁读**：[目标读者画像]
> **阅读难度**：⭐⭐⭐☆☆（1-5星）
> **推荐指数**：⭐⭐⭐⭐☆
---
## 一、时代坐标：这本书从哪里来？
[200-400字]
- 写作时代背景（时间、社会、学术环境）
- 作者写这本书的动机
- 这本书要解决什么问题
[可选：用 SVG 或文字图展示时间轴]
---
## 二、核心命题：作者在说什么？
[300-500字，用小标题列出2-3个核心观点]
### 观点一：[标题]
...
### 观点二：[标题]
...
---
## 三、论证地图：作者怎么说服你的？
[Mermaid 思维导图或逻辑图]
[200-300字文字解析]
- 关键数据
- 代表性案例/故事
- 论证方式的评价
---
## 四、前提假设与边界：什么情况下这不成立？
[200-300字]
- 列出2-3个关键前提假设
- 分析每个假设是否依然成立
- 这本书的适用边界在哪里
---
## 五、思想谱系：这本书在哪个传统里？
[150-250字]
- 作者的思想来源
- 与同时代思想的对话
- 对后来者的影响
[可选：用简单的文字图展示影响脉络]
---
## 六、我学到了什么？
[300-400字，第一人称，真实思考]
- 最重要的3个收获（带个人理解，不只是复述）
- 改变了我哪些认知
---
## 七、举一反三：这个框架还能用在哪？
[200-300字]
- 核心方法论的迁移应用
- 2-3个具体场景举例
---
## 八、批判与反思
[200-300字]
- 哪里我不同意？
- 哪里时代已经变了？
- 这本书的局限性在哪里？
---
## 九、金句与记忆点
[列出5-8条值得记住的句子或概念，附简短解析]
---
## 十、延伸阅读
[3-5本相关书目，注明为什么推荐]
---
*笔记写于 [日期] | 基于公开资料与深度思考整理*
3.3 图示规范
Mermaid 图（用于逻辑关系、思维导图、流程）：
mindmap
root((核心论点))
论据1
数据支撑
案例
论据2
...
SVG 图（用于时间轴、关系图、强调视觉效果时）：
- 保持简洁，黑白为主，最多2种强调色
- 宽度不超过 700px
ASCII/文字图（简单关系时）：
[前提A] + [前提B]
↓
[中间推论]
↓
[核心结论]
每篇笔记至少包含 2 个图示，推荐：
- 核心逻辑/论证结构（Mermaid）
- 思想谱系或时间轴（SVG 或 Mermaid）
Step 4：保存文件
✅ 检查点：初稿确认
写完初稿后，先向用户展示结构摘要，不直接保存：
读书笔记初稿完成，结构如下：
## X、标题（字数）
## X、标题（字数）
...
金句 X 条
延伸阅读 X 本
确认后我再保存到 markdown/ 目录。
如需调整某个章节，请告诉我。
4.1 文件路径
mkdir -p markdown/
markdown/sapiens_2024.md
markdown/poor_economics_2024.md
markdown/jingsi_lu_2024.md
4.2 文件头信息
每个笔记文件顶部加上元信息（YAML frontmatter）：
---
书名: 《原书名》
作者: 作者名
出版年份: YYYY
笔记日期: YYYY-MM-DD
豆瓣评分: X.X（X人评价）
标签: [标签1, 标签2, 标签3]
来源: [豆瓣链接，如无则填"网络搜索"]
---
> **核心一句话**：[最能概括这本书的一句话]
> **适合谁读**：[目标读者画像，1-2句话]
> **阅读难度**：⭐⭐⭐☆☆（1-5星）
> **推荐指数**：⭐⭐⭐⭐☆（1-5星）
Step 5：完成后告知用户
告知用户：
- 文件保存路径
- 笔记的核心亮点（一句话）
- 如果发现素材不足或有值得深挖的方向，主动告知并询问是否继续
质量检查清单
写完后自查：
Step 6：「我学到了什么」专项指导
这是最能体现"有温度"的章节，按以下结构写：
[2-3句个人真实感悟开头，建立共鸣]
3个核心收获：
① [概念/观点名称]：为什么重要？它怎么改变了我原有的认知？（X字）
② [概念/观点名称]：这个工具/框架怎么用？举一个我想到的例子（X字）
③ [概念/观点名称]：最难的部分是什么？我还有什么疑惑（X字）
[2-3句收尾，与开头呼应]
注意：每个收获必须写"它怎么改变了我"，不只复述概念本身。
Step 7：「举一反三」专项指导
核心方法论迁移应用的表达公式：
[方法论名称] + [某个新场景] = [具体洞察]
示例（针对投资类书籍）：
"第二层思维" + 判断房价走势 = 不要只看价格，要看参与者的预期差
"安全边际" + 职业选择 = 不选只有1家雇主能去的岗位，要选即使降薪也愿意干的公司
每条格式：[方法论] + [场景] = [洞察]，1句话，够具体。
Step 8：「批判与反思」专项指导
表达不同意的公式：
"作者认为X，但我不这么认为，因为Y"
示例：
"作者认为'穷人是自愿选择的贫困'，但我不这么认为——系统性障碍（教育/医疗/住房）才是主要矛盾，个体意志在结构性压力面前作用有限。"
每条 2-3 句话，必须有具体理由，不能只说"我不同意"。
注意事项
- 不抄袭：参考书评和素材，但所有文字必须是重新组织的，不直接复制粘贴
- 注明来源：如果引用了特定数据或观点，在文中说明「据某某」
- 保持诚实：如果某本书信息很少（冷门书），要告知用户素材有限，笔记质量可能受限
- 控制长度：完整笔记目标 2000-4000 字，不要为了显得「全面」而注水
- 豆瓣抓取失败时：直接用书名+作者进行搜索，不要卡死在这一步
