Community研究与数据分析github.com

Bhargav8120/PDF转学习笔记 - Claude技能

将PDF(如教科书、讲义幻灯片、技术手册和研究论文)转换为详细、结构清晰的学习笔记,自动提取图表、表格、公式并提供清晰解释。适用于用户上传PDF并要求生成笔记、学习材料或结构化讲解的场景。

PDF转学习笔记 - Claude技能 是什么?

该技能(PDF-to-StudyNotes)专为AI代理(如Claude Code)设计,用于将上传的PDF文档转换为高质量的学习笔记。它支持Markdown和PDF两种输出格式,适用于教科书、技术手册、研究论文等多种文档类型。技能强调源数据忠实性,要求基于PDF原始内容准确提取概念、定义、公式和示例,并自动添加有助于理解的图表(如流程图、架构图、序列图),但避免生成考试准备内容。工作流程包括文档结构分析、详细笔记撰写(按概念、直觉、工作原理等模式组织)、数学公式精确再现(LaTeX)以及质量检查。该技能特别适合需要从复杂PDF中快速提取结构化知识的学习场景,支持分段处理长文档,并在输出中保留页面引用以确保可追溯性。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Bhargav8120/PDF-to-StudyNotes-Claude-Skill/tree/HEAD

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

PDF转学习笔记

将提供的PDF转化为准确、详细、易读的学习笔记。除非用户另有要求,否则同时输出Markdown和经过排版的PDF文件。在能显著提升理解时自动添加图表。除非明确要求,否则不添加备考章节、测验或题库。

核心原则

  1. 源数据忠实性: 将提供的PDF视为主要信息来源。不虚构任何事实、公式、示例、引用、页面引用或缺失的内容。
  2. 覆盖面: 保留文档中的重要概念、定义、假设、步骤、公式、示例、注意事项和关系。不要仅对每页进行摘要。
  3. 清晰性: 先用通俗语言解释概念,然后给出精确的技术表述。在依赖专业术语之前先对其进行定义。
  4. 可追溯性: 在PDF提供可靠页码编号时,为主要结论和章节附加页面引用。当打印页号与PDF查看器索引不同时予以区分。
  5. 视觉推理: 当某个过程、架构、状态转换、层级、数据流、时间线或关系更易于通过图形理解时,自动创建图表。避免装饰性图表。
  6. 无备考内容: 不生成考试问题、预测考题、分值预测或考前突击章节。允许对章节内容进行简明回顾。
  7. 无虚假确定: 如果某页不可读、图形不清晰或提取不完整,则明确标注。

工作流程

1. 检查源文件

  • 识别标题、作者/组织(如有)、主题、文档类型、章节结构以及总页数。
  • 确定PDF是基于文本的、扫描的,还是混合类型。
  • 在相关情况下检查表格、图形、标题、公式、脚注和附录。
  • 如果PDF较长,按逻辑部分进行处理并维护覆盖清单。不要悄悄跳过后面的章节。
  • 对于扫描文档,尽可能使用OCR。对照页面图像验证OCR输出的公式、符号、下标、上标和表格。

2. 构建文档大纲

创建反映源文件结构的层级结构:

  • 文档/章节
  • 主要章节
  • 子章节
  • 概念及支撑细节

保持源文件的术语和顺序,除非重新组织明显有助于学习。如果重新组织,请保留源文件章节/页面的引用。

3. 撰写详细笔记

对于每个有意义的概念,使用此模式的相关部分(不要强制使用空标题):

  • 概念/定义
  • 直观理解: 其含义及存在原因。
  • 工作原理: 有序的步骤或机制。
  • 技术细节: 假设、约束条件、符号表示、边界情况。
  • 示例: 尽可能使用源文件中的示例。如果创建简单的说明性示例,请注明为附加说明。
  • 图表/表格引用: 用文字解释原始图表或表格,并注明其页码。
  • 常见混淆: 仅在源文件或标准、无争议定义支持的情况下澄清区别。

保留重要的技术细节。对于算法,包括输入、输出、步骤、不变量(如果给出或可直接推导),以及仅当已陈述或可安全推导时的复杂度。永远不要编造复杂度声明。

4. 方程与数值材料

  • 使用LaTeX准确再现方程。
  • 解释每个符号、其单位(如有)、假设条件以及该方程的用途。
  • 如果存在推导过程,则逐步保留。
  • 对于示例题,展示给定值、公式、代入过程、中间步骤和结果。
  • 独立检查计算。如果源文件似乎包含错误,则报告源文件陈述并解释可疑问题,而不是悄悄纠正。
  • 不要将有意义的数学符号压平为有歧义的纯文本。

5. 自动图表选择

根据内容选择图表。使用Mermaid绘制可清晰表示为文本的图表;在工具可用时,使用Python生成的SVG/PNG或Matplotlib绘制图形和自定义可视化。

推荐映射:

  • 过程/算法/工作流 → 流程图
  • 系统架构/组件 → 框图或组件图
  • 消息交换/协议 → 序列图
  • 状态/生命周期 → 状态图
  • 分类/分类法 → 树形图或层次图
  • 比较 → 表格,而非不必要的图表
  • 数值趋势/测量数据 → 带标签坐标轴和单位的图表
  • 空间关系 → 仅在源数据支持时使用类似地图的示意图

图表规则:

  • 每个图表必须有标题,并在周围的文字中加以解释。
  • 使用源文件中的实际实体和关系。不要添加PDF不支持的其他组件或因果箭头。
  • 将推断的关系标注为解读。
  • 保持图表清晰易读;将拥挤的图表拆分为较小的图。
  • 如果不能可靠生成图表,则提供Mermaid源码或清晰的文本示意图,而不是假装存在图像。
  • 不要将受版权保护的图形重新绘制为几乎相同的替代品。基于基础概念创建原创的解释性示意图,并引用源文件页码。

6. 解释原始图形和表格

对于每个重要的原始图形/表格:

  • 陈述其目的。
  • 解释坐标轴、符号、图例、行、列以及关键关系。
  • 描述要点,不要夸大图形所证明的内容。
  • 包含源文件页码。
  • 如果无法提取图像,请说明并请求更清晰的源文件,而不是进行猜测。

7. 质量保证

在最终确定之前,检查:

  • 每个主要源文件章节都已覆盖。
  • 重要的定义、方程、图形、示例和注意事项没有遗漏。
  • 技术术语和符号保持一致。
  • 页面引用是合理的,并非捏造。
  • 图表与文字一致。
  • 未添加任何不支持的事实或备考内容。
  • Markdown渲染清晰,PDF导出可读。

输出格式

创建两个交付物:

A. study_notes.md

使用以下结构:

# [文档标题] — 详细学习笔记

> **来源:** [文件名/标题]
> **覆盖范围:** [覆盖的页数或章节]
> **说明:** 这些笔记解释源文件;不确定或不可读的内容已标明。

## 目录
[链接式大纲]

## 1. [主要章节]
### 1.1 [子章节]
[详细解释]

**关键概念:** ...

**方程式:** ...

**图表:** ...
[Mermaid块或嵌入生成的图片]

**来源:** PDF 第 X 页

## ...
## 章节回顾
[主要思想的简明综合,不含考试问题]
## 覆盖范围与限制
[已处理的页面/章节、不可读区域、提取时的注意事项]

根据文档调整结构。不要包含空标题。对于多章节文档,按章节组织。

B. study_notes.pdf

  • 将Markdown渲染成简洁、专业的PDF。
  • 包括标题页、目录(如果可行)、清晰的标题层级、页码、可读字体以及适当大小的图表。
  • 避免内容被裁剪、文字过小、公式损坏以及图表跨页分割不当。
  • 如果无法直接渲染PDF,请提供Markdown文件和一个带清晰标签的HTML文件或转换说明。绝不要声称生成了PDF而实际上并未生成。

交互行为

  • 如果PDF已附加,开始处理它,无需要求用户重复请求。
  • 如果附带了多个PDF文件,仅当不清楚是合并处理还是分别生成笔记时,才提出一个简洁的问题。
  • 如果文档非常长,分批处理,并明确说明哪些已经处理、哪些未处理。
  • 如果用户指定了目标受众或水平,在保持技术准确性的前提下调整解释深度。
  • 如果用户随后要求更短的版本,则从已完成的笔记中推导,而不是凭空从记忆中重新总结。

支持脚本

scripts/ 目录下的脚本是可选的本地工具。在执行环境支持Python及所需包时使用它们。它们不能替代仔细阅读PDF或对扫描页面进行视觉检查。

相关技能