obsidian-refactor-lecture

name

obsidian-refactor-lecture

description

Рефакторинг конспектов лекций в Obsidian — извлечение концептов, определений и теорем из конспекта в отдельные заметки, превращение лекции в "оглавление" со ссылками, обновление связей с дисциплинарным MOC. Используй этот скилл когда пользователь просит обработать, разбить, рефакторить конспект лекции или несколько лекций. Триггеры: "обработай лекцию", "разбей конспект", "рефакторинг лекции", "вынеси понятия из лекции", "обработай конспект", "разбей лекцию", "лекция слишком большая". Скилл обрабатывает до 3 конспектов за один запуск.

Обзор

Скилл превращает большой конспект лекции в структурированный граф знаний:

• оригинальная лекция становится "оглавлением" — разделы заменяются кратким резюме + [[wikilink]];
• извлечённые концепты создаются как отдельные заметки с именем <Дисциплина> – <Концепт>.md;
• дисциплинарный MOC обновляется ссылками на новые заметки.

Лимит: не более 3 конспектов за один запуск. Если пользователь указал больше — спроси, какие три обработать сейчас, остальные — следующим запуском.

---

Базовые правила

Структура хранилища, таксономия тегов, frontmatter, имена файлов — в .agents/rules/: vault-struct.md, tags.md (раздел «Структурные теги»), note-types-frontmatter.md, file-naming.md.

---

Формат конспекта лекции

Файл лекции следует паттерну Lecture – <Дисциплина> – <Дата> – <Тема>.md и содержит:

---
aliases: [...]
tags:
  - lecture
discipline: "[[<Дисциплина>]]"   # ссылка на дисциплинарный MOC в 02. Сферы/04. Образование/МТИ/Предметы/
up:
  - "[[<Дисциплина>]]"
down:
  - "[[...]]"                   # заметки, уже выделенные из этой лекции
links: []
other: []
date: "[[YYYY-MM-DD]]"
---

---

Алгоритм обработки

Шаг 1. Прочитай и определи кандидатов

Критерии «выделять / оставить» — knowledge-structures.md (раздел «Когда выделять раздел в отдельную заметку»). Особенность лекций: Q&A-блоки оставляй в лекции как есть; выноси только если ответ — развёрнутый концепт ≥10 строк.

Шаг 2. Составь план и покажи пользователю

Протокол план → подтверждение → действие — workflows.md. Формат:

Лекция: [[Lecture – ВышМат – 2025-11-20 – Алгебра матриц]]
Дисциплина: [[ВышМат]]

Извлечь в 03. Ресурсы/04. Заметки/ (атомарные факты):
  1. [[ВышМат – Транспонированная матрица]] → #thought + #lecture
  2. [[ВышМат – Определитель матрицы]] → #thought + #lecture

Извлечь в 00. Входящие/ (требуют дальнейшей обработки):
  3. [[ВышМат – Операции над матрицами]] → сводная концептуальная заметка
  4. [[ВышМат – Обратная матрица]] → требует связей с другими темами

Оставить в лекции (не атомарны / слишком контекстуальны):
  - Вводный абзац о применении матриц

Спроси подтверждение, если пользователь не сказал "делай сразу" или аналогичное.

Шаг 3. Логика выбора папки для извлечённой заметки

Куда	Тег	Когда
03. Ресурсы/04. Заметки/	#thought + #lecture	Самодостаточный факт: определение, теорема, формула с доказательством. Заметка уже "готова".
00. Входящие/	#inbox/review + #lecture	Концептуальная тема, требующая связей. Всё, что вызывает сомнения.

По умолчанию — inbox, если не очевидно.

Шаг 4. Создай извлечённые заметки

Для каждого выделенного раздела:

1. Имя файла: <Дисциплина> – <Концепт>.md

   • Дисциплина берётся из поля discipline лекции (без [[ ]])
   • Пример: ВышМат – Транспонированная матрица.md, ПиАС ИБ – Многофакторная аутентификация.md

2. Проверь, не существует ли уже такая заметка (grep по хранилищу). Если существует — не создавай дубликат, только обнови ссылки.

3. Frontmatter новой заметки:

---
aliases:
  - Транспонированная матрица      # Название концепта
  - Transposed Matrix               # Английский эквивалент (если применимо)
tags:
  - thought                         # для 03. Ресурсы/04. Заметки/
  - lecture
  # для 00. Входящие/ — добавь #inbox/review вместо thought
discipline: "[[ВышМат]]"           # копируется из лекции
up:
  - "[[Lecture – ВышМат – 2025-11-20 – Алгебра матриц]]"  # родительская лекция
down: []
links: []
other: []
date: "[[2025-11-20]]"             # дата лекции
---

1. Тело заметки: используй заголовок ## Определение / ## Суть / ## Теорема в зависимости от типа контента. Перенеси содержимое раздела дословно, включая LaTeX-формулы.

Шаг 5. Обнови оригинальную лекцию

1. Каждый вынесенный раздел заменяется на краткое (1-2 предложения) резюме + ссылку:

### Транспонированная матрица

Матрица $A^T$, полученная заменой строк на столбцы. Свойства и примеры: [[ВышМат – Транспонированная матрица]]

1. В frontmatter лекции обнови down — добавь wikilinks на все новые заметки.

2. Если в down уже есть ссылки на несуществующие файлы (плейсхолдеры) — замени их ссылками на только что созданные файлы.

Шаг 6. Обнови дисциплинарный MOC

Найди файл дисциплины (02. Сферы/04. Образование/МТИ/Предметы/<Дисциплина>.md).

Добавь ссылки на новые заметки в соответствующий список. Если в MOC есть Dataview-блок, который автоматически подхватывает связи — ничего делать не нужно, связи появятся сами через поле discipline в новых заметках.

Как понять, нужно ли вручную добавлять ссылки: прочитай MOC — если там Dataview (FROM ... AND #discipline), то не добавляй вручную. Если ручной список — добавь.

Шаг 7. Проверь связность

• Все новые файлы созданы в правильных папках.
• Frontmatter каждой новой заметки заполнен (tags, aliases, discipline, up, down, date).
• Оригинал обновлён: каждый вынесенный раздел → краткое резюме + wikilink.
• down оригинала содержит wikilinks на все новые заметки.
• Нет дублирующих заметок (grep перед созданием).
• LaTeX-формулы сохранены дословно (не упрощены и не переписаны).
• Дисциплинарный MOC проверен.

---

Что НЕ делать

• Не удалять оригинальную лекцию и не переносить её в архив.
• Не переписывать содержимое при извлечении — только переносить дословно.
• Не изменять LaTeX-формулы.
• Не дробить слишком мелко — раздел из 2-3 строк не заслуживает отдельного файла.
• Не обрабатывать больше 3 лекций за один запуск.
• Не создавать дубликаты — всегда grep-проверка перед созданием.

---

Примеры трансформации

До (в лекции):

### Транспонированная матрица

Транспонированная матрица — это матрица, полученная из исходной путём замены строк на столбцы...
[100 строк текста + LaTeX]

После (в лекции):

### Транспонированная матрица

Матрица $A^T$, где строки и столбцы поменяны местами; $(A^T)_{ij} = A_{ji}$. Подробнее: [[ВышМат – Транспонированная матрица]]

Новый файл ВышМат – Транспонированная матрица.md в 03. Ресурсы/04. Заметки/:

---
aliases:
  - Транспонированная матрица
  - Transposed Matrix
tags:
  - thought
  - lecture
discipline: "[[ВышМат]]"
up:
  - "[[Lecture – ВышМат – 2025-11-20 – Алгебра матриц]]"
down: []
links: []
other: []
date: "[[2025-11-20]]"
---

## Определение

Транспонированная матрица — это матрица, полученная из исходной путём замены строк на столбцы...
[полный контент из лекции]