用 AI 辅助家谱研究时，按 autoresearch…

当你需要用 Claude Code 等 AI 自主研究循环来扩展家族树、整理 Obsidian/Markdown 家谱库并交叉验证来源时使用。

适用场景

解决思路

1. 克隆仓库：`git clone https://github.com/mattprusak/autoresearch-genealogy.git`，然后 `cd autoresearch-genealogy`。
2. 将 `vault-template/` 复制到你的 Obsidian vault 中：`cp -r vault-template/ ~/path/to/your/ObsidianVault/genealogy/`。
3. 也可将 `vault-template/` 复制到任意 Markdown 编辑器目录：`cp -r vault-template/ ~/Documents/my-genealogy/`。
4. 无需包管理器或构建步骤，按纯 markdown/prompt 项目使用。
5. 按仓库结构定位资源：`prompts/` 放 12 个 autoresearch prompts；`vault-template/` 放 19 个 Obsidian vault 起始文件；`archives/` 放 24 个国家/地区档案指南；`reference/` 放 9 个方法论文档；`workflows/` 放 7 个分步流程；`examples/` 放 6 个匿名示例。
6. 打开 `vault-template/Family_Tree.md`，从自己开始向前填写已知家族信息，并写入 YAML frontmatter（如 `title`、`last_updated`、`generations_documented`、`lines_active`），按 Generation 1/2/3 等代际组织。
7. 拍照或扫描证书、信件、明信片等实体文档，然后使用 OCR 工作流：`workflows/ocr-pipeline.md`。
8. 在 Claude Code 中运行 autoresearch prompt：`/autoresearch prompts/01-tree-expansion.md` 来扩展家族树。
9. 运行审计和验证 prompt：`/autoresearch prompts/02-cross-reference-audit.md`。
10. 每个 prompt 按结构编写/检查：`## Goal`、`## Metric`、`## Direction`、`## Verify`、`## Guard Rails`、`## Iterations`、`## Protocol`。
11. 用 `prompts/01-tree-expansion.md`：通过网络研究把每个分支向前推进。
12. 用 `prompts/02-cross-reference-audit.md`：查找并修复家族树与来源之间的差异。
13. 用 `prompts/03-findagrave-sweep.md`：为已故祖先定位 Find a Grave memorial。
14. 用 `prompts/04-gedcom-completeness.md`：将 GEDCOM 文件与 vault 数据同步。
15. 用 `prompts/05-source-citation-audit.md`：验证每个人至少有 ≥2 个独立来源。
16. 用 `prompts/06-unresolved-persons.md`：识别并解决文档中的未命名人物。
17. 用 `prompts/07-timeline-gap-analysis.md`：找出应有记录但缺失的人生事件时间线缺口。
18. 用 `prompts/08-open-question-resolution.md`：系统性处理所有开放研究问题。
19. 用 `prompts/09-bygdebok-extraction.md`：从数字化地方历史书中提取数据。
20. 用 `prompts/10-colonial-records-search.md`：搜索 1800 年以前的美国殖民时期记录。
21. 用 `prompts/11-immigration-search.md`：定位乘客名单和归化记录。
22. 用 `prompts/12-dna-chromosome-analysis.md`：分析逐染色体祖源数据。
23. 在 Claude Code 终端或聊天中运行 prompt，例如：`/autoresearch prompts/08-open-question-resolution.md`。
24. 带指定 vault 路径上下文运行 prompt，例如：`/autoresearch prompts/03-findagrave-sweep.md --context vault-template/Family_Tree.md`。
25. 创建人物文件时使用 `vault-template/templates/person.md`，填写 YAML：`full_name`、`birth_date`、`birth_place`、`death_date`、`death_place`、`father`、`mother`、`spouse`、`children`、`confidence`、`sources`、`open_questions`、`last_updated`。
26. 在人物文件中填写 `## Life Events` 表格（Event、Date、Place、Source）、`## Sources`、`## Open Questions`、`## Notes`。
27. 转录证书时使用 `vault-template/templates/certificate.md`，填写 YAML：`document_type`（birth | death | marriage | baptism）、`document_date`、`repository`、`file_reference`、`transcribed_by`、`transcription_date`、`confidence`。
28. 在证书模板中逐字转录文档，提取 `Subject`、`Date`、`Place`、`Witnesses/Informants`、`Officiant`，记录 `Discrepancies` 并链接图片 `![[filename.jpg]]`。
29. 按 `vault-template/Research_Log.md` 模式写研究日志：记录日期、`Prompt run`、`Iterations`、`Metric start`、`Metric end`、执行过的搜索、负结果、新增开放问题。
30. 给每个人物文件应用置信度分层：`Strong Signal` = 两个或更多独立一次来源一致；`Moderate Signal` = 一个一次来源，或两个二次来源一致；`Speculative` = 逻辑推断、DNA 提示，或单个二次来源；写入 YAML `confidence`。
31. 研究时查阅 `archives/` 对应国家/地区指南，了解免费/付费记录位置、AI 可直接访问 vs 需要浏览器、各时代可用记录类型。
32. 查阅 `archives/` 中的国家/地区指南文件：`ireland.md`、`england-wales.md`、`scotland.md`、`norway.md`、`sweden.md`、`poland.md`、`germany.md`、`italy.md`、`france.md`、`spain-portugal.md`、`netherlands.md`、`austria.md`、`hungary.md`、`russia-ukraine.md`、`usa-colonial.md`、`usa-immigration.md`、`usa-census.md`、`usa-vital-records.md`、`african-american.md`、`canada.md`、`mexico-latin-america.md`、`australia-new-zealand.md`、`jewish-genealogy.md` 等。
33. 在相关 prompt 中参考地区档案指南，例如 `prompts/09-bygdebok-extraction.md` 中查阅 `archives/norway.md`，搜索 Rogaland 地区 1750–1900 的 Bygdebok 收藏。
34. 新发现祖先时按 Pattern 1：从 `vault-template/templates/person.md` 创建人物文件；按来源数量设置 confidence；加入 `Family_Tree.md` 正确代际；在 `Research_Log.md` 记录发现；把未解决问题加入 `Open_Questions.md`；运行 `02-cross-reference-audit.md` 检查冲突。
35. 解决日期冲突时按 Pattern 2：在 `Open_Questions.md` 建条目（如 Q-042），列出冲突证据、状态、下一步；运行 `/autoresearch prompts/07-timeline-gap-analysis.md` 并聚焦目标人物和问题编号。
36. DNA 到家谱映射时按 Pattern 3：在 `vault-template/Genetic_Profile.md` 写入 `test_company`、`test_date`、`ethnicity_summary`（region、percentage）；运行 `/autoresearch prompts/12-dna-chromosome-analysis.md`。
37. 移民研究循环时按 Pattern 4：运行 `/autoresearch prompts/11-immigration-search.md`；该 prompt 会从 `Family_Tree.md` 拉出所有外国出生祖先；搜索乘客名单（Ellis Island、Ancestry、FamilySearch）；搜索归化记录（NARA、Ancestry）；用船名、到达日期、港口更新人物文件；为每个未解决祖先记录负结果。
38. 使用 `reference/confidence-tiers.md`、`reference/source-hierarchy.md`、`reference/dna-guardrails.md`、`reference/naming-conventions.md`、`reference/gedcom-guide.md`、`reference/common-pitfalls.md`、`reference/glossary.md`、`reference/ai-capabilities.md`、`reference/case-for-autoresearch.md` 作为方法论参考。
39. AI 编造来源时，在 prompt 会话中加入 Guard Rails：不要虚构 census record URL 或 Ancestry record ID；无法直接链接的来源标记为“reported”而非“confirmed”；所有新声称都需要真实 URL 或 repository reference；不确定时加入 `Open_Questions.md`，不要猜测。
40. vault 文件与 GEDCOM 不同步时，运行 `/autoresearch prompts/04-gedcom-completeness.md`，比较 GEDCOM 中每个人与 vault 人物文件并标记不匹配。
41. 名称变体导致重复人物文件时，查阅 `reference/naming-conventions.md`；注意挪威农场名变化（Haugen → Bakke）、波兰名字教堂记录拉丁化（Stanisław → Stanislaus）、爱尔兰 Anglicization（Ó Briain → O'Brien → Bryan）、census 拼写变化（“Sakkarias” vs “Zacharias”）；在人物 YAML 中添加 `name_variants` 别名列表。
42. autoresearch 循环运行过久时，在 prompt 的 `## Iterations` 字段显式设置上限，例如：最多运行 3 次迭代，然后停止并输出摘要供人工审查。
43. OCR 对旧文档效果差时，参阅 `workflows/ocr-pipeline.md`；一般做法：以至少 600 DPI 拍照；使用均匀漫射光，不用闪光灯；运行 OCR 前做对比度调整预处理；用 `vault-template/templates/transcription.md` 并排记录 OCR 输出和人工修正。
44. 贡献新 archive guide 或 prompt 时：遵循现有文件结构和 YAML frontmatter 模式；所有示例使用占位名，不包含真实家族数据；开 PR 并简要描述新增的地区或记录类型。

适用边界 · 注意事项

• 没有 Claude Code 或等价的可执行 `/autoresearch` 的 AI 研究循环环境，且不愿手动执行同等搜索/更新/验证流程时，不适用。
• 无法访问网络、家谱数据库、档案网站或本地文档时，不适用。
• 需要完全自动化且不能人工复核、不能接受负结果记录和置信度分层时，不适用。