DenisSergeevitch/ex-ussr-kinship-research

这个项目是什么

ex-USSR Kinship Research 是一套指令和工具，能将AI编码代理（如Codex或Claude Code）转变为前苏联、苏联和俄罗斯帝国的细致家庭历史研究者。它不是网站或数据库——而是一个安装到AI代理工作环境中的“技能”，使代理能够利用教堂记录、民事记录、军事档案、驱逐和镇压文件以及未索引的档案扫描件来帮助您追踪祖先。

核心理念是证据优先：代理使每项发现都可追溯，明确区分原始记录与其自身解读，并清楚说明哪些已证实、哪些未证实。

覆盖范围

涵盖所有15个前苏联加盟共和国：俄罗斯、乌克兰、白俄罗斯、摩尔多瓦、爱沙尼亚、拉脱维亚、立陶宛、格鲁吉亚、亚美尼亚、阿塞拜疆、哈萨克斯坦、吉尔吉斯斯坦、塔吉克斯坦、土库曼斯坦和乌兹别克斯坦。该技能的内部指令以俄语编写，但代理会用您的语言（英语、乌克兰语、俄语、波兰语、德语等）与您交流，引用来源时保留原始拼写并附翻译，并以记录所用语言构建搜索查询。

实际功能

• 案件受理与范围界定 — 您提供一个研究问题、已知事实、可能仍在世的人以及禁区。
• 可复现的登记表 — 它维护人员、文物、声明、关系的结构化记录，以及完整的搜索日志（CSV文件），外加最终报告模板。
• 历史辖区模型 — 每个事件都解析到事件发生时的国家、省、区、教区或民事登记处，而非今天的地图。这很重要，因为该地区的边界和行政区划不断变化。
• 姓名变体矩阵 — 处理改革前俄语、乌克兰语、波兰语、罗马尼亚语、德语和意第绪语的姓名形式、父名、娘家姓和音译，确保同一人不会因拼写不同而被遗漏。
• 来源策略 — 优先使用原件，然后是官方目录、索引、已出版文献集，仅将家谱和论坛作为线索。
• 证据协议 — 声明状态如hypothesis、single-source、corroborated、strongly-corroborated、contradicted或unresolved，而非百分比。同一记录的副本共享independence_group，因此永远不会被视为独立证据。
• 身份识别 — 同名者保持为独立条目，直到出现区分性证据（门牌号、父母、教父母、确切出生日期或军事单位）。
• 审计脚本 — 检查所有引用的一致性，并在您撰写结论前标记薄弱的佐证。它还验证最终报告：每个引用的ID必须存在于登记表中，每个状态必须匹配。
• 最终报告 — 逐条列出每个关系边，包括矛盾、失败的搜索和具体后续步骤。

如何安装和使用

您将仓库克隆到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/ — 上述四个Python脚本
• evals/ — 触发和推理测试用例
• tests/ — 单元测试

责任使用规则

该技能有明确的护栏：

• 家庭历史，而非监视 — 拒绝查找在世者的当前地址、电话或账户，并尽量减少报告中他们的数据。
• 不绕过 — 不解决CAPTCHA，不规避付费墙/地理封锁/速率限制，不使用泄露数据库。登录由用户完成。
• 未经您明确同意，不将您的文档或DNA数据上传到第三方服务。
• 敏感发现（驱逐、镇压、收养、DNA意外）以中立方式报告，且仅限问题所需范围。
• 档案访问规则会变化 — 该技能仅起草档案请求；从不发送，您应始终检查当前官方程序。

贡献与许可

欢迎在references/seed-sources.md中添加新来源——需提供已验证的所有者、辖区、收藏、来源、ID、访问权限、限制和已知检查日期；缺口应标记而非猜测。个人数据必须排除在示例之外。

该项目采用MIT许可，© 2026 Denis Shiryaev，由Denis Shiryaev（@DenisSergeevitch）维护。

简而言之

如果您有来自前苏联的祖先，并希望使用AI代理进行研究，此技能为该代理提供了纪律严明、基于证据的工作流程：它了解历史辖区，处理跨语言的姓名变体，严格跟踪已证实和未证实的内容，并生成可验证的最终报告——同时尊重隐私和访问规则。