Obsidian-Ontology Sync

Obsidian-Ontology Sync — это инструмент для автоматической двусторонней синхронизации между Obsidian (системой заметок, удобной для человека) и структурированной онтологией (графом знаний, удобным для машинной обработки).

Быстрый старт

# Тест извлечения (без записи изменений)
python3 skills/obsidian-ontology-sync/scripts/sync.py extract --dry-run --verbose

# Полноценное извлечение
python3 skills/obsidian-ontology-sync/scripts/sync.py extract

# Анализ графа
python3 skills/obsidian-ontology-sync/scripts/sync.py analyze

# Генерация рекомендаций
python3 skills/obsidian-ontology-sync/scripts/sync.py feedback

Что делает система

• Extract (Извлечение) — сканирует заметки Obsidian и извлекает:
  • Сущности (Person, Organization, Project)
  • Связи (works_at, assigned_to и др.)
  • Свойства (email, телефон и т.п.)
• Analyze (Анализ) — предоставляет инсайты:
  • Количество сущностей по типам
  • Статистику связей
  • Проблемы качества данных (например, отсутствующие email или «осиротевшие» сущности)
• Feedback (Обратная связь) — генерирует рекомендации:
  • Какие данные стоит дополнить
  • Инсайты по связям
  • Улучшения шаблонов заметок

Концепция

Философия системы проста:

• Obsidian — основной источник (человек пишет заметки в свободной форме)
• Онтология — производная структура (машина извлекает данные)
• Обратная связь — замыкает цикл, улучшая и заметки, и структуру

Таким образом формируется непрерывный цикл:

Заметки → Извлечение → Граф знаний → Анализ → Рекомендации → Улучшенные заметки

Когда использовать

• После добавления или обновления контактов — извлечь сущности
• Перед аналитическими запросами — синхронизировать данные
• При еженедельном обзоре — провести анализ и получить рекомендации
• При запуске нового проекта — структурировать знания
• Для отслеживания статуса команды — регулярно обновлять граф

Какие данные извлекаются

Контакты

• Сущность Person (имя, email, телефон)
• Связи:
  • works_at → организация
  • met_at → событие
  • assigned_to → проект
• Статус (например: клиент, лид, перспектива)

Клиенты

• Сущность Organization
• Контрактная стоимость
• Связанные проекты
• Основной контакт

Команда

• Сущность Person
• Связи:
  • works_for → организация
  • assigned_to → проекты
  • reports_to → руководитель
• Поведенческие характеристики (например: proactive, reactive)

Ежедневные отчёты

• Время ответа (response_time)
• Обновления статуса
• Блокеры (проблемы)
• Поведенческие паттерны

Проекты

• Сущность Project
• Связи:
  • for_client → организация
  • team → участники
• Статус, ценность, дедлайн

Пример преобразования

Обычная заметка в Obsidian:

# Alice Johnson
Email: alice@company.com
Company: Acme Corp
Met At: Tech Conference 2026
Projects: Project Alpha

Notes: Отличный разработчик, быстро отвечает

Преобразуется в структурированные данные:

{
 "entity": {
 "id": "person_alice_johnson",
 "type": "Person",
 "properties": {
 "name": "Alice Johnson",
 "email": "alice@company.com"
 }
 },
 "relations": [
 {"rel": "works_at", "to": "org_acme"},
 {"rel": "met_at", "to": "event_tech_conference_2026"},
 {"rel": "assigned_to", "to": "project_alpha"}
 ]
}

Автоматическая синхронизация

Рекомендуется настроить регулярный запуск синхронизации, например каждые 3 часа через cron. Это позволит автоматически обновлять граф знаний без ручного вмешательства.

В результате вы получаете систему, где человеческие заметки и машинная структура постоянно усиливают друг друга, создавая живую и развивающуюся базу знаний.