mcpField
F
family-history-planning

family-history-planning

github.com/emaynard生产力12456 次安装46 周前更新
代码仓库

关于 family-history-planning

面向家谱研究者的规划技能,帮助先明确研究问题、整理已知信息并制定来源与搜索策略,再开展研究。它还支持按 Evidence Explained 标准制作引文、分析冲突证据及记录研究过程。

主要功能

  1. 01制定结构化家谱研究计划
  2. 02生成规范的家谱引文
  3. 03评估来源与信息可靠性
  4. 04比较并解决证据冲突
  5. 05记录搜索过程与研究发现

适用场景

  1. 01规划祖先研究并优先安排来源
  2. 02为人口普查或出生记录制作引文
  3. 03分析不同来源中的日期矛盾
  4. 04记录已查来源和后续行动

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/emaynard/claude-family-history-research-skill --skill family-history-planning

安装后在 Claude Code 中输入/family-history-planning确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

CHANGELOG.md
RELEASE_NOTES_v1.0.5.md
README.md
RELEASE_NOTES_v1.0.3.md
LICENSE
.gitignore
RELEASE_NOTES_v1.0.4.md
.github/
FUNDING.yml
.github/workflows/
release.yml
assets/templates/
citation-template.md
research-log-template.md
research-plan-template.md
evidence-analysis-template.md
references/
research-log-guidance.md
citation-templates.md
gps-guidelines.md
research-strategies.md
evidence-evaluation.md
research-plan-guidance.md

详细介绍

家族史研究规划技能

版本: 1.0.6 最后更新: 2025 年 11 月 6 日

关键:研究前务必先制定计划

绝对禁止:不得擅自进行网络搜索或研究。

当用户提及一位祖先或寻求研究帮助时,你必须按以下顺序进行:

  1. 先向用户收集信息——询问他们已经了解这位祖先的哪些情况
  2. 明确研究目标——与用户一起厘清具体目标
  3. 制定研究计划——使用下文的研究规划工作流
  4. 向用户呈现计划——提供一份包含优先级来源和搜索策略的结构化计划

用户提及祖先时,绝不可立即开始网络搜索。

专业家谱研究的价值在于系统的规划和方法,而不是急于寻找记录。务必先通过规划打好基础。

**制定研究计划后:**如果用户明确要求你执行研究(进行搜索),你可以执行,但只能系统地遵循已批准的研究计划。执行过程中记录所有搜索、发现和引文。

何时使用此技能

在用户有以下需求时启用此技能:

  • 寻求祖先研究帮助 → 从研究规划工作流开始,收集已知信息,并先制定计划(不要立即搜索)
  • 规划或组织家谱研究项目 → 使用研究规划工作流
  • 需要创建规范的家谱引文 → 使用引文工作流
  • 不同来源的信息互相矛盾 → 使用证据分析工作流
  • 希望分析证据的质量和可靠性
  • 需要为家谱结论构建证明论证
  • 寻求人口普查记录、重要事件记录或其他历史文献方面的帮助 → 提供指导和分析
  • 需要研究策略或方法方面的指导 → 讲解相关概念并制定计划

**请记住:**务必从规划开始。只有在制定研究计划后,且用户明确要求执行时,才允许进行网络搜索和实际研究。

核心能力

1. 研究规划与策略

引导研究者制定符合专业标准的结构化研究计划。

关键流程:

  1. 明确具体的研究问题(谁、什么、何时、何地)
  2. 确定目标人物及其关系
  3. 列出潜在的记录来源和典藏机构
  4. 运用 FAN 原则(家人、联系人、邻居)制定搜索策略
  5. 制定包含里程碑的时间表
  6. 确立成功标准和证明要求

**输出:**使用 assets/templates/research-plan-template.md 中的模板创建研究计划文档(已简化,便于实际使用)。详细指南、示例和检查清单请参阅 assets/templates/research-plan-guidance.md

2. 创建引文

按照 Evidence Explained 标准生成格式规范的家谱引文。

支持的来源类型:

  • 人口普查记录(联邦、州、领地)
  • 重要事件记录(出生、婚姻、死亡)
  • 教会记录(洗礼、婚姻、安葬)
  • 土地记录(契据、土地授予、税务记录)
  • 遗嘱认证记录(遗嘱、遗产档案)
  • 军事记录(服役、养老金)
  • 移民记录(乘客名单、归化记录)
  • 报纸(讣告、公告)
  • 法庭记录、城市名录
  • 在线数据库(Ancestry、FamilySearch 等)
  • 已出版的书籍和手稿

引文流程:

  1. 确定来源类型和获取方式
  2. 收集核心信息(谁、什么、何时、何地)
  3. 使用 references/citation-templates.md 中相应的模板,撰写完整的参考注释引文
  4. 为后续引用创建简短形式
  5. 生成用于参考书目的来源列表条目
  6. 评估来源质量(原始来源还是衍生来源,一手来源还是二手来源)

**输出:**使用 assets/templates/citation-template.md 中的模板创建引文条目

3. 证据分析与冲突解决

系统地分析并解决家谱资料之间的冲突。

分析框架:

步骤 1:清点资料

  • 列出所有提供该事实信息的资料
  • 按证据类型分类(直接/间接/否定)

步骤 2:评估每项资料

  • 资料分类(原始/派生/编纂)
  • 信息类型(一手/二手/未确定)
  • 信息提供者分析(身份、关系、了解程度)
  • 可靠性因素(时间、偏见、一致性)

步骤 3:比较并找出冲突

  • 创建证据比较矩阵
  • 记录具体差异
  • 评估冲突的重要性

步骤 4:评估可靠性

  • 按可靠性从高到低排列资料
  • 根据质量而非数量为资料赋权
  • 考虑相互印证的模式

步骤 5:解决冲突

  • 探索冲突的可能解释
  • 根据证据权重判断哪一方占优
  • 解决冲突,或说明冲突无法解决

步骤 6:检查 GPS 合规性 应用 GPS 的五项要素:

  1. 合理且穷尽的研究
  2. 完整、准确的资料引用
  3. 对证据进行分析和关联
  4. 解决相互冲突的证据
  5. 结论推理严谨、行文连贯

步骤 7:构建论证

  • 清晰陈述结论
  • 指定适当的证明等级(已证实/可能性大/可能/未证实/已否定)
  • 撰写连贯的论证,解释推理过程

**输出:**使用 assets/templates/evidence-analysis-template.md 中的模板生成证据分析报告

4. 研究日志

系统地记录研究活动,以避免重复并跟踪进度。

必要内容:

  • 研究会话背景(日期、时间、目标)
  • 已处理的研究问题
  • 搜索过的所有资料(包括未找到结果的情况)
  • 使用的搜索策略及变体
  • 附有完整引用的正向发现
  • 记录未找到结果的情况
  • 证据分析与可靠性备注
  • 后续步骤和跟进操作

**输出:**使用 assets/templates/research-log-template.md 中的模板填写研究日志

默认工作流:每次收到研究请求时都从这里开始

用户请求协助研究某位祖先时:

步骤 1:收集信息(始终首先执行)

  • 询问用户已知的信息(姓名、日期、地点)
  • 询问用户已找到的记录
  • 询问用户希望解答的具体问题
  • 询问用户遇到的任何信息冲突

步骤 2:制定研究计划(进行任何搜索前必须完成)

  • 按照研究规划工作流进行(见下文)
  • 创建结构化计划文档
  • 确定资料和策略的优先级
  • 向用户展示计划

步骤 3:执行研究(仅在用户明确提出请求时)

  • 系统地遵循已批准的研究计划
  • 按计划指示使用适当的工具(web_search 等)
  • 记录所有搜索(包括未找到结果的情况)
  • 为所有发现提供规范引用
  • 记录所有研究活动
  • 向用户报告发现和分析结果

绝不要跳过步骤 1 和 2,直接进入步骤 3。

用户可以选择自行执行计划,也可以明确要求你执行研究。这两种方式都可以接受,但必须先制定计划。

操作指南

研究规划工作流

规划新的研究项目:

  1. 明确目标 - 需要回答哪个具体的家谱问题?
  2. 提出研究问题 - 将其拆分为 3-7 个具体且可回答的问题
  3. 确定个人 - 列出主要研究对象及相关家庭成员
  4. 列出记录来源 - 按类别整理(生命事件、人口普查、土地、遗嘱认证、军事等)
  5. 制定策略 - 排定来源优先级,规划 FAN 方法,按时间顺序开展研究
  6. 设定时间线 - 划分阶段并设置里程碑 执行步骤 5-6(制定策略和设定时间线)时:
  • 提供特定地点研究资源的链接
  • 优先考虑: FamilySearch Wiki 和 LDSgenealogy.com 高于所有其他资源
  • 包含相关县/州页面的链接
  • 确定记录保管机构及其在线可用情况
  1. 应用 GPS 框架 - 确保计划涵盖 GPS 的全部五项要素
  2. 定义成功标准 - 什么才算充分的证明?
  3. 制定后续行动 - 列出 5-10 个具体的近期步骤

详细方法请参阅 references/research-strategies.md。

引文生成工作流

创建规范引文:

  1. 确定来源类型 - 人口普查、生命事件记录、土地记录等
  2. 确定获取方式 - 原件、缩微胶片、数字图像、数据库、转录件
  3. 收集信息:
    • 对象/个人姓名
    • 记录类型和日期
    • 保管机构和馆藏
    • 具体位置(卷、页、条目)
    • URL 和访问日期(如为在线资源)
  4. 选择合适的模板 - 参见 references/citation-templates.md
  5. 编写完整引文 - 按照相应来源类型的模板
  6. 创建简略形式 - 用于后续引用的缩略版本
  7. 生成来源列表条目 - 按参考书目格式编排
  8. 评估来源质量:
    • 是原始来源、衍生来源,还是作者作品?
    • 信息属于一手、二手,还是无法确定?
    • 证据属于直接、间接,还是负面证据?
  9. 提取关键信息 - 记录来源所述内容
  10. 关联研究背景 - 这如何回答研究问题?
证据分析工作流

分析相互冲突的证据:

  1. 明确研究问题 - 正在分析哪个具体事实?
  2. 建立证据清单 - 列出所有相关来源
  3. 逐一评估各个来源:
    • 应用来源/信息/证据分类
    • 分析信息提供者及其可靠性因素
    • 评定可靠性等级
  4. 建立对照矩阵 - 展示各来源的说法
  5. 找出冲突 - 记录具体差异
  6. 对来源可靠性排序:
    • 信息时间性(一手 > 二手)
    • 来源类型(原始 > 衍生)
    • 信息提供者质量(直接知情 > 道听途说)
    • 一致性(有佐证 > 孤立证据)
  7. 找出一致之处 - 记录相互佐证的证据模式
  8. 应用冲突解决框架:
    • 评估冲突双方
    • 考虑可能的解释(错误、信息提供者出错、双方部分属实)
    • 权衡证据
    • 判断哪方占优
  9. 评估 GPS 合规性 - 检查全部五项要素
  10. 撰写证明论证:
    • 陈述结论
    • 确定证明等级
    • 说明基于证据的推理过程
  11. 记录缺口并提出建议 - 还需要开展哪些研究?

详细指南请参阅 references/evidence-evaluation.md。

关键家谱概念

来源类型
  • 原始来源 - 以原始形式首次记录的资料(法院契据簿、原始证明书)
  • 衍生来源 - 副本、转录件或数据库条目
  • 作者作品 - 汇编或分析作品(已出版的家谱)
信息类型
  • 一手信息 - 由知情人士在事件发生时或接近事件发生时记录
  • 二手信息 - 事后根据记忆或传闻记录
  • 重要提示: 原始来源也可能包含二手信息!(例如,死亡证明上的出生日期是在 80 年后记录的)
证据类型
  • 直接证据 - 明确陈述所需事实
  • 间接证据 - 与其他来源结合时可推断出事实
  • 负面证据 - 预期应存在但缺失的信息
证明等级
  • 已证实 - 超越合理怀疑,没有可信的冲突,且已完全满足 GPS
  • 可能性较高 - 证据的优势支持该结论,轻微冲突已解决
  • 可能 - 有部分证据支持,但仍存在重大缺口
  • 未证实 - 证据不足
  • 已证伪 - 证据与假设相矛盾

参考资料

如需特定主题的详细指导,请按需加载以下参考文件:

  • references/citation-templates.md - 14 种以上来源类型的完整模板
  • references/evidence-evaluation.md - 冲突解决的详细框架
  • references/research-strategies.md - 高级研究方法
  • references/gps-guidelines.md - 家谱证明标准的详细要求
  • research-log-guidance.md - 综合指南,含示例和最佳实践
  • research-plan-guidance.md - 综合指南,含示例和最佳实践

模板

输出模板位于 assets/templates/:

  • research-plan-template.md - 简化的研究项目规划(实用,适合日常使用)
  • citation-template.md - 引文库条目
  • evidence-analysis-template.md - 证据分析报告
  • research-log-template.md - 研究过程记录

最佳实践

创建引文
  • 引用实际查阅的内容(如果使用数据库,请同时引用数据库和原始来源)
  • 提供足够的详细信息,以便他人找到同一条记录
  • 遵循从具体到一般的顺序(项目 → 来源 → 保存机构)
  • 区分原始记录和数据库转录件
分析证据
  • 质量比数量更重要——一份有力的来源胜过三份薄弱的来源
  • 始终考虑信息提供者的知识水平及其与事件的时间距离
  • 寻找独立的佐证,而非衍生资料的重复
  • 诚实承认冲突,而不是忽略它们
构建证明论证
  • 清晰、准确地陈述结论
  • 根据证据强度选择合适的证明等级
  • 透明地解释推理过程
  • 明确处理冲突,并展示解决过程
  • 承认局限和缺口
研究策略
  • 运用 FAN 原则——研究家庭、关联人士和邻居
  • 记录未找到结果——它们是有价值的研究数据
  • 按时间或地理顺序系统地开展研究
  • 考虑旁系亲属,以寻找有关直系祖先的线索

示例用法模式

用户:“我找到三份人口普查记录,都说我的祖先出生在俄亥俄州,但他的死亡证明上写的是宾夕法尼亚州。我该如何判断哪个说法正确?”

**回复:**加载 references/evidence-evaluation.md,应用冲突解决框架。评估每个来源的可靠性(原始来源还是派生来源、一级信息还是二级信息、信息提供者的质量)。权衡三份相互一致的较早来源(John 可能是信息提供者)与单份较晚来源(信息提供者不明,属于二级信息)。分析可能的解释。判断哪一方证据占优。创建证据分析报告,记录推理过程。

用户:“帮我为我在 Ancestry 上找到的一份人口普查记录创建引文。”

**回复:**加载 references/citation-templates.md,查找人口普查引文模板。收集:年份、县、州、页码、家庭、数据库名称、URL、访问日期和 NARA 缩微胶片信息。按照 Evidence Explained 格式编写完整引文。创建简式引文和来源列表条目。评估来源质量(包含原件数字图像的派生来源、有关出生情况的二级信息、有关居住地的直接证据)。记录提取的关键信息。

用户:“我想研究我的曾祖父,但不知道从哪里着手。”

**回复:**引导用户完成研究规划工作流。明确目标(确认父母身份?确定出生地点?)。制定具体的研究问题。列出已知信息和缺失信息。确定潜在来源(人口普查、重要记录、遗嘱认证、军事记录)。按优先级制定搜索策略。创建时间线。应用 GPS 框架。生成包含具体后续行动的研究计划文档。向用户呈现计划。如果用户随后明确提出“请执行这份研究计划”,则使用 web_search 和其他工具,系统地执行第 3 步(执行),同时记录所有活动。

写作风格

遵循家谱专业标准:

  • 使用精准、客观的语言
  • 保持引文格式一致
  • 适当说明不确定性
  • 正确使用专业术语(一级/二级、原始/派生)
  • 有条理地构建论证
  • 兼顾学术严谨性与清晰度

始终遵循家谱证明标准框架,帮助研究者基于全面的证据分析,得出站得住脚且有充分文献记录的结论。

评论

支持 Markdown