math-notes

install
source · Clone the upstream repo
git clone https://github.com/koftamainee/Lectures
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/koftamainee/Lectures "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude" ~/.claude/skills/koftamainee-lectures-math-notes && rm -rf "$T"
manifest: .claude/math_notes_skill.md
source content

Math Notes Skill

Скилл для создания академических конспектов по математике из фото/PDF лекций. Выходной формат — Markdown, совместимый с Obsidian.


Необходимые плагины Obsidian

Перед началом работы убедись, что у пользователя установлены нужные плагины (упомяни их при первом создании конспекта):

ПлагинЗачем
Obsidian LaTeX SuiteБыстрый ввод формул, сниппеты
MathJax (встроен)Рендер
$...$
и
$$...$$
Mermaid (встроен)Диаграммы, графы, блок-схемы
Admonition или встроенные CalloutsБлоки «Определение», «Теорема», «Замечание»
DataviewНавигация, индексы, поиск по тегам
TemplaterШаблоны для новых конспектов

TikZ в Obsidian нативно не поддерживается. Используй Mermaid для схем и графов, а сложные геометрические рисунки описывай текстом или через плагин Excalidraw.


Процесс создания конспекта

1. Чтение исходника

  • Если получено изображение — внимательно распознай весь текст, формулы, схемы.
  • Если получен PDF — прочитай все страницы полностью.
  • Зафиксируй: тему лекции, список определений, теорем, примеров, алгоритмов.

2. Запрос списка существующих заметок

Перед созданием файлов проверь, приложил ли пользователь список уже существующих заметок.

  • Если список есть — используй точные названия из него для wikilinks.
  • Если списка нетобязательно напомни: «Пришли список своих заметок — я проставлю wikilinks на уже существующие файлы. Пока продолжу без него, ссылки могут не совпасть с реальными именами файлов.» — и продолжай работу.

3. Разбивка на отдельные заметки

Всегда анализируй лекцию на наличие нескольких тем перед созданием файлов.

Признаки смены темы в записях:

  • Новый заголовок или крупная надпись
  • Смена обозначений / предметной области
  • Фраза типа «Теперь рассмотрим...», «Перейдём к...», «Новая тема:»
  • Явный тематический разрыв

Если тем несколько:

  1. Составь список тем: [Тема А, Тема Б, Тема В]
  2. Создай отдельный
    .md
    файл для каждой темы
  3. Создай index-файл лекции, который связывает все темы
  4. Во всех файлах проставь взаимные wikilinks

Если тема одна — index-файл не нужен, создаётся один

.md
.

Структура index-файла лекции:

---
title: "Лекция — <краткое описание>"
date: <YYYY-MM-DD>
tags: [математика, <предмет>, индекс]
---

# Лекция: <краткое описание>

1. [[Тема А]] — краткое описание
2. [[Тема Б]] — краткое описание
3. [[Тема В]] — краткое описание

4. Структура файла

Каждый конспект строится по следующему шаблону:

---
title: "<Название темы>"
date: <YYYY-MM-DD>
tags: [математика, <предмет>, <тема>]
aliases: ["<альтернативное название>"]
---

# <Название темы>

## Связанные темы
[[Тема 1]] | [[Тема 2]] | [[Тема 3]]

---

## Основные понятия

> [!definition] Определение: <Название>
> Формальное определение...

> [!theorem] Теорема: <Название>
> Формулировка теоремы...

> [!proof]- Доказательство
> Шаги доказательства...

## Алгоритмы / Методы

### <Название метода>

**Шаги:**
1. ...
2. ...

## Примеры

> [!example] Пример 1: <Краткое описание>
> **Условие:** ...
>
> **Решение:** ...
>
> **Ответ:** $...$

## Замечания

> [!tip] Подсказка
> ...

> [!warning] Частая ошибка
> ...

---

## Итог

Краткое summary темы в 3–5 предложениях.

---
*Источник: лекция от <дата>*

Именование файлов

  • Имя файла = название темы с пробелами, без даты:
    Формула Байеса.md
  • Это обеспечивает корректные wikilinks вида
    [[Формула Байеса]]
    без лишних символов
  • Index-файл:
    Лекция — <краткое описание>.md
  • Не используй даты, подчёркивания или дефисы вместо пробелов в именах файлов

Правила оформления формул

  • Инлайн:
    $выражение$
    — внутри текста
  • Блочные:
    $$выражение$$
    — для важных формул и теорем
  • Нумерованные:
    \tag{1}
    внутри
    $$...$$
  • Системы:
    \begin{cases}...\end{cases}
  • Матрицы:
    \begin{pmatrix}...\end{pmatrix}

Не используй Unicode α β ∑ в формулах — только LaTeX внутри

$...$
. Unicode допустим только в обычном тексте.


Callout-блоки

ТипКогда использовать
[!definition]
Определения понятий
[!theorem]
Формулировки теорем и лемм
[!proof]-
Доказательства (сворачиваемые)
[!example]
Разобранные примеры
[!algorithm]
Алгоритмы и процедуры
[!tip]
Мнемоники, лайфхаки, подсказки
[!warning]
Типичные ошибки, ловушки
[!note]
Дополнительные замечания
[!summary]
Итоги раздела

Mermaid-диаграммы

Используй когда в лекции есть граф зависимостей, блок-схема алгоритма, дерево рекурсии или диаграмма переходов.

Для числовых графиков функций добавляй замечание:

[!note] График Для интерактивного графика используй плагин Desmos или GeoGebra в Obsidian.


Wikilinks и навигация

  • В начале каждого файла — блок «Связанные темы» с
    [[wikilinks]]
  • Внутри текста — ссылай на термины при первом упоминании:
    [[Предел последовательности|предел]]
  • Если есть список существующих заметок — сверяй имена wikilinks с ним точно
  • В конце — ссылки вперёд: что изучается следующим

Обработка нечётких и проблемных мест

При обнаружении любой неясности — сразу делай два действия:

  1. Помечай место в
    .md
    файле специальным комментарием
  2. Сообщай об этом в диалог — пользователь поможет разобраться

Типы пометок в файле:

СитуацияПометка
Нечитаемый фрагмент
<!-- НРЗБ -->
Формула под вопросом
<!-- ? возможно: $...$ -->
Пропущен шаг
<!-- ПРОПУСК -->
Возможная ошибка преподавателя
> [!warning] Возможная опечатка в лекции
Термин не распознан
<!-- ТЕРМИН: ? -->

Формат сообщения в диалог:

⚠️ Нашёл несколько мест, где нужна твоя помощь:

1. [Формула Байеса.md] — знаменатель в формуле P(A|B) нечётко написан,
   поставил <!-- ? --> — проверь, правильно ли распознал.

2. [Условная вероятность.md] — в доказательстве теоремы пропущен шаг,
   отметил <!-- ПРОПУСК -->.

Финальные шаги

  1. Определи количество тем → создай нужное число файлов (+ index если тем > 1)
  2. Имена файлов — с пробелами, без дат:
    Условная вероятность.md
  3. Предоставь все файлы через
    present_files
    (сначала index, потом темы)
  4. Сообщи в диалог:
    • сколько тем и как разбиты по файлам
    • сколько определений / теорем / примеров распознано
    • список всех нечётких мест с указанием файла