---
name: deep-reading
description: '逐步研读材料，与用户深度讨论，积累洞见，产出原创文章并对接 content-pipeline 发布。支持跨 session 保存进度。完整闭环：输入（导入材料）→ 消化（逐段研读+讨论+验证）→ 输出（笔记/汇总/单篇/系列文章）。触发词：研读, 精读, deep read, 一起读, 逐步读, 读这篇, 分析这篇材料, 拆解这篇, 带我读, 读书会, reading session, 继续研读, 恢复研读进度。即使用户只是说"我想认真读一下这个"或"帮我拆解这篇文章"，也应触发此 skill。'
---

# Deep Reading（深度研读）

> 输入 → 消化 → 输出的完整闭环。与用户逐步研读一份材料，边读边讨论边验证，积累洞见，最终产出用户选择的形式。

## Path Convention

1. `SKILL_DIR` = this SKILL.md file's directory
2. `WORKSPACE_DIR` = `~/.ai-workspace/deep-reading`
3. `SESSION_DIR` = `${WORKSPACE_DIR}/sessions/YYYY-MM-DD-<slug>/`

## 核心理念

这不是"AI 帮你总结一篇文章"。这是一个完整的学习过程：

1. **输入**：导入材料，理解结构
2. **消化**：逐段研读，讨论碰撞，调研验证，形成自己的判断
3. **输出**：基于消化过程中积累的洞见，选择合适的产出形式

AI 的角色是**平等讨论伙伴**——有自己的观点，会追问，会让步，会主动推进节奏。

---

## Phase 1: 输入（准备）

### 1.1 材料导入

支持的输入：
- 文件路径（PDF 用 `pdftotext` 提取，其他格式直接读取）
- URL（用 playwright-fetch 或 web_fetch 抓取）
- 用户直接粘贴文本

导入后保存为 `${SESSION_DIR}/source.md`。

### 1.2 结构分析与分段

根据材料结构自动分段：
- 有明确章节标题 → 按章节分
- 无明确结构 → 按 ~1500-2500 字为一段，在自然段落边界切分

生成 `${SESSION_DIR}/segments.json`。

### 1.3 创建 Session

初始化 `${SESSION_DIR}/progress.json`。告知用户材料概况：

```
材料已导入：《XXX》，共 N 段。
[列出各段标题]
我们从第一段开始？
```

---

## Phase 2: 消化（研读循环）

这是核心环节。对每个段落执行以下循环：

### 2.1 AI 推进（主动）

读取当前段落，向用户呈现：

1. **段落概要**（3-5 句）
2. **高价值原文引用**（直接引用原文中最精华的段落/句子，让用户无需翻原文即可获得核心表达）：
   - 选取标准：核心论点的原始表述、精彩的类比/比喻、关键数据的原始语境、有争议的判断原话
   - 每段引用 2-4 处，用 blockquote 格式呈现
   - 如果原文是英文，保留英文原文（不翻译，保持原汁原味），必要时在引用后用一句话点明含义
3. **关键论点/数据**（列出核心主张和支撑证据）
4. **AI 的观点**：
   - 哪些论点有说服力，为什么
   - 哪些地方有漏洞或值得质疑
   - 与其他已知信息的关联或矛盾
5. **讨论邀请**（一个开放性问题）

### 2.2 用户讨论

用户可能：
- 提出观点或质疑 → AI 回应，有来有回
- 追问概念（"什么是 OOM"） → AI 立即解释，不打断节奏
- 要求验证（"这个预测准吗"） → 进入 **验证模式**（见 2.3）
- 表示不想讨论某部分 → 快速跳过，不强求
- 说"继续" → 推进到下一段

**AI 讨论原则：**

| 做 | 不做 |
|----|------|
| 表达明确立场 | 只做中立总结 |
| 引用具体证据 | 空泛地说"有道理" |
| 指出逻辑漏洞 | 无条件赞同作者 |
| 关联外部知识和反例 | 局限在材料本身 |
| 在用户论点更好时让步 | 为了对抗而对抗 |
| 追问模糊表述的深层逻辑 | 轻易放过 |

### 2.3 验证模式（关键增值环节）

当用户要求验证，或 AI 判断某个论点可以用实时数据检验时：

1. **识别可验证的主张**：从材料中提取具体的、可量化的预测或声明
2. **调研**：使用 web_search 搜索最新数据
3. **对照呈现**：

```
## [主张] vs 现实

| 原文预测 | 实际数据 | 判断 |
|----------|----------|------|
| ... | ... | ✅ 准确 / ⚠️ 偏乐观 / ❌ 错误 |
```

4. **形成判断**：基于验证结果，给出 AI 的综合评估
5. **邀请用户判断**：用户可能同意、补充、或有不同看法

验证模式是本 skill 区别于普通"读书总结"的核心价值——不只是读，而是**读了之后去验证**。

### 2.4 记录洞见

每段讨论结束后，提炼用户产生的洞见，追加到 `progress.json` 的 `insights` 数组。洞见来源：
- 用户明确表达的观点
- 讨论碰撞中形成的共识
- 验证后产生的新判断

### 2.5 记录讨论（跨 session 记忆）

每段讨论结束后，将关键对话片段追加到 `${SESSION_DIR}/discussion-log.md`：

```markdown
## 第 N 段：[段落标题]

**用户观点：** [用户说了什么核心观点]

**碰撞过程：** [AI 和用户怎么讨论的，关键转折点]

**结论：** [最终形成的判断]

---
```

记录原则：
- 不是逐字记录，是提炼关键交锋和转折
- 每段 3-8 句话，够恢复上下文即可
- 用户没讨论直接跳过的段落不记录

跨 session 恢复时，AI 先读 `discussion-log.md` 恢复之前的讨论语境，再继续推进。

### 2.6 推进

更新 progress.json，推进到下一段。用户说"今天到这里"时保存进度。

---

## Phase 3: 收敛

所有段落读完（或用户觉得够了）后进入收敛：

### 3.1 洞见汇总

读取所有 insights，呈现给用户：
- 按主题聚类的核心洞见列表
- 哪些是用户独特的观点（vs AI 的分析）
- 哪些有数据验证支撑

### 3.2 产出形式选择

**不预设产出形式**。向用户展示选项：

| 形式 | 说明 | 适合场景 |
|------|------|---------|
| 不产出 | 只消化，不写东西 | 纯学习目的 |
| 读书笔记 | 结构化的要点整理 + 个人批注 | 留档备查 |
| 简要汇总 | 1000 字以内的精华提炼 | 分享给别人"这篇讲了什么" |
| 单篇原创文章 | 基于某个洞见写一篇独立文章 | 有一个特别强的观点想展开 |
| 系列文章 | 多个角度各写一篇 | 洞见丰富，一篇装不下 |

用户选择后进入 Phase 4。如果选"不产出"，更新 progress.json 状态为 `completed`，结束。

### 3.3 角度确认（如果产出文章）

基于洞见，提出可能的文章角度（每个角度一句话核心论点），让用户选择或自定义。

---

## Phase 4: 输出

根据用户选择的产出形式执行：

### 4.1 读书笔记

直接在 session 目录生成 `output-notes.md`：
- 材料元信息
- 逐章要点（AI 概要 + 用户批注/观点）
- 验证结果汇总（如有）
- 个人洞见列表

### 4.2 简要汇总

生成 `output-summary.md`，1000 字以内。

### 4.3 单篇文章 → 对接 content-pipeline

生成 seed 文件（`seed.md`），包含：
- 核心论点（来自用户洞见）
- 支撑素材（原文引用 + 验证数据）
- 切入角度
- 讨论中的关键片段

询问用户是否启动 content-pipeline。

### 4.4 系列文章 → 对接 content-pipeline series-plan

生成 `seed.md`（系列版），包含每篇的：
- 标题方向
- 核心问题
- 关键论点
- 素材来源

询问用户是否启动 content-pipeline 的 series-plan 模式。

---

## 跨 Session 恢复

当用户说"继续研读"或"恢复进度"：

1. 列出 `${WORKSPACE_DIR}/sessions/` 下 `status: in-progress` 的 session
2. 读取 `progress.json`，告知进度
3. 读取 `discussion-log.md`，恢复之前的讨论语境（AI 内部消化，不逐条展示给用户）
4. 告知用户：
   ```
   上次读到第 N 段（共 M 段）。已记录 X 条洞见。
   要从第 N+1 段继续，还是回顾之前的讨论？
   ```
5. 继续 Phase 2

---

## 快捷命令

| 命令 | 效果 |
|------|------|
| "继续" / "下一段" | 推进到下一段 |
| "展开" / "细说" | 对当前段落更深入 |
| "验证一下" / "这个准吗" | 进入验证模式 |
| "原文" | 显示当前段落原文 |
| "进度" | 显示进度和已记录洞见 |
| "暂停" / "今天到这里" | 保存进度 |
| "汇总" | 提前进入 Phase 3 |
| "跳到第 N 段" | 跳转 |
| "不想讨论这个" | 快速跳过当前话题 |

---

## Session 目录结构

```
sessions/2026-05-26-situational-awareness/
├── source.md              # 材料全文
├── segments.json          # 分段索引
├── progress.json          # 进度 + 洞见
├── discussion-log.md      # 讨论记录（跨 session 记忆）
├── seed.md                # 产出的 content seed（如有）
├── output-notes.md        # 读书笔记（如有）
└── output-summary.md      # 简要汇总（如有）
```

---

## Runtime Learning

### Before execution
- Check if `learnings.jsonl` exists in this skill's directory
- If it exists, read the most recent 10 entries and factor relevant lessons into your approach

### After execution
- If you encountered an unexpected problem and successfully resolved it, append ONE entry to `learnings.jsonl`
- If execution was smooth, do not write anything
- Never modify or delete existing entries