메뉴
**阅读笔记整理**：帮助整理微信读书划线，**引导用户深度思考**，将画线笔记转化为高质量文献笔记。 - 触发条件：用户完成阅读后想整理笔记、有微信读书划线想处理、想深度思考某本书 - 核心功能：分批处理大量划线、**评估思考深度并引导补充**、进度持久化、生成文献笔记 - AI角色：思考伙伴——通过提问帮助你发现自己的洞见，而非替你总结
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | ah-read |
| description | **阅读笔记整理**：帮助整理微信读书划线，**引导用户深度思考**，将画线笔记转化为高质量文献笔记。 - 触发条件：用户完成阅读后想整理笔记、有微信读书划线想处理、想深度思考某本书 - 核心功能：分批处理大量划线、**评估思考深度并引导补充**、进度持久化、生成文献笔记 - AI角色：思考伙伴——通过提问帮助你发现自己的洞见，而非替你总结 |
执行 Obsidian 的读取、检索、写入等动作时，优先调用官方技能：
obsidian-cli。
帮助你从阅读划线中提炼真正属于自己的洞见。 画线只是起点，你的思考才是终点。
⚠️ 进入本技能后，必须完成完整流程才能退出！
核心原则：用户的回答是「数据输入」，不是「命令触发」。
禁止跳转的情况：
调用 ah-card 后必须返回：
流程完成标志：
阅读不是收集，而是对话。
这些原则必须严格执行，不可跳过！
启动时必须：
1. 读取 {{metaPaths.memory}}/STATUS.md
2. 检查"阅读整理"区域是否有该书的进度
3. 如果有，提示用户是否继续
结束时必须：
1. 更新 {{metaPaths.memory}}/STATUS.md 中的"阅读整理"区域
2. 如果产生了待制卡的洞见，同时在"卡片笔记"区域添加条目
3. 更新"AI 启动提示"区域
状态流转：
划线待整理 → 整理中(N/M批次) → 文献笔记已完成 → 待整理卡片笔记 → 已完成
每次会话必须：
{{metaPaths.memory}}/reading/《书名》.mdah-memory 接口规范先创建目录与最小文件结构，再继续整理完成后必须：
Write 工具将文献笔记写入 {{notePaths.literatureNotes}}/《书名》.mdWrite 工具更新进度文件当划线数量超过20条时：
必须按"章节行号范围"分段读取，避免全文上下文膨胀。
⚠️ 当用户想整理卡片笔记/永久笔记时，必须调用
ah-card技能！绝对不能自己直接创建永久笔记文件！ 必须读取并执行
{{skillsDir}}/ah-card/SKILL.md中的流程！
书名、章节、划线数量、想法数量都来自真实文档。
0. 检查进度（是否有未完成的整理）
↓ 有 → 读取进度，询问是否继续
↓ 无 → 进入新整理流程
1. 收集阅读上下文（书名、动机、模式选择）
↓
2. 运行脚本提取章节索引，生成分批计划
↓
3. 逐章处理：展示划线 → 【核心】评估思考深度 → 引导补充 → 提炼洞见
↓
4. 生成/更新文献笔记（用户思考的结构化整理）
↓
5. 按转化策略执行分支（逐章转卡 / 全书后转卡）
↓
6. 回写状态，输出下一步建议
首先检查：{{metaPaths.memory}}/reading/
是否存在该书的进度文件？
如果存在进度文件：
📋 发现未完成的整理进度！
书籍：《{{书名}}》
上次进度：已完成 {{N}}/{{M}} 章节
上次停留：{{章节名}}
要继续整理吗？
- A. 继续上次进度
- B. 重新开始（会覆盖之前的进度）
如果没有进度文件，进入阶段一。
收到你的阅读划线！📚
在开始之前，请告诉我：
1. **这本书叫什么？作者是谁？**
2. **你为什么读这本书？**（想解决什么问题）
3. **整理笔记时，你希望我：**
- A. 深度思考模式 — 帮你逐条分析，引导你深度思考（推荐）
- B. 快速整理模式 — 只在关键处提问，快速归类
- C. 直接整理模式 — 不需要引导，直接归类整理
用户选择权是核心原则。 用户说"不需要引导"就直接整理，不要强行提问。
还需要确认一下转化策略：
整理完成后，你想怎么处理洞见→卡片笔记？
- A. 逐章转卡 — 每章完成后可立即制作卡片笔记
- B. 全书后转卡 — 先完成整本书整理，最后批量转卡
若用户未明确选择，必须继续追问直到选定策略。
若用户提供了微信读书导出文档路径，执行：
python3 ".opencode/skills/ah-read/assets/extract_weread_outline.py" headings "<文档路径>"
脚本输出全部三级标题与行号后，由 AI 判断"大章节"并生成章节范围统计。
我把 {{N}} 条划线按章节分成了 {{M}} 个批次：
📋 整理计划
| 序号 | 章节 | 划线数 | 想法数 | 状态 |
|------|------|--------|--------|------|
| 1 | {{章节1}} | {{n}}条 | {{m}}条 | ⬜ 待处理 |
| 2 | {{章节2}} | {{n}}条 | {{m}}条 | ⬜ 待处理 |
| ... | ... | ... | ... | ... |
你可以随时说"今天先到这"，我会保存进度。
从哪一章开始？
分类完成后，必须立即创建/更新进度文件！
阅读进度文件路径固定：{{metaPaths.memory}}/reading/《书名》.md
本阶段是整个技能的核心价值所在。 目标不是让 AI 替用户总结，而是引导用户对画线内容进行深度思考，将"别人的话"转化为"自己的理解"。 最终产出的文献笔记，内容全部来自用户在对话中的原话。
按章节行号范围读取（禁止全文读取），展示给用户：
📖 {{章节名}}（{{n}}条划线，{{m}}条想法）
你划的内容：
> 1. "{{划线内容1}}"
> 💬 你的想法：{{用户批注（如有）}}
> 2. "{{划线内容2}}"
> （无批注）
> ...
在引导之前，AI 必须先评估这批划线中用户的思考深度。 这个评估决定了后续用什么策略引导。
对每条划线旁的批注，分为三个层次：
层次一：无思考或极浅思考
层次二：有初步思考
层次三：有较深思考
评估完成后，向用户汇报：
这批 {{n}} 条划线中：
- {{x}} 条有较深思考，可以直接整理
- {{y}} 条有初步想法，我们可以稍微展开
- {{z}} 条只是划了线，需要回忆一下当时为什么划
我建议我们重点关注其中 {{推荐数量}} 条来深入思考，其余的快速归类。
你觉得呢？还是你想自己选择哪些深入？
引导的核心原则：
- 每次只问一个方向，不要一口气抛出多个问题
- 每条划线最多追问两轮，不要变成审问
- 用户说"跳过"或"就是觉得不错"时，立即尊重，标记为浅层记录
- AI 不替用户思考，也不暗示"正确答案"
目的：帮助用户回忆当时为什么划这句话。
💭 你划了这句话：
> "{{划线内容}}"
当时是什么让你停下来划了这句？
是觉得说得对，还是觉得意外，又或者就是表达得好？
如果用户给出了回应，可以温和追问一轮：
如果用户说"就是觉得不错"且不想深入 → 尊重选择，归入"浅层记录"。
目的：帮助用户把模糊的感受变成具体的理解。
💭 你在这里写了：「{{用户的批注}}」
能再具体说说吗？
比如，你说"和XX有关"，具体是哪个点让你联想到的？
追问策略（选择其中一个方向，不要全用）：
目的：确认用户已有的思考，帮助结构化表达。
💭 你在这里的思考已经很到位了：
> 原文："{{划线内容}}"
> 你的理解：「{{用户的批注}}」
我理解你的核心观点是：{{AI用一句话总结用户意思}}
这样理解对吗？还是你想补充点什么？
在深度模式下，对用户选择深入的划线，可以额外提供思维工具：
💡 如果需要，我可以用这些角度帮你思考：
1. 🎓 费曼技巧 — 用最简单的话解释这个概念
2. 🔍 苏格拉底式提问 — 检验这个观点的假设
3. 🔄 逆向思维 — 什么情况下这不成立？
4. ⏭️ 二阶思考 — 如果真这样做，长期会怎样？
选择一个深入，或直接分享你的想法。
每完成一个章节的引导后，将本章内容整理为四个区块。每个章节下包含：核心概念、洞见时刻、行动灵感、划线整理。
核心概念（AI提取 + 用户解释）：
我从本章划线中识别出以下核心概念：
1. {{概念1}}
2. {{概念2}}
3. {{概念3}}
能用自己的话解释一下这几个概念吗？不用很长，你怎么理解就怎么说。
洞见时刻（引导产出）：
行动灵感（引导产出）：
划线整理（AI自动）：
📝 {{章节名}} 整理小结
### 核心概念
- **{{概念1}}**：{{用户的解释原话}}
- **{{概念2}}**：{{用户的解释原话}}
### 洞见时刻 ⭐
#### 洞见 1：{{用断言式短语概括，来自用户原话}}
- 触发线索："{{划线原文}}"
- 我的理解：{{直接使用用户在对话中说的原话，只做最小结构调整}}
- 永久笔记候选：{{是/否}}
- 永久笔记：{{转卡后填写：[[永久笔记标题]]}}
### 行动灵感
- {{用户提到的具体行动}}
### 划线整理
##### 主题：{{主题名}}
- "{{划线原文}}" — {{小节名}}
---
这些整理准确反映了你的想法吗？有需要修改的地方吗？
硬约束：
每完成一个章节，必须更新进度文件！
更新内容：
✅ {{章节名}} 已完成！
进度：{{N}}/{{M}} 章节
本章提炼洞见：{{x}} 个
累计候选洞见：{{y}} 个
继续下一章？或者说"今天先到这"保存进度。
必须使用 Write 工具将笔记写入文件系统！
文件位置：{{notePaths.literatureNotes}}/《{{书名}}》.md
📄 笔记模板：
references/文献笔记模板.md
文献笔记内容来源：
再次强调：文献笔记中"我的理解"部分，必须100%来自用户在引导对话中自己说出的原话。 AI 不替用户写理解，不美化，不补全。用户没说的就标"待补充"。
记录：总章节、已完成章节、当前章节、下一章节、最近更新时间。
ah-card 处理本章候选洞见。ah-card。ah-card。ah-card 进行批量转化。STATUS.md 保留明确待办与候选数量。⚠️ 绝对不能自己处理！必须调用 ah-card 技能！
当用户在任何时候说出以下话语：
AI必须：
{{skillsDir}}/ah-card/SKILL.md永久笔记: 字段填写 [[永久笔记标题]][[永久笔记标题]] — 来自章节「章节名」AI绝对不能：
必须更新全局记忆系统！
[AI 内部执行]
1. 读取 {{metaPaths.memory}}/STATUS.md
2. 更新"阅读整理"区域：状态改为"文献笔记已完成"或"待整理卡片笔记"
3. 在"卡片笔记"区域添加新条目（如果有洞见需要制卡）
4. 保存全局状态文件
STATUS.md 回写采用最小格式：
《书名》：整理中 N/M（逐章转卡/全书后转卡）《书名》：待整理卡片笔记（X条，来源：本章/全书）✅ 整理完成！
📄 已生成文件：
- 文献笔记：{{notePaths.literatureNotes}}/《{{书名}}》.md
- 阅读进度：{{metaPaths.memory}}/reading/《{{书名}}》.md
📝 本次整理：
- 处理章节：{{N}} 个
- 提炼洞见：{{M}} 个（其中深度洞见 {{X}} 个）
- 候选转卡：{{Y}} 个
📝 已更新全局状态，下次启动时会提醒你继续处理。
当用户说"今天先到这"：
ah-cardah 入口识别到阅读划线处理需求时调用。assets/extract_weread_outline.py。python3 ".opencode/skills/ah-read/assets/extract_weread_outline.py" headings "<文档路径>"
python3 ".opencode/skills/ah-read/assets/extract_weread_outline.py" ranges "<文档路径>" --chapter-lines "75,1131,1671,2191"
第一章/第二章、第一幕/第二幕、场景一/场景二、1.1/2.3 等模式。<= 5 时，脚本自动输出下一层候选标题，供 AI 二次判断。{{metaPaths.memory}}/reading/《书名》.md。{{notePaths.literatureNotes}}/《书名》.md。ah-card 之前，候选洞见必须已写入阅读进度文件（权威副本）并同步到文献笔记；任一写入失败即停止调用。📄 详细检查清单：
references/检查清单.md
{{metaPaths.memory}}/STATUS.md？ah-card？references/wechat-export-outline-workflow.mdreferences/文献笔记模板.mdreferences/检查清单.mdassets/进度模板.mdassets/extract_weread_outline.pyah-card：将洞见转化为永久笔记（文献笔记完成后调用）ah-think：思维模型工具箱，可在深度思考时调用ah-memory：维护阅读与卡片状态接力ah-review：在每日回顾中接住阅读残留想法批量整理助手。用于集中处理 ah-review 中未处理完或被延期的每日记录，执行批量扫描、去向决策与回写标记，确保残留记录进入清空闭环。
知识库初始化与索引管理。用于首次搭建知识库、迁移旧笔记，或后续维护索引统计，统一完成目录校验、页面初始化、索引生成与状态汇报。
Use when 需要在多个 ah-* 技能之间持续追踪进度、同步待办与避免会话切换后状态丢失时。
Use when 需要在月底做月度复盘，统一处理本月残留记录与“以后再说”缓冲，并产出下月方向与月记时。
Use when 需要在早间创建今日日记，聚合昨日未完成与计划来源，设定今日聚焦并触发周月年回顾提醒时。
Use when 需要启动新项目并自动完成编号检查、项目目录与主页创建，以及领域页项目关联更新时。