DenisSergeevitch/ex-ussr-kinship-research

Evidence-first genealogy skill for AI agents (Codex, Claude Code): church books, civil, military, deportation and repression records across the former USSR. Replies in your language.

このプロジェクトについて

ex-USSR Kinship Research は、AIコーディングエージェント（CodexやClaude Codeなど）を、旧ソ連、ソビエト連邦、ロシア帝国の慎重な家族史研究者に変える一連の指示とツールです。ウェブサイトやデータベースではなく、AIエージェントの作業環境にインストールする「スキル」であり、教会簿、民事記録、軍歴ファイル、強制移住・弾圧文書、未索引のアーカイブスキャンを使って祖先を追跡するのを支援します。

核となる考え方は証拠優先です。エージェントはすべての発見を追跡可能にし、生の記録と自身の解釈を明確に分離し、証明されていることとされていないことを明確に述べます。

対象範囲

旧ソ連の15共和国すべて：ロシア、ウクライナ、ベラルーシ、モルドバ、エストニア、ラトビア、リトアニア、ジョージア、アルメニア、アゼルバイジャン、カザフスタン、キルギス、タジキスタン、トルクメニスタン、ウズベキスタン。スキルの内部指示はロシア語で書かれていますが、エージェントはあなたの言語（英語、ウクライナ語、ロシア語、ポーランド語、ドイツ語など）で話し、出典を元の綴りで翻訳付きで引用し、記録の言語で検索クエリを構築します。

実際の機能

ケース受付と範囲 — 1つの調査質問、既知の事実、生存している可能性のある人、禁止事項を指定します。
再現可能なレジスタ — 人物、アーティファクト、主張、関係の構造化記録と完全な検索ログ（CSVファイル）を維持し、最終レポートテンプレートも含みます。
歴史的管轄モデル — 各イベントは、今日の地図ではなく、イベント時点の州、県、地区、教区、または民事登録所に解決されます。この地域では国境と行政区画が絶えず変化したため、これは重要です。
名前バリアント行列 — 改革前ロシア語、ウクライナ語、ポーランド語、ルーマニア語、ドイツ語、イディッシュ語の名前形式、父称、旧姓、音訳を処理し、同じ人物が異なる綴りで見逃されないようにします。
ソース戦略 — 原本を最優先し、次に公式カタログ、索引、出版された文書コレクションを使用し、家系図やフォーラムは手がかりとしてのみ使用します。
証拠プロトコル — 主張にはhypothesis、single-source、corroborated、strongly-corroborated、contradicted、unresolvedなどのステータスが付けられ、パーセンテージではありません。同じ記録のコピーはindependence_groupを共有するため、独立した証拠として数えられることはありません。
身元解決 — 同名の人物は、区別する証拠（家番号、両親、代父母、正確な生年月日、または軍事部隊）が現れるまで別々のエントリとして保持されます。
監査スクリプト — すべての参照の一貫性をチェックし、結論を書く前に弱い裏付けをフラグします。また、最終レポートを検証します：引用されたすべてのIDがレジスタに存在し、すべてのステータスが一致する必要があります。
最終レポート — すべての関係エッジを1つずつ提示し、矛盾、失敗した検索、具体的な次のステップを含みます。

インストールと使用方法

リポジトリをAIエージェントのスキルフォルダにクローンします：

# 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

その後、家族に関する質問を平易な言葉で説明するだけです。例：

「私の曽祖父は1930年代にカザフスタンに追放されました。教会記録で彼の両親を見つけるのを手伝ってください。」
「結婚証明書と兵士カードのスキャンがあります。それらが同じ人物かどうか確認し、証拠チェーンを構築してください。」
「1890年代のポドリアの村の教区と適切なFamilySearchフィルムを見つけ、姓Xの出生記録を読んでください。」

スキルフォルダから実行できるコマンドラインスクリプトもあります：

init_case.py — 新しい調査ケースを開始します（--forceを使用してもスキルフォルダ内での作成を拒否します）
hash_artifact.py — 保存された各スキャンまたはドキュメントのSHA-256ハッシュを計算します
audit_evidence.py — 最終レポートを書く前にレジスタをチェックします
build_pdf.py — HTMLレポートをPDFに変換します（Chrome、Chromium、またはEdgeのインストールが必要）

スクリプトにはPython 3と標準ライブラリのみが必要です；build_pdf.pyはさらにChromiumベースのブラウザが必要です。プライベートなケースデータはスキルのGitチェックアウトの外に保管してください。

リポジトリ構成

プロジェクトは次のように構成されています：

SKILL.md — メインの指示（ワークフロー、ハードルール、言語ポリシー）
references/ — 詳細ガイド：ソース戦略、証拠プロトコル、ロケールガイド（管轄、名前バリアント、カレンダー、記録タイプ）、ブラウザとCAPTCHA処理、プライバシーと安全、厳選された開始ソース、フィールドレッスン、変更ログ、写真検索、ハプスブルク領ガリツィア/ブコビナガイド
assets/ — ケース受付テンプレート、CSVレジスタテンプレート、最終レポートテンプレート、写真READMEテンプレート、読みやすいPDFテンプレート
scripts/ — 上記の4つのPythonスクリプト
evals/ — トリガーと推論のテストケース
tests/ — ユニットテスト

責任ある使用ルール

このスキルには明確なガードレールがあります：

家族史であり、監視ではない — 生存者の現在の住所、電話、アカウントを調べることを拒否し、レポート内の彼らのデータを最小限にします。
バイパスしない — CAPTCHA解決、ペイウォール/ジオブロック/レート制限回避、漏洩データベースの使用はありません。サインインはユーザーが行います。
あなたの明示的な同意なしに、あなたの文書やDNAデータを第三者サービスにアップロードしない。
機密性の高い発見（強制移住、弾圧、養子縁組、DNAの驚き）は、中立的に、質問が必要とする範囲でのみ報告されます。
アーカイブアクセスルールは変更されます — スキルはアーカイブリクエストの下書きのみ行います；送信は決してせず、常に現在の公式手順を確認してください。

貢献とライセンス

references/seed-sources.mdへの新しいソースの追加を歓迎します — 検証済みの所有者、管轄、コレクション、来歴、ID、アクセス、制限、既知の場合は確認日を含めてください；ギャップは推測ではなくマークする必要があります。個人データは例から除外する必要があります。

要するに

旧ソ連に祖先がいて、AIエージェントで調査したい場合、このスキルはそのエージェントに規律ある証拠ベースのワークフローを提供します：歴史的管轄を理解し、言語間の名前バリアントを処理し、証明されたこととされていないことを厳密に追跡し、検証可能な最終レポートを生成します — プライバシーとアクセスルールを尊重しながら。