# Note Organizer

> Organizes lecture notes, study notes, and transcribed recordings into clean Markdown files. Trigger immediately when the user says things like "help me organize my notes", "clean up this lecture transcript", "turn this recording into notes", or "organize my study notes". Also trigger proactively when the user uploads a .docx / .md / .txt file or pastes a large block of text. Core workflow: denoise → extract knowledge points → structure → output .md file.

- Skill: `fd0415/note-organizer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add fd0415/note-organizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fd0415/note-organizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: fd0415 (https://skillmd.com/u/fd0415)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/fd0415/note-organizer

---


# 笔记整理 Skill

## 核心原则

你的任务是**忠实地整理**，而非创作或扩写。所有输出内容必须可以在原文中找到对应依据。读者看到整理结果时，不应该发现任何原文中没有的信息。

---

## Step 1：接收输入

接受以下格式：
- 上传的文件：`.docx` / `.md` / `.txt`（用 `Read` 或 `Bash` 工具读取内容）
- 直接粘贴的长文本：直接处理
- 多份文件：按用户提供的顺序逐份处理，最终合并为一份笔记

**分段预警**：开始处理前，粗略估算原文字数。若原文超过 8000 字，主动告知用户：
> "本次内容较多，预计输出量较大，建议分 X 段处理，是否先处理第一段？"

等用户确认后再继续。

---

## Step 2：去噪处理

扫描全文，静默过滤以下内容（不进入笔记，也不解释原因）：

- **口语填充词**："嗯"、"啊"、"那个"、"然后那个"、"就是说"、"对吧"、"你知道吗"、"怎么说呢"等
- **重复表述**：同一意思被反复陈述时，仅保留措辞最完整、最清晰的那次，其余舍弃
- **课堂管理性话语**：点名签到、课间休息提醒、闲聊寒暄、"好我们开始上课"、"下课了"类提示
- **语音识别乱码**：明显不成句、无法理解的片段（如"奥斯曼 TK 呢个就是那个额额"）

---

## Step 3：知识点抽离

以**原文的逻辑段落**为单位扫描，判断每段是否包含以下任意一类内容：

| 类型 | 示例特征 |
|------|---------|
| 定义 / 概念 | "X 是指……"、"所谓 Y……" |
| 原理 / 机制 | "其原因在于……"、"之所以……是因为……" |
| 步骤 / 流程 | "第一步……第二步……"、"首先……然后……" |
| 公式 / 数据 | 数字、计算式、比例、实验数值 |
| 结论 / 观点 | "因此……"、"总的来说……"、"研究表明……" |
| 对比关系 | "A 与 B 的区别在于……"、"相比之下……" |
| 列举项目 | "包括以下几点：……" |

- **若包含**：保留原有措辞，仅做最低限度的标点和断句整理，不改动实质内容
- **若不包含**：直接跳过，不记录，不写"此段略"之类的提示

---

## Step 4：结构组织

按以下层级整理，层级标题优先来源于原文中出现的章节名、主题词、板书标题；若原文无明确分段，则按内容主题自然归并：

```
# 课程笔记
## 一级主题（来自原文章节/板书）
### 子主题（来自原文小节或自然归并的主题）
正文段落（知识点内容）
```

多份文件合并时，若各文件主题不同，各自保留一个二级标题作为区隔；若主题相同（如同一门课的两节课），合并入统一结构。

---

## Step 5：输出

将整理结果**保存为 `.md` 文件**，文件名格式：`课程笔记_[主题或日期].md`（若原文无明确信息则用"课程笔记.md"）。

格式要求：
- 顶级标题：`# 课程笔记`
- 正文使用 H2 / H3 及正文段落，不使用 H4 及以下
- 不添加页眉、页脚、分割线装饰，保持简洁
- 代码、公式用合适的 Markdown 语法包裹

完成后，将文件路径告知用户，并简短说明：共处理了多少字原文、生成了多少字笔记（方便用户感知压缩比）。

---

## 约束清单（做完后自查）

- [ ] 所有知识点均可在原文中找到对应段落
- [ ] 未添加任何原文中没有的解释、例子或背景
- [ ] 未对原文观点进行抽象化概括或主观提炼
- [ ] 过滤掉了口语填充词和课堂管理话语
- [ ] 重复内容只保留了最完整的一次
- [ ] 输出文件为 `.md` 格式，已保存到磁盘