| name | kaoyan-math-notes |
| description | This skill handles note generation and updates for 考研数学 (Chinese graduate entrance math exam) preparation. Use it when users want to generate exam-oriented study notes from existing materials, update notes based on feedback, or create structured learning content with LaTeX formatting. |
| version | 1.1.0 |
考研数学笔记生成更新技能
代码与模板：Python 逻辑见 code.md，笔记模板见 templates/knowledge-point-template.md
技能概述
本技能专注于考研数学笔记的生成和更新，帮助用户：
- 基于现成笔记生成考研学习笔记
- 根据反馈更新笔记
- LaTeX格式强制
- 已有笔记保护机制
核心特色：个性化学习轨迹记录（"我的理解记录"）、错误模式追踪（"我的错误类型"）、与 kaoyan-math-core 集成支持 MemOS 持久化。
触发条件
触发：「生成考研数学笔记」「帮我整理成考研笔记」「更新/补充数学笔记」「这个知识点不太明白」
不触发：查询知识点结构 → kaoyan-math-structure；配置/欠账 → kaoyan-math-core
笔记生成规范
内容生成来源
- 高数资料目录：
/Users/zhqznc/Documents/高数资料/
- 优先级：用户提供的 README.md 内容 → 高数资料 → AI 通用补充
- 定义、定理、例题优先来自高数资料
源笔记优先与必背/速查专项规则 ⚠️
处理用户已有章节笔记、截图、图片或要求更新“必背/速查/自测”类文件时，必须先按源笔记主线抽取，再压缩重排：
- 先读取用户给出的章节笔记、当前笔记来源链接或图片/截图内容，不要先用 AI 另写一套表达。
- 按“源笔记原句/公式/步骤 → 精简压缩 → 必要补充”的顺序处理。
- 如果源笔记或原图已有主方法，必须把该方法放主位；其他方法只能作为“备用方法/补充理解”。
- 必背/速查只保留定义、公式、性质、口诀、易错点、做题步骤、来源链接；长推导和完整例题留在源章节。
- 结构识别型知识不能只剩公式：必须保留最小识别模板、做题启动步骤和必要图示/读图结论。
- 源笔记缺少模板、启动步骤或图示时可以补充，但补充内容必须与源笔记主线一致。
Markdown/LaTeX 写入验证清单 ⚠️
- 写入含 LaTeX、反斜杠、代码块或表格的 Markdown 时，优先使用 Python raw string、占位符替换或
chr(92) 生成反斜杠。
- 提取含中文括号、引号或特殊符号的标题/段落时，优先用 Python 读取文件并按标题边界定位，不用脆弱 shell 引号拼接。
- 写入后扫描控制字符：
bad = [(i, b) for i, b in enumerate(path.read_bytes()) if b < 32 and b not in (9, 10, 13)]
assert not bad
- 回读目标段落，重点检查
\\begin、\\boxed、\\theta、\\lambda、\\rvert、cases 换行符和表格中的 LaTeX 管道符。
- 若发现转义污染，先修复并重新扫描。
已有笔记保护机制 ⚠️
- 生成前检查目标路径是否已有笔记文件
- 不下覆盖已有内容
- 只为缺失知识点创建新文件
- 告知用户哪些已存在、哪些将新建
def check_existing_notes(target_path, knowledge_points):
existing, to_create = [], []
for kp in knowledge_points:
file_path = f"{target_path}/{kp}.md"
(existing if os.path.exists(file_path) and has_content(file_path) else to_create).append(kp)
return {"existing": existing, "to_create": to_create}
数学公式格式标准 ⚠️
所有数学公式使用 LaTeX：行内 $...$，独立公式 $$...$$。常用符号映射见 code.md。
核心功能
功能1：基于现成笔记生成考研学习笔记
输入：用户笔记 + 模块信息（高数/线代 + 章节）→ 输出：结构化 Obsidian 笔记（含考试重点、题型、易错点、例题）
功能2：根据反馈更新笔记
输入：已有笔记路径 + 用户反馈（理解困难点、希望补充的内容）
→ 分析理解障碍 → 优化表达 → 添加辅助内容 → 标注易错点 → 记录思维过程
输出格式
笔记按 templates/knowledge-point-template.md 生成，包含：原始定义、直观理解、定理条件、考试重点、典型题型、解题方法、易错点、我的理解记录、错误类型、例题、相关知识点。
更新标记
<!-- UPDATE: YYYY-MM-DD 用户反馈不理解XX -->
[补充内容]
<!-- END UPDATE -->
文件组织
考研数学/{模块}/
├── 📑 索引.md
├── 📊 学习进度.md
└── {章节}/ — 按知识点分文件
完整目录结构见 kaoyan-math-structure。
技能集成
| 技能 | 用途 |
|---|
| kaoyan-math-core | 错误记录、个性化提醒 |
| kaoyan-math-structure | 知识点结构、目录模板 |
| obsidian-markdown | 创建 Obsidian 笔记 |
创建日期: 2026-03-10
版本: 1.1.0 (模板提取到 templates/, 2026-07-12)
