Leo's Reading Notes

帮助用户将读过书中的观点结构化为系统化笔记，包含原文补充、转述、深度追问和业务关联分析。

Security Scan

The skill's requested resources and instructions are coherent with its stated purpose of creating and managing structured reading notes; nothing in the package indicates unexplained access to secrets, external endpoints, or privileged installers.

Purpose & Capability

The name/description (structure reading notes, internalization workflow, nightly reminders) matches the SKILL.md: it reads user book snippets, searches for original text, creates/updates markdown files, and manages an internal pending list. It does not request unrelated credentials or binaries.

Instruction Scope

The instructions ask the agent to 'use a search tool' to find original text and to read/write files under reading-notes/ and workspace/skills/reading-notes/. Those actions are appropriate for the purpose, but the SKILL.md also defines a nightly 21:00 reminder workflow without providing an implementation or install-time scheduler — it's an expectation on the agent runtime to run periodically. The document does not reference any external endpoints beyond generic web search, nor does it request unrelated system files or credentials.

Install Mechanism

There is no install spec (instruction-only). The only code file is a small publish.sh helper that invokes a clawhub CLI to publish the skill. No downloads, archives, or third‑party package installs are present.

Credentials

The skill declares no required environment variables, credentials, or config paths. The runtime instructions only read/write files within the skill's documented data directories. This is proportionate to the stated functionality.

Persistence & Privilege

always:false and default autonomous invocation are appropriate. The SKILL.md requests recurring (daily 21:00) behavior, which implies persistent scheduling at the agent/platform level; the skill itself doesn't install a scheduler or modify system-wide settings. The publish script references an absolute /root path, which is odd but not inherently malicious—it may assume a particular runtime layout.

Assessment

This skill appears to do what it says: find/bookmark text, structure notes, and manage a nightly internalization checklist. Before installing, consider these practical checks: 1) Confirm how your agent/platform implements the '21:00' reminder — the SKILL.md expects scheduled runs but the skill provides no scheduler; verify you want the agent to run nightly and send reminders. 2) Review storage location and permissions: notes are written to reading-notes/ (and the publish script uses /root/.openclaw/…); ensure you are comfortable with those paths and that the agent has only the filesystem access you intend. 3) Be aware the skill performs web searches to fetch original text and may store excerpts; if you have concerns about copyrighted material or external network access, confirm the agent's search tool and content sourcing policy. 4) The publish.sh helper calls a clawhub CLI and uses an absolute root path — do not run scripts as root unless you understand them. If you want stronger assurance, request the author to: supply a documented scheduling mechanism (or remove the nightly reminder requirement), avoid hard-coded /root paths, and state what search provider or API will be used for text lookups.

📚 Reading Notes - 读书笔记管理 Skill

核心使命: 帮用户把读过的书变成结构化的知识资产

---

触发条件

必须响应的关键词/场景：

• 用户说"在读..."、"刚看了..."、"书里提到..."
• 用户分享书中的观点、金句、想法
• 用户明确说"记一下这个笔记"

一旦触发，立即进入「读书笔记模式」

---

工作流程

1. 识别书籍信息

从用户输入中提取：

• 书名（必须）
• 作者（尽量获取）
• 章节/页码（可选）
• 用户的核心想法/要点

2. 查找原文

• 使用搜索工具查找书籍原文
• 补充用户提到的要点的完整句子
• 确认上下文准确性

3. 创建/更新笔记

• 检查书籍目录是否存在，不存在则创建
• 按主题/章节创建笔记文件
• 使用模板格式化内容

4. 输出确认

• 告诉用户笔记已保存
• 简要复述记录的核心内容

---

文件结构

reading-notes/                          # 数据存储目录
├── README.md                           # 书籍总览
├── _templates/                         # 模板文件
│   ├── book-readme.md                  # 书籍信息页模板
│   └── note-template.md                # 单条笔记模板
├── assets/                             # 附件（书摘图片等）
└── {书名}/                             # 每本书一个目录
    ├── README.md                       # 书籍信息
    └── {主题}.md                       # 具体笔记

workspace/skills/reading-notes/         # Skill 代码
├── SKILL.md                            # 本文件
├── scripts/                            # 辅助脚本
└── references/                         # 参考文档

---

笔记格式规范

单条笔记必须包含：

---
title: "笔记标题"
book: "书名"
author: "作者"
chapter: "章节名"
page: 页码
tags: [标签1, 标签2]
created: YYYY-MM-DD
---

内容结构：

1. 📖 原文摘录

   • 用户提到的要点
   • 查找后的完整原文
   • 出处信息
   • ⚠️ 如果原文是并列结构（多个要点/步骤/要素），必须拆分为结构化表格

2. 🔄 我的转述（强制）

   • 用自己的话重新表述原文概念
   • 不是简单重复，而是真正理解后的表达

3. ❓ 5个为什么追问（强制）

   • 针对核心概念，连续追问至少3-5个「为什么」
   • 层层深入，触及本质
   • 每个「为什么」都要有答案

4. 💼 业务关联分析（强制）

   • 当前工作关联：与现有工作/部门的关系？如何应用？
   • 未来事业关联：与想做的事业方向的关系？长期价值？
   • 行动计划：具体可以做什么？下一步行动？

5. 💭 我的感悟（可选补充）

   • 其他延伸思考
   • 情感共鸣或反思

6. 🔗 关联思考（可选）

   • 关联概念
   • 类似观点
   • 其他书籍引用

---

输出格式

保存后向用户确认：

✅ 已记录笔记

📖 《书名》- 作者
📝 主题: xxx
💡 核心观点: (一句话概括)
📁 保存位置: reading-notes/书名/xxx.md

---

并列结构表格化规范

当原文包含并列要素（如：多个要点、步骤、条件、特征等），必须拆分为结构化表格，便于理解、搜索和记忆。

需要表格化的场景：

场景	原文特征	处理方式
列举型	"有三个要点：A、B、C"	表格列出每个要点 + 解释
步骤型	"第一步...第二步..."	表格列出步骤 + 操作 + 目的
对比型	"A 是...B 是..."	表格对比不同维度的差异
条件型	"如果...那么..."	表格列出条件 + 结果/行动
要素型	"成功的 X 要素"	表格列出要素 + 说明 + 重要性

表格格式示例：

原文: "高效能人士的七个习惯：积极主动、以终为始、要事第一、双赢思维、知彼解己、统合综效、不断更新"

表格化后:

| 序号 | 习惯 | 核心含义 | 关键词 |
|------|------|----------|--------|
| 1 | 积极主动 | 对自己的选择负责，不被动反应 | 责任、选择 |
| 2 | 以终为始 | 先明确目标，再开始行动 | 愿景、目标 |
| 3 | 要事第一 | 优先处理重要但不紧急的事 | 优先级、专注 |
| 4 | 双赢思维 | 寻求互惠互利的解决方案 | 合作、共赢 |
| 5 | 知彼解己 | 先理解别人，再被理解 | 倾听、共情 |
| 6 | 统合综效 | 1+1>2，创造第三种选择 | 协作、创新 |
| 7 | 不断更新 | 在身体、精神、智力、社会情感上持续提升 | 成长、平衡 |

表格设计原则：

1. 列的选择：根据内容类型选择合适的列

   • 概念类：序号、术语、定义、关键词、关联概念
   • 步骤类：步骤、操作、目的、注意事项
   • 对比类：维度、A方、B方、差异点

2. 可读性：

   • 每列内容不宜过长
   • 复杂概念用简短关键词概括
   • 必要时添加「备注」列

3. 搜索友好：

   • 关键词单独成列
   • 使用标准化的术语
   • 避免口语化表达

---

每日内化提醒机制（21:00）

触发条件

• 当天有新记录的笔记
• 用户尚未完成「5个为什么 + 业务关联」内化流程

提醒流程

每天晚上 21:00，检查当天的新笔记：

1. 读取待内化清单：reading-notes/_pending/internalization.md

2. 列出所有未完成条目：

   📚 今日待内化笔记 (X条)
   
   1. 《书名》- 笔记主题
      ⏳ 状态: 待转述 + 5个为什么 + 业务关联
   
   2. 《书名》- 笔记主题  
      ⏳ 状态: 已完成转述，待5个为什么 + 业务关联
   
   ...
   

3. 逐项引导用户完成：

   • 我列出每一条笔记
   • 用户逐一确认「是否已完成内化」
   • 未完成的，引导用户现场完成

4. 完成后标记：更新待内化清单状态

待内化清单格式

文件位置：reading-notes/_pending/internalization.md

---
date: YYYY-MM-DD
status: pending | in-progress | completed
---

# 待内化笔记清单

| 序号 | 书名 | 笔记主题 | 文件路径 | 转述 | 5个为什么 | 业务关联 | 状态 |
|------|------|----------|----------|------|-----------|----------|------|
| 1 | 《原子习惯》| 系统胜过目标 | atomic-habits/systems.md | ⬜ | ⬜ | ⬜ | 待完成 |
| 2 | 《金字塔原理》| 四个基本原则 | pyramid-principle/four.md | ✅ | ⬜ | ⬜ | 进行中 |

## 完成记录

- [ ] 21:00 提醒已发送
- [ ] 用户已完成全部内化

用户响应方式

用户可以说：

• "第1条我完成了：...（给出转述和5个为什么）"
• "第2条跳过，暂时想不到关联"
• "全部完成"
• "明天再说"

我的回应：

• 将用户的内化内容补充到对应笔记文件中
• 更新待内化清单状态
• 确认完成度

---

完整示例（含内化流程）

步骤1: 用户分享

用户输入:

刚看《原子习惯》，书里说你不需要成为作家才能写作，每天写一页就行

步骤2: 我记录笔记

创建笔记文件: atomic-habits/systems-over-goals.md

---
title: "系统胜过目标"
book: "原子习惯"
author: "James Clear"
chapter: "第一章"
page: null
tags: [习惯, 系统, 目标]
created: 2026-03-15
internalization:
  paraphrase: ⬜
  five_whys: ⬜
  business_link: ⬜
---

# 系统胜过目标

## 📖 原文摘录

### 用户要点
> 不需要成为作家才能写作，每天写一页就行

### 原文完整句子
> "You do not rise to the level of your goals. You fall to the level of your systems."
> "Every action you take is a vote for the type of person you wish to become."

*出处: 《Atomic Habits》- James Clear，第一章*

---

## 🔄 我的转述（待完成）

<!-- 用自己的话重新表述 -->
⬜ 待补充...

---

## ❓ 5个为什么（待完成）

**核心概念**: 系统比目标更重要

1. **为什么系统比目标更重要？**
   - ⬜ 待回答...

2. **为什么「每天写一页」比「成为作家」更有效？**
   - ⬜ 待回答...

3. **为什么目标导向会失败？**
   - ⬜ 待回答...

4. **为什么系统导向能持续？**
   - ⬜ 待回答...

5. **为什么身份认同比结果更重要？**
   - ⬜ 待回答...

---

## 💼 业务关联（待完成）

### 当前工作关联
⬜ 待思考...

### 未来事业关联
⬜ 待思考...

### 行动计划
- [ ] 

---

## 💭 我的感悟

待补充...

同时添加到待内化清单: reading-notes/_pending/internalization.md

步骤3: 晚上21:00提醒

我发送消息:

🌙 21:00 内化提醒

今天记录了 1 条新笔记，需要完成深度内化：

📚 待内化笔记

1. 《原子习惯》- 系统胜过目标
   ⏳ 待完成：
   ⬜ 我的转述（用自己的话重新说一遍）
   ⬜ 5个为什么追问
   ⬜ 业务关联分析（当前工作 + 未来事业）

请逐项完成，或者直接告诉我你的想法，我来帮你整理～

步骤4: 用户完成内化

用户回复:

第1条： 转述：目标只是方向，真正决定你能走多远的是日常的习惯系统。就像健身，定目标"瘦10斤"没用，有用的是每天去健身房那个动作。

5个为什么：

1. 为什么系统更重要？因为目标是一次性的，系统是持续的
2. 为什么每天写一页更有效？因为行动塑造身份，不是身份决定行动
3. 为什么目标导向会失败？达成目标后就停了，没有持续机制
4. 为什么系统能持续？因为它变成了日常，不需要意志力
5. 为什么身份认同重要？因为你做的每件事都在投票给"你是谁"

业务关联：

• 当前工作：我做产品方案不应该只盯着上线那个目标，而是要建立「每周用户访谈」的系统
• 未来事业：想做独立产品，现在就要建立「每天写代码/写文档」的系统，而不是等离职才开始
• 行动：从明天开始，每天下班前写30分钟产品思考，不管写多少

步骤5: 我更新笔记文件

将用户的内化内容填充到对应位置，标记完成状态。

最终输出确认:

✅ 笔记已完整内化！

📖 《Atomic Habits》- James Clear
📝 主题: 系统胜过目标
✅ 转述：完成（用自己的话重新表述）
✅ 5个为什么：完成（层层深入触及本质）
✅ 业务关联：完成（工作+事业+行动）
📁 保存位置: reading-notes/atomic-habits/systems-over-goals.md
💡 核心洞察: 每天30分钟产品思考，投票给"我是产品经理"的身份

用户输入:

刚看《原子习惯》，书里说你不需要成为作家才能写作，每天写一页就行

我的动作:

1. 搜索《原子习惯》相关原文
2. 找到完整句子："You do not rise to the level of your goals. You fall to the level of your systems."
3. 创建笔记文件
4. 向用户确认

输出:

✅ 已记录笔记

📖 《Atomic Habits》- James Clear
📝 主题: 系统胜过目标
💡 核心: 真正决定结果的是日常系统，不是宏大目标
📁 保存位置: reading-notes/atomic-habits/systems-over-goals.md

---

用户输入（并列结构）:

刚看《金字塔原理》，书里讲思考问题的四个基本原则：结论先行、以上统下、归类分组、逻辑递进

我的动作:

1. 确认书籍信息：《金字塔原理》- 芭芭拉·明托
2. 找到原文完整表述
3. 将四个原则表格化，每列包含：原则、含义、应用场景
4. 创建笔记文件

输出:

✅ 已记录笔记（含结构化表格）

📖 《金字塔原理》- 芭芭拉·明托
📝 主题: 思考问题的四个基本原则
💡 核心: 结构化表达的四个维度
📊 表格: 4个原则 × 3个维度（含义、应用、关键词）
📁 保存位置: reading-notes/pyramid-principle/four-principles.md

笔记中的表格示例:

| 原则 | 核心含义 | 典型应用场景 | 关键词 |
|------|----------|--------------|--------|
| 结论先行 | 先说结论，再说论据 | 汇报、邮件、演讲开头 | 论点、中心思想 |
| 以上统下 | 上层是下层的概括 | 构建层级结构 | 总分、概括 |
| 归类分组 | 同类信息归为一组 | 整理复杂信息 | MECE、分类 |
| 逻辑递进 | 按逻辑顺序排列 | 论证过程、时间线 | 顺序、因果 |

---

注意事项

1. 书名标准化: 使用英文原名（如有），便于后续搜索
2. 原文准确性: 尽量找到完整句子，不确定时标注「大致意思」
3. 感悟个性化: 不要套话，写出真实的思考
4. 标签一致性: 使用统一的标签体系（待建立）
5. ⚠️ 并列结构必须表格化: 遇到列举、步骤、对比、要素等并列内容，必须拆分为结构化表格
6. ⚠️ 内化流程是强制的: 每个笔记必须包含「转述 + 5个为什么 + 业务关联」，未完成会在21:00提醒
7. ⚠️ 晚上21:00检查: 每天检查当天新笔记的内化状态，发送提醒清单

---

Obsidian 兼容性

笔记格式设计为可直接导入 Obsidian：

• YAML frontmatter → Obsidian 属性
• [[链接]] 语法支持双向链接
• #标签 语法支持标签检索
• 相对路径兼容 Obsidian 附件

---

Skill 创建: 2026-03-15 版本: 1.2 Cron任务: reading-notes-internalization (每天 21:00)