ex-ussr-kinship-research

目的

再現可能な調査を通じて、親族関係を立証または反証します。各資料の出所を記録し、記録とその解釈を区別し、歴史的な境界や名前の異表記を考慮したうえで、証拠の強さに応じて結論を評価します。

コミュニケーション言語 / Language

常にユーザーの言語で返信してください。 このファイルはロシア語で書かれていますが、返信もロシア語にする必要があるという意味ではありません。

1. ユーザーの直近のメッセージの言語（英語、ウクライナ語、ロシア語、ポーランド語、ドイツ語など）でユーザーとやり取りします。ユーザーが別の言語を明示的に希望した場合は、その言語を使用します。
2. 資料からの引用は、原文の表記（キリル文字、ラテン文字、旧正書法）で示します。理解に必要な場合は、ユーザーの言語による訳を併記します。
3. assets/ のテンプレート（レポート、台帳）は、ユーザーの言語で記入します。見出しや説明は翻訳します。CSV の列名、識別子（person_id、claim_id、artifact_id）、ステータス（single-source、corroborated など）は翻訳しません。
4. 検索クエリは、やり取りの言語ではなく、資料の言語（ロシア語、ウクライナ語、ポーランド語、ルーマニア語、ドイツ語、イディッシュ語など）で作成します。
5. やり取りの言語は、case-intake.yaml の requested_output_language フィールドに記録します。デフォルトは auto（ユーザーの言語）です。

スキルの更新

調査の開始時に一度だけ、正規リポジトリに新しい変更がないか確認します。更新がある場合はユーザーに知らせ、「スキルの更新が公開されています。更新しますか？」と尋ねます。ユーザーのエージェントは、同意を得た後、通常利用できる手段で更新を実行します。返答がない場合、またはユーザーが拒否した場合は、各サイクルで再度提案せず、現在のバージョンで調査を続けます。

自律的な調査

デフォルトでは、必要に応じて数時間に及ぶ長期サイクルで、自律的に調査を進めます。各段階の後に「続けますか？」と尋ねて作業を止めないでください。

1. 確認事項は、メッセージまたは非ブロッキングのツールを使って一度だけ尋ね、返答待ちにはしません。既知の事実を使ってすぐに作業し、不明な点は不明として記録し、仮定は仮説として扱います。返答がなくても調査は止めません。
2. 次のサイクルを繰り返します。キューから次の確認事項を選ぶ → 資料を見つけて読む → 資料とその出所を保存する → 主張とログを更新する → 次に有用な手順を選ぶ。新たな根拠がない限り、確認済みの検索を繰り返しません。
3. CAPTCHA やログインへの対応は、references/browser-and-captcha.md の第5節～第5a節に従います。ユーザーの対応が必要な場合、可能であれば該当するタブを開き、その手順をキューに残します。その経路のみを保留し、ほかの資料、名前の異表記、家系の枝、すでに取得した資料の分析は続けます。
4. 発見事項は台帳に保存し、残っている確認事項やブロック要因は、research-state.md などの作業計画に記録します。既存の計画を使い、台帳の内容を計画に書き写しません。中断後は、次に有用な手順から再開します。
5. タスクの範囲内で、有用かつ実行可能な確認事項が残っている限り続けます。タスクが完了し、対象範囲を十分に調査した場合、利用可能な経路を使い切った場合、ユーザーが明示的に停止した場合、または環境の上限に達した場合に終了します。やむを得ず終了する前に、状態と到達した結果を保存します。質問への返答がないことや、1つのサイトにアクセスできないことだけを理由に、調査全体を終了してはいけません。

複数の実行者が同じ案件に取り組んでいる場合や、事務的な処理が有用な成果より速く増えている場合は、references/research-coordination.md を読みます。ここに記載されているのは、記録の分担、結果の引き継ぎ、処理量に関する条件付きの推奨事項です。追加のエージェントを起動したり、ユーザーが選択した保存先を変更したりすることを求めるものではありません。

Неподлежащие нарушению правила

1. Считать любой новый материал артефактом, а не фактом. Не переносить утверждение из артефакта в вывод без оценки происхождения, читаемости, прямоты и независимости.
2. Не считать копии, зеркала, индексы и пересказы одной записи независимыми подтверждениями. Назначать им общий independence_group.
3. Не присваивать связи статус corroborated без как минимум двух независимых доказательных цепочек. Даже сильный первичный документ до кроссподтверждения помечать single-source.
4. Не сливать двух одноимённых людей только по ФИО, возрасту или населённому пункту. До разрешения личности вести отдельные person_id.
5. Сохранять исходное написание имён, дат и мест. Нормализованные варианты хранить отдельно и явно помечать как исследовательскую форму.
6. Не скрывать противоречия. Фиксировать их рядом с выводом и сохранять альтернативные гипотезы.
7. Для живых людей минимизировать данные. Не искать и не публиковать текущие адреса, телефоны, личные аккаунты, документы-идентификаторы, сведения о несовершеннолетних или иные данные, не необходимые для семейно-исторической задачи.
8. Не загружать пользовательские документы, ДНК-данные или фотографии в сторонние сервисы без явного разрешения пользователя.
9. Не обходить ограничения доступа и лимиты. Для CAPTCHA допустима одна попытка через обычный интерфейс внутреннего браузера агента, если позволяют инструменты и правила сайта; вход выполняет пользователь. Порядок попытки, открытия вкладок и передачи заблокированного шага — references/browser-and-captcha.md, разделы 5–5а.
10. Не выдавать отсутствие результата поиска за доказательство отсутствия человека или события.
11. Не выдумывать недостающие сведения и не повышать семейную память до документального факта. При исчерпании полезных доступных проверок сохранить результат и оставшиеся вопросы; не повторять без новых оснований одни и те же поиски.

Рабочий процесс

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

Шаг 1. Зафиксировать задачу и допустимый объём

1. Сформулировать рабочую цель из запроса. При широкой задаче начать с наиболее надёжно известной ветви и расширять поиск по находкам.
2. Зафиксировать известные имена, варианты написания, примерные даты, населённые пункты, конфессию или общину только если это релевантно архивному поиску, занятия, родственников и миграции.
3. Отметить, какие лица могут быть живы. Для них записать заявленную пользователем связь, согласие или иную законную и неинтрузивную основу исследования.
4. Учитывать уже указанные ограничения. Не превращать пустые поля шаблона в дополнительный опрос; обычный поиск, чтение, локальный анализ и сохранение доступных исторических материалов по задаче выполнять самостоятельно. Уже полученные разрешения не переспрашивать.
5. При наличии входных файлов сохранить оригиналы без изменений и работать с копиями.
6. Один раз уточнить имеющиеся материалы: «Какие материалы по этой семье у вас уже есть?» Если они уже описаны или приложены, не переспрашивать. Ответ учесть в input_materials и, если он касается прежних исследований, в prior_family_research. Пока ответа нет, отметить это в notes и сразу продолжить поиск по известным данным.

Использовать структуру assets/case-intake.template.yaml. Подробные ограничения читать в references/privacy-and-safety.md.

Шаг 2. Инициализировать дело и реестры

Продолжить существующее дело или самостоятельно выбрать отдельную папку вне навыка, например в ~/kinship-cases/. Повторно инициализировать уже созданное дело не нужно. Для нового дела:

python scripts/init_case.py --case-dir <путь> --research-question "<вопрос>" --subject-label "<основной человек>"

Заполнять по мере работы, сохраняя неизвестные сведения как неизвестные:

• case-intake.yaml — задача, рамки, исходные данные и ограничения;
• person-register.csv — отдельные кандидаты на личность;
• artifact-register.csv — каждый документ, веб-результат, изображение или запись;
• claims-register.csv — проверяемые утверждения, извлечённые из артефактов;
• relationship-register.csv — гипотезы о связях между person_id;
• search-log.csv — запросы, фильтры, неудачи, CAPTCHA и следующие шаги;
• рабочий план, например research-state.md, — оставшиеся проверки и блокировки;
• final-report.md — итоговое исследование по шаблону;
• photos/ — найденные фотографии и README.md с их описанием (шаг 6а);
• pdf-source/ — исходник читаемой PDF-версии (шаг 12), создаётся в конце.

Для локального файла вычислить контрольную сумму:

python scripts/hash_artifact.py <путь-к-файлу>

Шаг 3. Разобрать материалы пользователя

1. Извлечь текст, таблицы, подписи, штампы, номера актов, архивные шифры и оборотные пометы.
2. Для сканов указать страницу, область и качество чтения. Нечитаемые места обозначать [неразборчиво]; предположения — [предположительно: ...].
3. Не исправлять молча фамилии, даты и географию. Сохранять names_as_written, place_as_written и исходную дату.
4. Для каждого материала создать artifact_id и записать происхождение, дату получения, локальный путь или URL, тип оригинала/копии, читаемость и independence_group.
5. Существенные для ответа утверждения оформить отдельными claim_id, чтобы их источники и противоречия можно было проверить.

Подробную схему оценки читать в references/evidence-protocol.md.

Шаг 4. Построить историко-географическую модель

1. Для каждого события определить юрисдикцию на дату события, а не только современную страну.
2. Установить нужные для поиска уровни юрисдикции и архив-преемник. При неоднозначности вести несколько вариантов и проверять их по каталогам и документам.
3. Составить варианты старых и новых топонимов, языков и письменностей.
4. Записать исходный календарь; не выполнять скрытую конвертацию дат.
5. Построить матрицу вариантов имени: исходное написание, дореформенная форма, местный язык, кириллица/латиница, патроним, фамильное окончание, возможная русификация и бытовые формы.
6. Не считать переводные или созвучные имена эквивалентными без дополнительных признаков.
7. Выбирать существенные варианты под язык, место и период; расширять их при пробелах и новых находках. Например:
   • е/ё и окончания -ев/-ов/-ёв, полное и сокращённое отчество («Данилович»/«Даниилович»), записи без отчества;
   • женские формы (-ова/-ов, -ская/-ский, -ина/-ин) и для женщин — девичью и все брачные фамилии;
   • польское, идишское, немецкое, румынское и латинское написание (references/ex-ussr-locale-guide.md);
   • церковную форму имени и бытовую (Евдокия/Авдотья, Иоанн/Иван, Мордух/Мордко/Марк).

Читать references/ex-ussr-locale-guide.md только когда появляются исторические границы, смена языка/письменности или неоднозначные топонимы. Для дел, связанных с Галицией или Буковиной, читать references/habsburg-galicia-bukovina.md.

Шаг 5. Составить план поиска

1. Начать с наиболее позднего надёжно установленного события и двигаться назад по одной связи за раз. Место захоронения не доказывает место происхождения; исходную гипотезу о происхождении проверять по документам. Для городской биографии XX века известный работодатель или место проживания могут дать следующий маршрут поиска.
2. Для каждого пробела определить подходящий тип записи: акт ЗАГС, метрическая книга, исповедная ведомость, ревизская сказка, посемейный/домовой список, перепись, военная запись, эвакуация, репрессия, миграция, адрес-календарь, некролог, кладбищенская запись и т. п.
3. Выбирать источник по вопросу, покрытию и доступности. От индекса или семейной страницы переходить к указанному оригиналу; наводки помогают продолжать поиск, но не заменяют проверку доказательств.
4. По мере появления записывать существенные гипотезы и различающие их проверки.
5. Составить запросы по вариантам имени, месту, диапазону лет, родственникам, профессии, воинской части и архивному шифру.
6. Намечать проверки по вопросу, месту и периоду, используя references/source-strategy.md, раздел 12, и подходящие источники каталога. В журнале отражать фактически выполненные поиски и ограничения, а оставшиеся полезные шаги держать в плане.
7. В биографическом и семейном исследовании проверять семейные публикации и фотографии, если они могут помочь задаче; для короткого точечного вопроса выбирать относящиеся к нему проверки.
8. Если женская линия упирается в смену фамилии, проверить маршрут «надгробие → кандидат в родственники → военная запись» (references/field-lessons.md, раздел 4). Для советской гражданской биографии использовать документы о работе, наградах и эвакуации по месту события (references/field-lessons.md, раздел 9); региональные примеры не ограничивают охват бывшего СССР.

Подробную тактику и приоритеты источников читать в references/source-strategy.md. Каталог стартовых ресурсов, поддерживаемый автором навыка, находится в references/seed-sources.md и не заменяет проверку актуальности и происхождения. Просмотреть структуру всего каталога и изучить подходящие разделы, в том числе в конце файла; первые строки каталога не определяют его полное покрытие.

Практические приёмы для неиндексированных сканов (FamilySearch, архивные порталы), документов о репрессиях и депортациях, военных баз, исчезнувших хуторов, оккупированных территорий и ситуации «открытые источники исчерпаны» читать в references/field-lessons.md.

Шаг 6. Искать доступными инструментами

Использовать веб-поиск, каталоги/API и браузер по возможностям источника:

1. Использовать поиск, переходы, фильтры каталогов и просмотр документов последовательно; не отправлять массовые запросы.
2. Для каждого поиска сразу записывать точный запрос, локаль/язык, фильтры, URL, дату доступа и результат в search-log.csv.
3. При обнаружении записи сохранить устойчивый идентификатор, архивный шифр, номер страницы/кадра и прямую ссылку, если она существует.
4. Для сканированных PDF и изображений просматривать саму страницу, а не полагаться только на OCR или сниппет. Для рукописных таблиц и спорных чтений использовать «Проверку визуального чтения» в references/field-lessons.md, раздел 1.
5. Не использовать фрагмент поисковой выдачи как конечный источник, если доступна исходная страница.
6. При недоступности браузера использовать другие доступные средства поиска и чтения, а также предоставленные материалы. Указывать фактические ограничения, не заявляя невыполненные проверки.
7. После находки вернуться к оставшимся существенным вопросам и выбрать следующий полезный источник. Найденное можно сообщать сразу, явно указывая покрытие и незавершённые проверки.
8. Мемориальные и семейные сайты проверять их собственным поиском, когда он доступен. Пустая внешняя веб-выдача не подтверждает отсутствие записи во внутренней базе. Форматы поисковых ссылок — в references/source-strategy.md, раздел 12.
9. Для точечного поиска в индексах FamilySearch по месту/DGS и локального анализа разрешённых фрагментов читать references/familysearch-indexes.md. Если индекса нет, использовать маршрут чтения сканов из references/field-lessons.md.
10. Для документов Первой мировой на GWAR читать references/ww1-search.md: поиск человека и ограниченный поиск по местности с учётом правил источника. Полученные карточки помогают различить кандидатов, но не являются переписью населения и не доказывают родство.
11. Результаты этих скриптов добавлять в существующие artifact-register.csv и search-log.csv через scripts/register_search.py или вручную. Автоматический перенос сохраняет наводки и исходные данные; личности, утверждения, связи и независимость устанавливать по шагам 7–10. Не создавать отдельное дело для каждого источника.

При проверке охвата или смысла индексированной выдачи, повторном использовании поиска, библиографической находке или конфликте каталога читать references/search-result-validation.md. Этот же справочник использовать для проверки архивных ссылок, включая предполагаемые исправления шифров и перемещения дел.

6а. Фотографии человека

Искать фотографии в том же проходе, что и документы, а не после отдельной просьбы:

1. Выбор источников, опознание, датировку и хранение вести по references/photo-search.md. Не применять распознавание лиц; сомнительные подписи не считать доказанным опознанием.
2. Сохранять доступные исторические снимки по задаче без отдельного вопроса о каждом файле, соблюдая ограничения источника. Учитывать их как артефакты и описывать в photos/README.md.
3. Записать покрытие поиска. not-found означает «не найдено в проверенных источниках», а не доказательство, что фотографий никогда не существовало.

При входе, CAPTCHA и ошибках доступа использовать references/browser-and-captcha.md: недоступный маршрут отметить и продолжить другие проверки.

Шаг 6б. Запросить сведения у учреждения

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

1. Выбрать хранителя и проверить официальный канал обращения; примеры адресатов, состав письма и порядок отправки — в references/correspondence.md.
2. Использовать доступную почтовую интеграцию. Если её нет, предложить пользователю подключить почту через штатный интерфейс среды или передать готовое письмо для самостоятельной отправки. Подключение ящика само по себе не разрешает отправку.
3. Выполнить уже разрешённую отправку без повторного согласования в пределах поручения; учитывать ограничения адресатов, вложений и платных действий. При отсутствии разрешения подготовить конкретное письмо и запросить согласие на его отправку, продолжая остальные проверки.
4. Проверить результат, сохранить письмо/номер обращения и обработать ответ как источник. При неоднозначной ошибке сначала проверить, ушло ли письмо, чтобы не отправить дубль.

Шаг 7. Оценить артефакты и извлечь утверждения

Для каждого артефакта отдельно оценить:

• происхождение и архивную ссылку;
• оригинал, изображение оригинала, индекс, копию или пересказ;
• современность событию;
• информанта и его возможную осведомлённость;
• прямое или косвенное отношение к утверждению;
• читаемость и полноту;
• независимость от других артефактов;
• признаки ошибки, позднего исправления или заимствования.

Не использовать числовой «процент истины». Присваивать утверждениям только объяснимые статусы:

• hypothesis — рабочая гипотеза;
• single-source — поддержана одной доказательной цепочкой;
• corroborated — поддержана минимум двумя независимыми цепочками без неразрешённого существенного конфликта;
• strongly-corroborated — несколько независимых цепочек, включая хотя бы одну прямую запись с установленным происхождением;
• contradicted — сильное противоречащее свидетельство;
• unresolved — данных недостаточно или конфликт не разрешён.

Шаг 8. Разрешить личности

1. Сопоставлять не только имя, но и совокупность дат, мест, родственников, профессии, адреса, сословия/статуса, конфессии, свидетелей, воинской части и миграционного маршрута.
2. Вести конкурирующих кандидатов раздельно до появления различающих признаков.
3. Зафиксировать причины каждого слияния или разделения person_id.
4. Проверить круг семьи: супругов, родителей, детей, братьев/сестёр, восприемников, свидетелей и соседей, если это помогает идентификации.
5. Не трактовать проживание в одном хозяйстве как биологическое родство.

Шаг 9. Проверить родственную цепочку

1. Строить сложную связь из отдельных рёбер: например, дед/внук требует двух независимо проверенных связей родитель–ребёнок.
2. Различать биологическую, юридическую, приёмную, опекунскую, сводную и хозяйственную связь.
3. Для каждого ребра перечислить поддерживающие и противоречащие artifact_id/claim_id.
4. Не выводить родство из общей фамилии, ДНК-совпадения без контекста, семейного дерева пользователя или сообщения на форуме.
5. Чувствительные открытия — усыновление, возможное несоответствие отцовства, репрессии, этничность, религия — формулировать нейтрально, только в объёме, необходимом для ответа, и с явной ссылкой на источник.
6. Оценивать принадлежность записи человеку и доказанность каждого родственного ребра отдельно: установленная личность не повышает статус связи. Отчество само по себе не доказывает отцовство (references/evidence-protocol.md, раздел «Разрешение личности»).

Шаг 10. Провести аудит доказательств

Запустить:

python scripts/audit_evidence.py --case-dir <путь>

Проверить ссылки между реестрами и отчётом, независимость источников и обоснования статусов. Ошибки ссылочной целостности исправить; предупреждения разобрать по источникам, сохранив нерешённые вопросы. Не повышать статус ради прохождения проверки. single-source, hypothesis и unresolved — допустимые рабочие результаты.

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

Шаг 11. Подготовить итоговое исследование

Использовать assets/final-report.template.md как ориентир под задачу. Краткий ответ должен содержать вывод, источники, неопределённость и следующий полезный шаг; для подробного исследования добавить хронологию, проверку родственных связей, противоречия и покрытие поиска. Неприменимые разделы пропускать, неизвестные сведения не выдумывать.

Фактические выводы сопровождать ссылками на артефакты [A-0001; A-0007]. Обновлять отчёт по мере находок, не ждать исчерпания всех направлений ради промежуточного результата.

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

Для существенных пунктов пояснять, какой вопрос или родственное звено они помогут проверить, где источник, какова его фактическая доступность, кто выполняет проверку и от чего она зависит. Упорядочивать по ожидаемой пользе для исследовательского вопроса с учётом усилий и зависимостей. Стоимость и сроки указывать, если известны; непроверенный доступ и неизвестные затраты отмечать прямо, неприменимые поля пропускать. У родственников можно уточнять наличие документов и записывать семейные воспоминания, различая их происхождение и доказательную силу по references/evidence-protocol.md.

Задания и передачу результатов при уже согласованной параллельной работе оформлять по references/research-coordination.md.

Шаг 12. Подготовить удобную версию отчёта

Для короткого ответа достаточно текста или Markdown. Если PDF запрошен или полезен для передачи семье, самостоятельно использовать assets/report-pdf.template.html, адаптировав разделы под задачу.

• Объяснять надёжность понятными словами, сохраняя различие между подтверждением, гипотезой, нехваткой данных и противоречием. Архивные шифры и ссылки оставить.
• Фотографии, военную службу, репрессии и другие тематические блоки включать по содержанию дела. Отсутствие фото или полного ответа не мешает подготовить отчёт.
• Оригиналы изображений сохранять; рабочие копии обрезать или уменьшать только по потребности, сохраняя читаемость.

python scripts/build_pdf.py --html <дело>/pdf-source/report.html --out <дело>/report.pdf

Проверить читаемость и вёрстку готового PDF. Если этот способ сборки недоступен, использовать другой доступный инструмент или сохранить результат в доступном формате, продолжая исследование.

Обработка ошибок

• Если документ не читается, сохранить его как артефакт, описать дефект и при необходимости запросить лучшую копию; до ответа работать с другими материалами и источниками.
• Если источник исчез, проверить официальный каталог, веб-архив только в допустимых пределах и зеркала; зеркала не считать независимыми.
• Если архивная юрисдикция неясна, проверить правдоподобные места, приходы и архивы параллельно; до разрешения не объединять кандидатов.
• Если результаты дают несколько однофамильцев, расширить семейный кластер и не выбирать кандидата по интуиции.
• Если источники противоречат друг другу, сохранить обе версии, оценить информанта и искать третий независимый источник.
• Если поиск затрагивает явно живого человека без достаточной семейно-исторической основы, сузить исследование до предоставленных пользователем материалов или прекратить интрузивную часть.
• Если документ и семейная память расходятся (например, место рождения в паспорте и в рассказе), сохранить обе версии как отдельные утверждения со своими источниками. Не подгонять документ под рассказ и не наоборот. Различать «родился» и «вырос».
• Если в одной базе найдено много документов, вернуться к оставшимся существенным вопросам и выбрать следующую полезную проверку.
• Если все полезные доступные маршруты в рамках задачи исчерпаны, один раз перечислить установленное, неустановленное и покрытие. Сохранить рабочий план, вопросы родственникам и проекты архивных запросов (references/field-lessons.md, раздел 8); продолжить с этого состояния при появлении новых данных или доступа.