DenisSergeevitch/ex-ussr-kinship-research
效率与系统工具把编程 Agent 变成可追溯的前苏联家谱研究员,适合有具体问题、愿意查档案的人。
这是一个面向前苏联、苏联和俄罗斯帝国范围的家谱研究 Agent 技能。它不适合“输入姓氏等答案”的用法,而适合已有具体家族问题、愿意调阅教会簿和民事记录的人。
解决什么问题
在前苏联地区查家谱,通常从名字、村庄和模糊的年份开始,然后卡在档案这一关:教会簿和民事登记用的是今天已不存在的行政区划,姓名有多个字母体系和拼法,同一份记录可能以三份副本出现,看起来像互相独立的证据。通用聊天助手很容易给出看似合理的父母姓名,却不说明依据的是哪一版哪一份记录。这个技能改变的是工作单元:Agent 建立案件目录,维护人物、线索、主张和检索日志,把每个事件归到事件发生当时的行政区划,最后生成一份报告,把文件能证明的内容与仍然只是线索的内容分开。
有什么不同
核心机制不是搜索引擎,而是证据协议。每条主张有可解释的状态,例如假设、单一来源、已印证、强印证、被矛盾或未解决,而不是百分比;同一份记录的副本共享一个独立性分组,因此不会被算作两次独立证明。同名者会保持为不同人物,直到出现门牌号、教父母、确切出生日期或部队番号这类区分性细节。写报告前,审计脚本会检查引用的 ID 是否都存在、结论是否与登记册一致。
这种设计适合一个很容易靠猜测推进的领域,而分支猜错的代价往往是几个月的档案申请。它同时意味着 Agent 会做大量记录工作:你会被问及研究范围、已掌握的事实、在世人员的限制和哪些内容不能碰。技能说明用俄语写成,但 Agent 用你的语言回复,引用时保留原文拼写并附翻译,所以不会俄语也能使用,不过原始档案本身仍然需要处理。
另一个实际差异是历史行政区划和姓名变体资料:革命前俄文、乌克兰文、波兰文、罗马尼亚文、德文和意第绪文形式,以及不同时期的历法和记录类型。多数随手的家谱帮助正是在这里失效,但这份技能用范围换取了深度:它明确限定在前苏联、俄罗斯帝国以及哈布斯堡时期的加利西亚和布科维纳,不覆盖任意地区的家谱。
谁值得试
适合:有具体问题的人,例如祖辈在 1930 年代被流放到哈萨克斯坦,想知道其父母是否出现在教会簿中,并且愿意自己收集扫描件、等待档案回复。也适合同时持有结婚证和军人卡扫描件、需要判断二者是否描述同一个人的研究者。审计步骤和逐条关系报告能给这类工作提供结构。
不适合:只想输入姓氏就拿到答案的人,或研究范围不在上述地区的人。不愿把案件数据放在技能目录之外的用户也应避开,因为 README 要求私人案件目录另置;init_case.py 拒绝在技能文件夹内创建案件,并且每份保存的扫描件都要求计算哈希。
使用条件与边界
安装方式是把仓库克隆到 ~/.codex/skills/ 或 ~/.claude/skills/(单个项目则放到 .claude/skills/),主脚本只需要 Python 3 标准库,具体见安装与使用说明。PDF 导出是例外:build_pdf.py 需要基于 Chromium 的浏览器,可选的 PNG 页面预览还需要 pypdfium2。文档没有提到 API key 或付费服务。
真正的约束是持续投入。登录、验证码和档案通信由用户完成,技能只负责起草请求;档案访问规则会变,每次都要核对官方流程,技能的职责止于准备材料。来源由一份种子清单维护,并非穷尽。README 没有说明种子来源对某个省份覆盖得有多全,因此在假设 Agent 能深入某地之前,需要先核实该地区的资料来源。
HotRepo 点评
HotRepo 在 2026-10-25 的样本中记录到该项目总星数 448,在新项目榜(非总榜)排名第 12;这只是一个日期的榜单观察,不是每日增长数据,仅凭一个记录日期无法判断热度能否持续。新仓库加一份快照只能说明创建时间和当时的状态。采用前值得核对的具体一点是:种子来源清单对你所在省份的覆盖情况,因为证据流程再严密,也只能指向它掌握的记录。
本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。