usuyukiso/genealogy-biography

傳記

輸入描述一個人的生平——通常是時間順序表（每行一個事件，來自戶籍簿、告解名冊、人口普查、法院/行政檔案），但也可能是筆記、連結或文件。輸出內容為可讀的傳記及來源頁面。準確性比文采更重要：家譜研究者會根據文件核對每一項陳述。

輸出內容的存放位置。 所有內容皆寫入網站專案 family_tree_github/（MkDocs Material；詳見其 README.md）：

項目	位置
人物頁面	family_tree_github/docs/people/P1000-<slug>.md
檔案記錄	docs/sources/archives/A1000-<slug>.md
書籍/出版品	docs/sources/books/B1000-<slug>.md
照片	docs/sources/photos/F1000-<slug>.md（圖片在 docs/assets/images/people/）
網頁	docs/sources/websites/W1000-<slug>.md
地點（聚落）	docs/places/PLC1000-<slug>.md
地點索引	docs/places/index.md
人物索引	docs/people/index.md
來源索引	docs/sources/index.md
選單	family_tree_github/mkdocs.yml 中的 nav:

舊的根目錄檔案（sources.md 對應編號 3000–3011、people.md、*_biography.md）為舊版：請勿寫入。切勿在網站任何地方提及舊編號——沒有 legacy_id、沒有「Прежний №」欄位或行。

ID。 前綴加上從 1000 開始的四位數字，取自檔案名稱的開頭。ID 永不更改，即使頁面被刪除也不會重複使用。取得下一個可用的 ID，並用以下指令檢查重複：

python3 .claude/skills/genealogy-biography/scripts/next_id.py next A A P   # A1010, A1011, P1005
python3 .claude/skills/genealogy-biography/scripts/next_id.py find "23И, оп. 2, д. 24"   # 是否已存在？
python3 .claude/skills/genealogy-biography/scripts/next_id.py list

連結。 只寫 ID；網站的鉤子（hooks/id_links.py）會將其轉換為連結：[A1006] → 標記為「A1006」的來源頁面連結；[P1000] → 標記為該人物姓名的連結；[жена](P1000) → 使用自訂文字的連結。切勿在內部頁面中寫入檔案路徑或 URL。未知的 ID 會導致建置失敗。

1. 讀取輸入

如果輸入是時間順序表（.ods、.xlsx、.csv），請先載入 chronology-table 技能並遵循其指示：它會匯出表格、對應欄位，並給出每行的事件列表及其來源。並非每份傳記都從表格開始——如果用戶提供其他材料（筆記、連結、文件），則以該材料為基礎，跳過表格步驟。

檢查該人物是否已有頁面（next_id.py find "<姓氏>"，以及 docs/people/index.md 頂部的表格）。標記為 !!! warning "Страница-заготовка" 的頁面是佔位頁面：將傳記寫入該頁面，保留其 ID 和檔名。

1a. 讀取 Yandex Archive 的掃描

對於每個包含 yandex.ru/archive/catalog/... 連結的記錄，取得掃描的辨識文字：

python3 .claude/skills/genealogy-biography/scripts/yandex_archive.py page "<url>"

它會輸出文件標題和目錄路徑（архив / фонд / опись / дело），然後是該頁面的辨識文字行。使用這些資訊來：

• 找到關於該人物的記錄並引用它（請參閱下方的「引用記錄」）；
• 補充表格缺少的細節：記錄編號、洗禮日期與出生日期、孩子的姓名與父母、教父母、婚禮見證人、神父、死因、年齡；
• 從目錄路徑中填補缺少的檔案參考資訊（фонд/опись/дело）。

這些文字是機器辨識的手寫體。表格欄位會以獨立行輸出的形式呈現，因此請根據順序比對日期和年齡到對應的欄位，並謹慎處理數字和罕見名稱。若要尋找表格中沒有連結的記錄（例如死亡記錄），請嘗試 yandex_archive.py search "<名字形式、地點>"。其搜尋結果片段來自結構化標記，有時比頁面文字行更容易閱讀（例如年齡）。記錄您嘗試過的每一次搜尋，以便能報告負面結果。

記錄每一次檔案審查。 在審查一個案卷或一系列掃描之前，請檢查 family_tree_github/internal/checks/reviewed_documents.md（內部文件，不在網站上）——可能已經被搜尋過。在審查之後——無論是針對此人閱讀的戶籍簿、一次 Yandex Archive 搜尋、為尋找缺失記錄而瀏覽的案卷——請在該文件中新增或擴展其條目，包括負面結果：內容（аrchive, fond, opis, delo 或 scan path）、日期、方式（所有頁面 / 抽樣 / 僅搜尋）、搜尋內容（名字、地點）、結果（找到 → [A…] 或幀數；未找到 → «искали …, не нашли»）、尚未閱讀的部分。大型掃描收藏需使用 archive-scan-search 技能進行搜尋；整本戶籍簿需使用 metric-book-index 技能建立索引。

2. 提取事實並進行比對

在寫作之前，應為每個事件準備一個事實列表，附上支援來源（當輸入為表格時由 chronology-table 技能提供），並比對年齡、名字變體、身份變更、家庭和空白處。請清楚說明身份轉變；參見 references/terms.md。

3. 撰寫傳記

輸入表格不是來源——切勿提及它。 時間順序表（以及用戶提供的任何其他工作筆記）是用戶的私人研究檔案；網站的讀者不知道它的存在，也對家譜或檔案搜尋一無所知。因此，在所有輸出文字中：

• 請勿寫出「在表格中」、「根據表格」、「來自表格」、「在原始資料中」、「欄位」、「第N行」等。僅引用真實來源：檔案記錄、掃描、出版品、網站。
• 如果某些資訊未知，請以一般性用語說明：「在現有來源中未提及此事」、「記錄的逐字文字無法取得」、「檔案代號未知」、「無法找到掃描」。
• 來自註解欄位的轉錄稱為「расшифровка」（記錄的文字），而不是「表格中的轉錄」。
• 表格本身的錯誤和空白（錯誤的行政區、提供的是洗禮日期而非出生日期、沒有地點的行、拼錯的名字）不在傳記中討論：在文字中使用正確的值，並在聊天中向用戶報告表格問題（步驟 6）。僅在真實來源中出現時，才在備註中提及替代拼寫。
• 為一般讀者解釋一切：記錄類型是什麼、縮寫或身份是什麼意思。

每個事實陳述都必須有輸入數據作為基礎。 切勿發明日期、地點、親屬、職業、原因或動機。如果數據沒有資訊，則保持沉默或清楚說明記錄未顯示該資訊。僅允許對數據直接支持的合理推論使用「可能」、「很可能」等詞語（例如，從新地點的記錄推斷出的遷徙），並且必須標記為推論。一個工作假設（例如兩個記錄是同一人）應放在「Исследовательские заметки」下，以 Предположение (не подтверждено документами). 開頭。

逐鏈證明親屬關係。 每對父母-子女和配偶的連結都是一個獨立的陳述，有其各自的來源；祖父母或更遠的祖先僅通過一系列經證明的連結來證明。在撰寫連結時：

• 說明其依據。一個僅在一份記錄中被命名的連結，應寫為「根據1919年的出生記錄」，而不是來自多個來源的確定事實。僅在文件獨立的情況下，它才被視為由多份文件確認：同一份記錄的副本、摘錄、證明或複述視為同一來源。
• 父名僅能指出父親的名字（「Яковлевич」= 父親名叫 Яков），但不能顯示是哪個 Яков。相同的姓氏、村莊或家庭也不是親屬關係的證據。
• 保持完全同名者（相同的名字和父名，相同的村莊）為不同的人物，直到記錄能區分他們為止；族譜外的同名者則有自己的比較頁面。
• 當記錄有歧異時（例如母親的父名），應並列兩個版本，並說明誰提供了資訊及時間：事件當時或由當事人本人製作的記錄通常比後期由他人提供的記錄更具分量。將其記錄在 research_open_questions.md 中。
• 家族傳說或編輯者的筆記是線索，而非文件：應標註為「根據編輯者的筆記」，切勿將其呈現為記錄。

簡短的歷史背景在能幫助讀者理解記錄時是受歡迎的（例如庫頁島流放地是什麼、契訶夫1890年的人口普查是什麼、擔任教父母的意義為何、「ссыльнопоселенец」身份允許做什麼）。保持簡短、一般性，並清楚說明是關於那個時代——切勿將其呈現為關於此人的事實。

務必描述到訪過的地點。 每當此人到訪過特定場所——寺廟、神社、教堂、修道院、博物館、城堡、農場、工廠、公園、學校、紀念碑等時，請添加一段簡短的描述（2-5句話）：它是什麼、確切位置在哪裡、何時由何人創立、以什麼聞名、訪客在那裡能看到什麼。查閱事實（官方網站、Wikipedia、百科全書）並保持準確；此人與該場所的個人聯繫（與誰、做了什麼）僅來自數據。城市、城鎮或地區本身不需要描述（可選加一句簡短背景）。如果數據中的場所名稱看起來拼寫錯誤或找不到，請在文字中使用最可能的真實名稱，並在備註部分記下原始拼寫。

引用記錄。 只要記錄的文字可取得（表格註解欄位中的轉錄，或來自掃描的辨識文字），請逐字引用它，格式如下：Согласно записи в метрической книге: «Корсаковской тюрьмы ссыльно-каторжная Евдокія Андреева Лапина…» [A1000]. 這適用於每個事件：出生、死亡（包括死因和年齡，按原文寫）、婚姻、教父母身份、人口普查和告解名冊。

• 保留原始拼寫，包括改革前的正字法和名字變體。
• 在傳記中，默默修正明顯的 OCR 錯誤。在來源頁面上，用方括號顯示它們：Корсаковскаго [в распознании: «Корожковскаго»]。
• 歡迎解釋和說明，並留在文字中。將它們放在引文旁邊，而不是替代它，例如「…(старости)」——即因年老去世。
• 如果沒有文字（表格中無轉錄，且無掃描或掃描無法辨識），請在文字中明確說明：「Дословный текст записи недоступен, скан найти не удалось.」切勿將記錄改寫成彷彿被引用過的樣子。
• 引文來源在其來源頁面上說明，而非在傳記中（參見步驟 4 的「文字出處標籤」）。這些標籤以及記號 [?]、[…]、[неразборчиво]、[в распознании: «…»] 的一般說明只存在於 docs/sources/index.md 的「Откуда взяты цитаты」區段一次；請勿在人物頁面上重複。

行內引用。 在每個陳述之後，在方括號中添加來源 ID：...родились близнецы Иван и Мария [A1000]. 連續多個：[B1000][A1005]。使用的每個 ID 都必須有對應頁面，且此人的每個來源頁面都應至少被引用一次。

連結人物。 當提到擁有自己頁面的人物時，請連結他們：在正文中使用 [Егор Почеревин](P1001)，在列表中使用 [P1001]（渲染為全名）。沒有頁面的人物保持純文字——不要為每個人創建頁面。

語言。 使用用戶要求的語言書寫。如果未指定，則使用表格內容的語言（俄語表格則用俄語）。保留姓名和引用的記錄文字為其原始形式；當以另一種語言書寫時，轉寫姓名並在首次提及時在括號中給出原文。

結構（根據人物的生平調整標題；沒有數據的部分則跳過）：

---
person_id: P1005
name: "名字 父名 姓氏"
name_variants:
  - "<文件中記載的方式>"
birth_date: "1885-07-15"        # ISO；範圍用 "1851/1857"；未知為 ""
birth_date_status: confirmed    # confirmed | probable | unknown
death_date: ""
death_date_status: unknown
parents: [P1000]                # 僅限擁有頁面的人物 ID
spouses: []
children: []
sources: [A1000, A1005]
---

# <全名>（<出生年份或範圍> – <逝世年份>）

<一段摘要：是誰、在哪裡、以3-4句話概述生平軌跡。>

請勿添加解釋來源代碼的段落（「Коды в квадратных скобках — ...」、來源類型、OCR 限制）。此類一般性說明只存在於 docs/research-method.md 和 docs/sources/index.md 中，不在人物頁面上。

## <生平時期 1，例如：起源>
## <...>
## <最後歲月與逝世>

## 家庭
<配偶與子女，附日期，以簡短列表呈現；連結擁有頁面的人。>

## 年表
| 日期 | 事件 | 地點 | 來源 |
<緊湊表格，輸入的每一行對應一行。>

## 文件備註
<年齡、名字、日期的歧異；空白；值得進一步研究的未解決問題；哪些記錄沒有可用文字；需要與掃描比對的 OCR 讀取結果。>

## 研究筆記
<假設和研究線索，每個標記為「Предположение」。如果沒有則跳過。>

## 來源
- [A1000] — <簡短描述>
- ...

## 相關人物
- <角色> — [P1000]

4. 來源頁面（存在任何來源時為必需）

每個獨立文件一個頁面，由所有傳記共享。如果多行引用同一記錄，請使用相同的 ID。在建立頁面之前，請搜尋它（使用 next_id.py find 依檔案參考、掃描 URL、原始代碼搜尋）：如果存在，則重複使用該 ID，將任何關於此人的新細節或引用添加到該頁面，並將此人添加到其 related_people 和「Связанные персоны」中。

選擇前綴 —— 根據材料的角色，而非存放位置：

• A — 檔案記錄：戶籍簿條目、告解名冊、人口普查卡、文件。頁面包含檔案參考（аrchive, fond, opis, delo, list）和掃描連結。即使參考未知，但很明顯是檔案記錄，也使用 A。
• D — 具體文件或檔案（本地掃描/PDF、編輯者的筆記、證明）。目前 D 來源不發布： 不要創建

…

[truncated for translation]