ex-USSR Kinship Research — генеалогический навык для ИИ-агентов

ex-USSR Kinship Research — открытый навык для Codex, Claude Code и других совместимых ИИ-агентов. Он помогает исследовать семейную историю на территории бывшего СССР, Советского Союза и Российской империи: находить документы, проверять, к кому они относятся, и связывать каждое утверждение с источником. Это не готовая база родословных и не автоматическое подтверждение родства: агент организует поиск, а выводы должны опираться на документы.

Официальный репозиторий: ex-USSR Kinship Research на GitHub

Для каких генеалогических задач создан навык

Навык охватывает метрические книги, записи органов гражданского состояния, военные документы, материалы о миграции, депортациях и репрессиях, а также архивные сканы, которые могут не находиться обычным поиском. География включает 15 бывших союзных республик. Для каждого события учитываются границы и административное устройство на соответствующую дату: место могло относиться к другой губернии, государству или архиву, чем сегодня.

Поиск учитывает язык и варианты имени

Одна и та же фамилия могла записываться по-разному — из-за смены алфавита, языка документа, дореформенной орфографии или транслитерации. Навык помогает составлять варианты имён и поисковые запросы на языке конкретного источника, в том числе на русском, украинском, польском, румынском, немецком и идише. Агент отвечает на языке пользователя, а оригинальное написание в документе сохраняет рядом с переводом, если тот нужен.

Как организовано исследование

Факты отделяются от предположений

Для дела создаются связанные реестры людей, документов, утверждений и родственных связей, а также журнал уже выполненных поисков. Запись в архиве считается отдельным артефактом: сначала фиксируется, что именно в ней видно, затем — как это можно интерпретировать. Такой подход помогает не превратить похожее имя или семейное предание в доказанный факт.

У каждого вывода есть понятный статус: гипотеза, подтверждение одним источником, независимое подтверждение несколькими источниками, противоречие или недостаток данных. Копии одной записи и её зеркала не считаются независимыми подтверждениями. Проект отдельно запрещает объединять однофамильцев только по совпадению имени, возраста или населённого пункта.

Родство проверяется по цепочке

Если требуется подтвердить связь между дальними поколениями, каждое звено рассматривается отдельно. Для различения людей могут понадобиться даты и места событий, родители, супруги, восприемники, адрес или воинская часть. Совпадение фамилии, запись в пользовательском дереве или один ДНК-результат сами по себе не устанавливают биологическое родство.

Источники и дополнительные сценарии

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

Работа с индексами и документами военного времени

Среди описанных сценариев — целевой поиск по доступным индексам FamilySearch в рамках существующей законной сессии и поиск записей о Первой мировой войне с последующим переходом к изображению источника. Доступность зависит от конкретной коллекции, региона и условий самого архива или сервиса. Навык не обещает, что любой документ удастся открыть или что поиск даст результат.

Реестр можно проверить скриптом

В комплекте есть Python-скрипты для создания дела, расчёта SHA-256 сохранённых материалов и проверки ссылок между реестрами и итоговым отчётом. Это помогает заметить отсутствующие документы, неподтверждённые связи и ошибки в ссылках на доказательства. Отчёт можно собрать в PDF; для этого отдельному скрипту понадобится браузер на базе Chromium.

Установка в Codex и Claude Code

Это набор инструкций и вспомогательных скриптов, который устанавливается в папку навыков выбранного агента. Для личной установки автор предлагает клонировать репозиторий в соответствующую директорию:

# Codex
git clone https://github.com/DenisSergeevitch/ex-ussr-kinship-research ~/.codex/skills/ex-ussr-kinship-research

# Claude Code
git clone https://github.com/DenisSergeevitch/ex-ussr-kinship-research ~/.claude/skills/ex-ussr-kinship-research

После установки можно описать агенту исследовательский вопрос и известные сведения — например, поиск родителей предка по записи о браке. Скриптам нужны Python 3 и стандартная библиотека; отдельные сценарии, включая сборку PDF, имеют дополнительные требования. Работа с веб-источниками также зависит от браузера, поисковых средств и доступов, подключённых к конкретному агенту. Для знакомства с другими агентами см. страницы Codex и Claude Code.

Приватность и ограничения

В проекте предусмотрены ограничения для чувствительных данных. Навык не предназначен для поиска текущих адресов, телефонов, личных аккаунтов и других контактных данных живых людей. Он также предписывает не обходить CAPTCHA, платный доступ, географические ограничения и лимиты сайтов. Частные документы, семейные фотографии и данные ДНК нельзя передавать сторонним сервисам без отдельного согласия; личные материалы рекомендуется хранить вне папки самого навыка.

Проверка редакции от 27 октября 2026 года. Мы статически просмотрели конкретную версию кода; скрипты и тесты не запускали. Явных признаков скрытой отправки семейных материалов в изученных файлах не нашли. Не используйте init_case.py --force в папке с символическими ссылками и проверяйте локальные изображения перед сборкой PDF. Это обзор для ознакомления: проект развивается независимо от FutureTools, поэтому редакция не может гарантировать его безопасность и не отвечает за работу инструмента на устройстве читателя.

ex-USSR Kinship Research распространяется по лицензии MIT. Он может помочь превратить разрозненный поиск в проверяемую работу с документами, но не заменяет архивиста и не гарантирует полноту доступных записей. Итог зависит от сохранности источников, их доступности и того, насколько точно документы позволяют различить людей.