| name | obsidian-ingest |
| description | Обрабатывает произвольный markdown-файл (статья, вебклип, транскрипт, конспект, черновая заметка) и превращает его в структурированные знания для Obsidian-базы по методологии PARA. Скилл выделяет атомарные сущности (концепты, инсайты, факты), придумывает логичные названия заметкам, создаёт литературную заметку-источник, выстраивает wikilinks и frontmatter. Используй этот скилл всегда, когда пользователь хочет «добавить в базу знаний», «переработать статью», «обработать конспект», «выжать знания из текста», «ингестировать», «положить в vault», «положить в базу» или приносит markdown-файл для сохранения в Obsidian.
|
obsidian-ingest — Ингест знаний в Obsidian-vault
Этот скилл — координатор пайплайна ингеста. Твоя задача: взять один markdown-файл, понять,
какие знания в нём скрыты, решить, как их лучше представить в базе, и создать нужные файлы.
Форматирование, frontmatter и обогащение ссылками ты делаешь сам — это неотъемлемая часть ингеста.
Перед началом работы прочитай правила хранилища:
AGENTS.md — общие принципы работы с базой.agents/rules/note-types-frontmatter.md — шаблоны и поля frontmatter.agents/rules/knowledge-structures.md — атомарные заметки, MOC, синтезы.agents/rules/content-style.md — язык, стиль, wikilinks.agents/rules/tags.md — таксономия тегов
Шаг 1. Прочитай и пойми источник
Прочитай входной файл целиком. Определи:
- Тип контента: статья / вебклип, транскрипт, конспект встречи, черновая заметка, произвольный markdown
- Главная тема: одна фраза, о чём этот текст
- Домен: к каким тегам относится (sre, kubernetes, observability, career, concept, и т.д.)
- Уровень достоверности:
medium если источник один, high если ты видишь, что идея многократно подтверждается
Шаг 2. Извлеки сущности (knowledge extraction)
Типы:
- Концепты и модели — абстрактные идеи, фреймворки, паттерны мышления
- Инсайты — нетривиальные выводы, не очевидные из заголовка
- Факты — конкретные утверждения, данные, цифры
- Практики — «как делать», процессы, техники
Критерии атомарности — knowledge-structures.md (раздел «Когда выделять раздел в отдельную заметку»). Типичный результат: 3–8 сущностей из одного источника.
Шаг 3. Придумай названия заметок
Стиль (claim-based, не topic-based) и запрещённые символы — file-naming.md.
Перед именованием — rg -l "<ключевое слово>" по хранилищу. Если похожая заметка есть, план включает обновление существующей, а не создание новой.
Шаг 4. Составь план ингеста
Протокол план → подтверждение → действие — workflows.md. Формат плана:
📄 Литературная заметка: «Название источника» → 03. Ресурсы/03. Литературные заметки/
Тема: ...
📝 Новые атомарные заметки:
1. «Название заметки А» → 03. Ресурсы/04. Заметки/
Суть: одно предложение
2. «Название заметки Б» → 03. Ресурсы/04. Заметки/
Суть: одно предложение
🔄 Обновить существующие заметки:
- [[Существующая заметка]] — добавить источник в sources, уточнить ...
- [[Другая заметка]] — добавить wikilink на литературную заметку
🗺 MOC (если нужен):
- [[MOC по теме]] — добавить новые заметки в список
Если ты хочешь обновить существующую заметку — прочти её содержимое перед правкой и опиши в плане, что именно меняешь. Не перезаписывай молча.
Шаг 5. Создай файлы
После подтверждения плана создавай файлы в следующем порядке:
5а. Литературная заметка
Создай в 03. Ресурсы/03. Литературные заметки/ по шаблону:
---
aliases: []
tags:
- literature-note
up: []
links:
- "URL источника (если есть)"
sources:
- "Название и автор источника"
confidence: medium
---
## О чём
2–3 предложения: что это за текст и зачем его читать.
## Ключевые идеи
- [[Атомарная заметка А]] — одно предложение о чём
- [[Атомарная заметка Б]] — одно предложение о чём
## Цитаты и фрагменты
> Важная цитата или фрагмент, который хочется сохранить дословно
## Вопросы и следующие шаги
- Что осталось непонятным?
- Что стоит изучить дальше?
5б. Атомарные заметки
Для каждой сущности из плана создай заметку в 03. Ресурсы/04. Заметки/:
---
aliases: []
tags:
- thought
up:
- "[[Литературная заметка — источник]]"
links: []
sources:
- "Название источника"
confidence: medium
other: []
---
## Суть
1–3 абзаца своими словами. Не копируй дословно из источника — переформулируй.
Пиши так, чтобы через год было понятно без открытия источника.
## Контекст
Откуда пришла эта идея, в каком контексте она возникла.
## Связанные идеи
- [[Другая заметка]] — почему связана
5в. Обнови существующие заметки
Для каждой заметки из плана:
5г. Обнови wiki-log.md
Добавь запись в _Система/wiki-log.md:
- [[YYYY-MM-DD]] Ингест: «Название источника» → N заметок создано, M обновлено
Шаг 6. Финальный отчёт
После создания файлов дай краткий отчёт:
✅ Создано:
- [[Литературная заметка]]
- [[Заметка А]]
- [[Заметка Б]]
🔄 Обновлено:
- [[Существующая заметка]] — добавлен источник
⚠️ Решения, которые стоит проверить:
- «Заметка В» — я не нашёл похожей в базе, создал новую. Возможно, у тебя уже есть что-то
похожее под другим названием.
- confidence выставил medium — у темы один источник
Правила, которые нельзя нарушать
- Не удаляй исходный файл — пользователь сам решит, что с ним делать
- Не переписывай существующие заметки с нуля — только дополняй
- Не создавай «мёртвые» wikilinks — ссылки только на реально существующие (или только
что созданные) заметки
- Не плоди теги — используй существующую таксономию из
.agents/rules/tags.md
- Не добавляй фронтматтер-поля, которых нет в шаблонах — соблюдай консистентность
- Сохраняй авторский голос: если в источнике живой разговорный текст — не превращай
заметки в сухую документацию
- Поле
sources никогда не очищай — только добавляй новые источники
Справка по размещению заметок в PARA
| Тип | Папка |
|---|
| Литературная заметка (статья, книга, транскрипт) | 03. Ресурсы/03. Литературные заметки/ |
| Атомарная мысль / концепт / инсайт | 03. Ресурсы/04. Заметки/ |
| MOC / карта / синтез | 03. Ресурсы/07. Карты/ |
| Если тема явно связана с проектом | 01. Проекты/[название проекта]/ |
