笔记整理Skill

三天后考试，课件还没看，PDF 还没翻，笔记散得像案发现场？把资料文件夹交给它，它会先理清章节、题目和重点，再整理成一套能直接打开复习的 Markdown 笔记。

English version: README.en.md

当前仅支持在 Claude Code 中安装和使用。

---

安装

先安装文档 skills，再安装本 skill 和环境。

1. 安装 Claude 官方文档 skills

笔记整理需要读取 PDF、Word 和 PowerPoint 资料。先安装 Anthropic 官方 document-skills，其中包含 pdf、docx、pptx 和 xlsx。¹

在 Claude Code 中先添加官方 skills marketplace：

/plugin marketplace add anthropics/skills

然后安装文档 skills：

/plugin install document-skills@anthropic-agent-skills

2. 安装笔记整理与环境

还需安装附加 skills：humanizer、markdown-mermaid-writing。下面的脚本会一起安装。

把本仓库放入 Claude 的 skills 目录：

git clone https://github.com/Renakoni/note-organizer.git ~/.claude/skills/note-organizer
cd ~/.claude/skills/note-organizer
bash tools/install-environment.sh

也可以手动复制目录，最终结构应类似：

~/.claude/skills/note-organizer/
├─ SKILL.md
├─ README.md
├─ requirements.txt
├─ references/
├─ scripts/
└─ tools/

安装完成后，重启 Claude Code 或开启一个新会话。

快速使用

把资料放进一个文件夹，然后显式调用 skill：

/note-organizer
资料都在 ./material，帮我整理成一套复习笔记。

也可以说得更具体：

/note-organizer
这个文件夹里有老师 PPT、教材摘录、我的课堂笔记和几份历年题。请整理成 Markdown 笔记库，题目和自建题要分开。

也可以不写 slash command，直接说“帮我整理笔记”或“帮我整理复习资料”。Claude 会在合适时自动调用这个 skill。

Claude 会先扫描资料、识别已有题目、推断章节和资料角色，然后给出一次结构确认。确认后，它会继续分批生成笔记。

如果已经有整理过的笔记库，也可以让它继续维护：

/note-organizer
这是上次整理到一半的课程笔记库，请先检查进度和资料缺口，然后继续整理。

项目简介

笔记整理是一个 Claude Skill，用来处理那种“资料都有，但不知道从哪里开始看”的学习场景。老师课件、教材摘录、PDF、Word 文档、PPT、个人课堂笔记、学长学姐资料、课后习题、历年试题和题库，都可以一起交给它整理。

它不会把所有资料压成一篇长总结。它会先梳理资料来源，再推断章节结构，提取已有题目，建立索引，然后按章节生成可以继续维护的 Markdown 笔记。

推荐用 Obsidian 打开整理后的文件夹。生成的笔记是普通 Markdown 文件，里面会带有 [[双链]]，适合在 Obsidian 里继续复习、补充和跳转。你也可以用 VS Code、GitHub 或其他 Markdown 工具查看。

推荐工作流

1. 把资料放进同一个文件夹。
2. 尽量保留有意义的文件名，例如 teacher_ppt、user_note、historical_exam、source_question。
3. 让 Claude 先扫描资料、提取已有题目、推断章节，并规划输出结构。
4. 检查章节结构和资料角色有没有明显错误。
5. 让 Claude 分批生成章节笔记、题目解析和补强记录。
6. 新增资料时，让 Claude 先更新 .course_index/，再只改受影响的章节和全局文件。
7. 最后查看 00_资料缺口与待确认.md 和 00_题目覆盖与笔记补强.md，并做一次笔记库一致性检查。

适合哪些场景

• 期末考试复习
• 考研、资格考试或专业课复习
• 把老师课件和教材整理成章节笔记
• 用题库、课后习题或历年题反查知识点覆盖情况
• 整理较长课程，并且希望能分批推进、断点续跑
• 把已有 Markdown 或 Obsidian 笔记补成完整的复习系统
• 给已有笔记库追加新课件、新题目或课堂补充，并检查受影响章节
• 为文学、历史、法学、医学、工科、计算机等不同学科建立合适的笔记结构

它会生成什么

一次完整整理通常会生成一个清晰分层的输出目录：

课程整理输出/
├─ 期末复习/        # 最终 Markdown/Obsidian 笔记库
├─ _extracted/      # 提取文本和 OCR sidecar
├─ .course_index/   # 索引、进度和检查状态
└─ _working/        # 临时章节包和脚本中间输出

期末复习/ 里通常包含：

• 00_总目录.md
• 00_项目状态.md
• 00_资料索引.md
• 00_章节进度表.md
• 00_术语索引.md
• 00_已有题目索引.md
• 00_题目覆盖与笔记补强.md
• 00_资料缺口与待确认.md
• 00_检索日志.md
• 00_全书知识关系与复习路线.md
• 00_考前速记与最后冲刺.md
• 00_来源题逐题解析.md
• 00_自建题库.md
• 每章的章节总览、核心概念、知识框架、易混淆点、典型考法和自测题
• 稳定概念的 Obsidian [[双链]]

实际文件会根据资料情况调整。没有已有题目时，不会强行生成来源题解析；使用外部资料时，会额外生成或更新外部资料标记。

核心特点

题目优先

Skill 会在第一轮扫描里提取已有题目，包括课后习题、复习题、思考题、历年题、考试题、作业题和题库。这样整理出来的笔记不是泛泛概括，而是被真实题目牵引。

来源分级

老师课件、教材、课堂笔记、题库、学长学姐资料和外部资料会分开处理。考试相关表述优先以老师课件、教材和课堂笔记为准。

题目覆盖检查

整理完章节后，Skill 会根据已有题目检查笔记是否覆盖到位。缺口会写入 00_题目覆盖与笔记补强.md 或 00_资料缺口与待确认.md，方便后续补强。

适配不同学科

不同学科不应该套同一种模板。理工科可以使用公式模型流程，文学史可以使用时间线与脉络，法学可以使用规则条文与适用条件，案例型课程可以使用案例机制与处理流程。

本地轻量索引

对于整门课程或资料文件夹，Skill 会建立 .course_index/ 课程索引，用来记录文件、章节、题目、术语和处理进度。索引支持 manifest 增量检测、无变化快速返回、--status 状态解释和 health.json 健康提示。默认使用可审计的关键词/正则检索和章节包。

可以直接检查索引状态：

python scripts/index_status.py path/to/课程整理输出/.course_index --input-dir path/to/课程整理输出/_extracted

PDF 与 OCR 预检

重要 PDF 如果被报告为“加密”“空文本”或“无法读取”，Skill 会先做提取质量判断，不会只凭一次解析失败就放弃。pdf_probe.py 会检查文本层、页级文本密度和不同解析器的加密信号：

python scripts/pdf_probe.py path/to/material
python scripts/pdf_probe.py path/to/file.pdf --pages 20

扫描版或图片型 PDF 应先生成 OCR 文本 sidecar，再进入 .course_index/。公式、图表、流程图和截图会保留 提取存疑 或 待核验 标记，避免 OCR 碎片被写成确定知识点。

笔记库一致性检查

整理完成或追加资料后，可以检查全局文件、双链、占位符、来源题覆盖和索引健康状态：

python scripts/validate_vault.py path/to/课程整理输出/期末复习 --index-dir path/to/课程整理输出/.course_index

外部资料有边界

如果本地资料缺失，Skill 可以在最后阶段补充外部资料。外部资料会单独标记，不会覆盖老师课件、教材和课堂笔记。

注意事项

• 扫描版 PDF、图片型 PDF、公式截图或排版复杂的 PPT 可能提取不完整。重要文件应先运行 pdf_probe.py 或生成 OCR sidecar，再进入正式整理。
• 有些 PDF 工具会把带权限标记、空用户密码、损坏对象或不兼容结构的 PDF 误报为加密；不要只凭一次报错判断资料不可读。
• coverage_check.py 是保守的本地支持度检查，不是最终判卷器。
• index_status.py 和 validate_vault.py 是一致性检查工具；有警告时应修正明确问题，或在最终报告里说明哪些检查被延后。
• 外部资料只用于补充理解，考试表述仍应以本地课程资料为准。
• 大量写入 Markdown 文件时，建议在前台运行 Claude，以便及时批准文件写入。

适合与不适合

适合：

• 课程资料整理
• 考试复习
• 题库驱动的知识点补强
• Markdown 或 Obsidian 笔记库建设
• 长课程的分批整理

不适合：

• 只想简单问一个 PDF 里的事实
• 完全自动替代人工核对公式、图表和扫描件
• 把外部搜索结果当作课程唯一依据
• 需要完整研究知识库平台

许可证与依赖说明

本项目使用 MIT License，详见 LICENSE。

本 skill 不复制、修改或再分发 pdf、docx、pptx 等文档处理 skills。请按这些 skills 各自的来源和许可单独安装。

Footnotes

1. Anthropic. anthropics/skills: Public repository for Agent Skills. https://github.com/anthropics/skills ↩