Skip to content
Back to search

xungen

寻根:让 AI 帮你查家族史的 Agent Skill。族谱整理、年号干支换算、祖籍地名、国内家谱和海外华人移民档案、证据分级、世系图和 GEDCOM · Chinese genealogy & family history skill

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/du8866-nice--xungen/badge.svg)](/listings/du8866-nice--xungen)

HTML

<a href="/listings/du8866-nice--xungen"><img src="/api/listings/du8866-nice--xungen/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

用 [skills](https://github.com/vercel-labs/skills) 命令行安装,Claude Code、Codex 等支持 Agent Skills 的工具都能用:

npx skills add https://github.com/DU8866-nice/xungen --skill xungen

加 `--global` 装到用户目录。也可以手动复制:

git clone https://github.com/DU8866-nice/xungen.git
cp -r xungen/skills/xungen ~/.claude/skills/     # Claude Code
cp -r xungen/skills/xungen ~/.codex/skills/      # Codex

在 Claude 应用里用的话,把 `skills/xungen` 文件夹压缩成 zip,在设置的 Skills 里上传。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 127 lines
  1. # 寻根 xungen
  2. 一个 Agent Skill,让 AI 帮你查家族史:整理长辈的口述和老族谱,换算年号干支,把祖籍对到今天的地名,告诉你去哪里查国内家谱和海外华人移民档案,最后画出世系图。每条结论都标出处,查不到就说查不到。
  3. [English](README.en.md)
  4. ![一个虚构家族的世系图:五代人,按字辈分行,框线表示证据强弱,在世的人已隐去](examples/chen-taishan/tree.svg)
  5. 上图由 `family.py` 从一份 JSON 生成,家族是虚构的。实线框有两个以上出处,虚线框只有一个,点线框只有口述;在世的人自动隐去。
  6. ## 为什么做这个
  7. 查家史难在三件事:资料散在族谱、地方志、档案馆和海外移民档案里;“光绪庚子”“民国卅八年”“新宁县”“Sunning”都要换算才能对上;直接问 AI,它很容易把名人接到你家谱上,或者编出不存在的档案号。
  8. 这个 skill 给 AI 一套家史研究的做法:先问家里,再按证据查;原始记录、转录和口述分开记;同名同姓不乱合并;远祖和迁徙传说单独标出;在世的人不外泄。
  9. ## 能做什么
  10. - **长辈访谈**:问题清单和家中实物清单(族谱、墓碑、户口簿、侨批、老照片),访谈记录怎么整理。
  11. - **纪年换算**:明、南明、清的年号,民国,台湾日治时期的日本年号,满洲国年号,干支、生肖、虚岁,都能换算到公历年份。年号和干支对不上、农历年底跨年时会提醒。
  12. - **地名定位**:旧地名对到今天的县和村,海外档案里的粤语拼法(Sunning、Hoiping、Heungshan……)对回中文。
  13. - **名字和字辈**:谱名、字号、“某氏”、过继、入赘、谱中用语,海外档案里的拼写。
  14. - **国内资料**:上海图书馆和国家图书馆的家谱、FamilySearch 中国家谱、地方志、CBDB、档案馆、烈士名录、侨批、台湾日治户籍。
  15. - **海外华人档案**:澳洲 CEDT 和 RecordSearch、加拿大人头税登记、美国排华法案档案、新加坡族谱和旧报纸。
  16. - **证据分级**:互证、单一来源、口述、推测、有矛盾;攀附名人、联宗统谱、大槐树和珠玑巷等迁徙传说、纸生仔等常见陷阱。
  17. - **输出**:研究报告、世系图 SVG、世系表、能导入 Gramps 和 MyHeritage 等软件的 GEDCOM,以及写给档案馆、宗亲会的信件草稿。
  18. ## 安装
  19. 用 [skills](https://github.com/vercel-labs/skills) 命令行安装,Claude Code、Codex 等支持 Agent Skills 的工具都能用:
  20. ```bash
  21. npx skills add https://github.com/DU8866-nice/xungen --skill xungen
  22. ```
  23. 加 `--global` 装到用户目录。也可以手动复制:
  24. ```bash
  25. git clone https://github.com/DU8866-nice/xungen.git
  26. cp -r xungen/skills/xungen ~/.claude/skills/ # Claude Code
  27. cp -r xungen/skills/xungen ~/.codex/skills/ # Codex
  28. ```
  29. 在 Claude 应用里用的话,把 `skills/xungen` 文件夹压缩成 zip,在设置的 Skills 里上传。
  30. ## 用法
  31. 直接跟 AI 说:
  32. ```
  33. 我想查我太公的事。只知道他叫陈振华,台山人,民国初年去过澳洲,后来回乡了。从哪里开始?
  34. ```
  35. ```
  36. 这是我家族谱的几页照片,帮我整理成世系,看看哪些地方对不上。
  37. ```
  38. ```
  39. 墓碑上写“光绪廿六年岁次辛丑三月初五生”,是哪一年?
  40. ```
  41. ```
  42. 春节要回老家,帮我准备问爷爷奶奶的问题。
  43. ```
  44. 它会先问清楚你要解决的问题和已知信息,再一步步整理、查找、评估,最后交给你报告和世系图。
  45. ## 脚本
  46. 两个脚本都只用 Python 标准库,可以单独运行。
  47. ```bash
  48. $ python3 skills/xungen/scripts/when.py 光绪廿六年岁次辛丑 民国三十八年 虚岁73 --ref 2026
  49. 光绪廿六年岁次辛丑 → 1900 年(庚子,属鼠) [清·光绪]
  50. - 记载的干支是辛丑,但 1900 年是庚子,两者矛盾,要么年数抄错,要么干支抄错,回原件核对。
  51. 民国三十八年 → 1949 年(己丑,属牛) [中华民国·民国]
  52. 虚岁73 → 1954 年(甲午,属马)
  53. ...
  54. ```
  55. ```bash
  56. python3 skills/xungen/scripts/family.py check family.json # 检查关系、辈分、字辈、年份、出处
  57. python3 skills/xungen/scripts/family.py all family.json -o out/ # 世系图、世系表、GEDCOM、检查结果
  58. python3 skills/xungen/scripts/family.py all family.json -o share/ --public # 隐去在世者,用于分享
  59. ```
  60. 数据格式见 [data-format.md](skills/xungen/references/data-format.md)。完整的虚构示例在 [examples/chen-taishan](examples/chen-taishan),包括[研究报告](examples/chen-taishan/report.md)、[世系表](examples/chen-taishan/tree.md)和[检查结果](examples/chen-taishan/check.md)。
  61. ## 原则
  62. - 不编造人名、年份、出处和档案号,查不到就写查过哪里。
  63. - 不把家族接到古代名人身上,除非有同时代记录。
  64. - 在世的人不外泄,分享版自动隐去。
  65. - 写给档案馆、宗亲会的信只起草,由你决定发不发。
  66. - 需要付费、注册、实名的网站,告诉你怎么用,由你自己操作。
  67. ## 资料入口
  68. 链接和规则核对于 2026 年 11 月,各机构可能调整。发现失效或变化,欢迎提 issue。
  69. | 方面 | 文件 |
  70. |---|---|
  71. | 访谈 | [interview.md](skills/xungen/references/interview.md) |
  72. | 名字和字辈 | [names.md](skills/xungen/references/names.md) |
  73. | 地名 | [places.md](skills/xungen/references/places.md) |
  74. | 纪年 | [dates.md](skills/xungen/references/dates.md) |
  75. | 国内资料 | [sources-china.md](skills/xungen/references/sources-china.md) |
  76. | 海外华人档案 | [sources-overseas.md](skills/xungen/references/sources-overseas.md) |
  77. | 证据和陷阱 | [evidence.md](skills/xungen/references/evidence.md) |
  78. | 隐私 | [privacy.md](skills/xungen/references/privacy.md) |
  79. | 报告和信件模板 | [report.md](skills/xungen/references/report.md) |
  80. 菲律宾、印尼、泰国、越南、拉美等地的华人档案还没有整理,欢迎补充。
  81. ## 测试
  82. ```bash
  83. python3 -m unittest discover -s tests -v
  84. ```
  85. ## 参与
  86. 见 [CONTRIBUTING.md](CONTRIBUTING.md)。最需要的是:各地档案和家谱收藏的查询经验、海外华人档案的入口、`when.py` 还不认识的纪年写法。
  87. ## 许可证
  88. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.