← 返回列表

新工具 GitHub · DenisSergeevitch/ex-ussr-kinship-research

用 ex-ussr-kinship-research 让 Codex/Claude Code 查前苏联家谱并出证据链

提出一个家族考证问题，得到带可解释证据状态、搜索日志与下一步线索的可追溯报告

开始尝试

效果

仓库里有 docs/cover.jpg 封面图，README 未提供实践结果截图或示例报告输出；最终报告需自己运行脚本生成。

这是什么

新在哪里：以前查前苏联家谱靠自己在档案目录和论坛里试关键词、手工判断同名者；现在把问题交给 agent，由它按历史辖区检索并按证据状态逐条标注结论

怎么做到的：把仓库 clone 到 agent 的 skills 目录，用自然语言描述一个问题，agent 按 SKILL.md 先做案件范围与历史辖区解析，再按原件→官方目录→索引→文档集的顺序检索，用 init_case.py 建案、hash_artifact.py 给每份扫描件记 SHA-256、audit_evidence.py 在出结论前核对引用完整性，最后用 build_pdf.py 渲染报告

适合谁
手上已有具体家族问题、愿意按证据规则逐条核对档案线索的家谱研究者或历史爱好者
能帮你
把“我猜他们是同一个人”变成带独立性分组与状态标签的可核查证据链，并明确列出未证实与查不到的部分

评分 三项分开看，不合成总分；热度不等于好用

新颖性
全新做法 · 2026-10-25 出现
热度
未知
易上手
需要一些准备
怎么评的

三项都由本站记录的事实按固定规则算出，编辑不能直接改档位；规则改动会写进更新说明。

新颖性

  • ●●● 全新做法，且有来源依据的出现时间在最近 30 天内
  • ●●○ 老工具新用法或近期刚开放，且有来源依据的时间在最近 30 天内
  • ●○○ 出现时间超过 30 天、未核实到精确日期，或已不再是新做法
  • 其他 出现时间未核实、晚于今天，或新颖类型未核实时按最低一档处理，不靠猜测加分

热度

  • ●●● 最近一次每周人工确认为“热门”：最近 14 天里独立讨论、实际案例、持续时间、传播平台、相对关注五项门槛全部满足（规则 heat-v1）
  • ●●○ 最近一次人工确认为“观察中”：前三项至少一项达到，或讨论增长 ≥ 50%，且至少 2 个独立案例
  • ●○○ 最近一次人工确认为“未进入跟踪”
  • 其他 还没有人工确认过的热度记录时显示“未知”。热度只统计本站已接入的信源，不代表全网

易上手

  • ●●● 准备门槛低且难度入门：不需要新账号或付费，首次尝试不超过 30 分钟，公开可用，会复制粘贴即可
  • ●●○ 准备门槛中等，或门槛低但需要改少量代码或配置
  • ●○○ 准备门槛高：需要商业软件或付费服务、首次尝试超过 2 小时、特殊硬件或网络、排队或邀请且无替代方案，或需要专业知识
  • 其他 只有介绍、还没有站内步骤，或关键步骤已失效时显示“暂不可试”；门槛未核实时显示“未核实”

怎么尝试

  • 时间 首次约 25 分钟
  • 费用 费用待核验：原站未说明费用；使用需自备 Codex / Claude Code 等 agent 运行环境，仓库本身是 MIT 许可开源
  • 账号 不需要新账号
  • 环境 macOS / Linux 终端（路径写法为 ~/.codex/skills 或 ~/.claude/skills）+ Python 3；生成 PDF 需 Chrome、Chromium 或 Edge
  • 准备 Codex 或 Claude Code 等 Agent Skills 运行环境：加载并执行该 skill 的指令与脚本
  • 准备 git：把仓库 clone 到 skills 目录
  • 准备 Python 3：运行 init_case.py、hash_artifact.py、audit_evidence.py
  • 准备 Chrome / Chromium / Edge（选用）：build_pdf.py 渲染 PDF 报告（或设置 CHROME_PATH）
  • 准备 案件扫描件等原始档案（选用）：作为 artifact 登记并计算 SHA-256

按下面的步骤就能做出第一个结果。复制命令不会自动执行。

  1. clone 到 Codex 的 skills 目录

    README 给出 Codex 的安装方式，把仓库放进 ~/.codex/skills/

    bash原始来源命令 
    git clone https://github.com/DenisSergeevitch/ex-ussr-kinship-research ~/.codex/skills/ex-ussr-kinship-research

    预期结果：~/.codex/skills/ex-ussr-kinship-research 下出现 SKILL.md、scripts、references 等目录

  2. 初始化一个案件

    在 skill 文件夹内运行，案件目录要放在 Git checkout 之外；README 说明 init_case.py 会拒绝在 skill 文件夹里建案

    bash原始来源命令 
    python scripts/init_case.py --case-dir ~/kinship-cases/my-case --research-question "Who were Maria's parents?" --subject-label "Maria"

    预期结果：~/kinship-cases/my-case 下生成案件骨架与登记表

  3. 把扫描件登记为 artifact

    对每一份保存的档案扫描件计算 SHA-256，便于后续溯源

    bash原始来源命令 
    python scripts/hash_artifact.py ~/kinship-cases/my-case/scans/marriage-1902.jpg

    预期结果：输出该文件的 SHA-256 并登记到案件的 artifact 记录

  4. 向 agent 提出家族问题

    在 Codex / Claude Code 中描述问题，例如："My great-grandfather was exiled to Kazakhstan in the 1930s. Help me find his parents in church records."

    预期结果：agent 按 SKILL.md 做案件范围确认、历史辖区解析，并给出检索策略与线索

  5. 出报告前跑证据审计

    按 README 要求，在写最终报告前先检查登记表引用完整性

    bash原始来源命令 
    python scripts/audit_evidence.py --case-dir ~/kinship-cases/my-case

    预期结果：输出引用完整性问题与仍需补证的条目摘要

  6. 把静态 HTML 报告渲染成 PDF

    需要已安装 Chrome/Chromium/Edge 或设置 CHROME_PATH；HTML 里用本地或内嵌图片

    bash原始来源命令 
    python scripts/build_pdf.py --html ~/kinship-cases/my-case/pdf-source/report.html --out ~/kinship-cases/my-case/report.pdf

    预期结果：生成 report.pdf；若渲染失败，已有输出 PDF 会被保留

原始来源：DenisSergeevitch/ex-ussr-kinship-research ↗