家族族譜研究
一個可攜帶的技能；所有研究說明、目錄、模板和核心腳本都已捆綁。無需單獨安裝技能、連接器、帳戶或 API 金鑰。實際研究仍需要主機的網路工具。以使用者語言回覆。
載入與解析
將包含此檔案的目錄視為技能根目錄。從其所屬文件中解析所有引用的檔案；不論 shell 的當前工作目錄為何，請使用絕對解析路徑來呼叫腳本。請勿假設特定的家目錄、作業系統、瀏覽器、模型、工具名稱或技能註冊表。
閱讀政策，然後閱讀捆綁的研究引擎。這些是一般的本機檔案：即使主機無法呼叫巢狀技能，也應直接讀取它們。專案政策管轄存取與隱私；上游政策管轄證據推理。使用固定的副本；僅在明確的維護請求下才檢查或取代相依套件。
研究循環
- 理解問題與輸入。 如果未提供，請詢問已有的材料。將提供的族譜、GEDCOM、文件與家族記述視為線索；保留原始資料。提取人物、競爭身份、事件日期/地點、宣稱的關係、來源與未解決的連結。族譜中的斷言並非證明。
- 開始或恢復一個私人案例。 閱讀案例管理。使用
scripts/init_case.py --case-dir <案例> --research-question <問題>在技能外部進行初始化。恢復現有的註冊表與搜尋，而非重置它們。舊的toolkit_path是位置提示；如果已移動，請使用當前載入的技能根目錄。 - 選擇有用的查核。 根據歷史地點、事件日期與記錄類型，查閱區域檔案館與其他來源。使用鄉鎮查找來處理變更的邊界或名稱。目錄覆蓋範圍仍不完整；關鍵字匹配並非保管決定。
- 閱讀並保留證據。 使用可用的網路、影像與文件工具。將允許的本機證據與來源出處、日期、參考文獻與 checksum 一起儲存；記錄空白與被封鎖的搜尋。保留原始拼寫、不確定的讀法與替代方案。將同名人物分開，直到有區別性證據支持身份決定。
- 評估每個關係。 遵循捆綁的證據協議。將身份解析與親緣關係分開。檢查每個邊緣、來源依賴性與矛盾的記錄；保留生物學、法律、收養與家庭區別。不進行自動合併或信心百分比。
- 審計與解釋。 執行
scripts/audit_evidence.py --case-dir <案例>。完整性錯誤必須修正；誠實的證據警告則保留。解釋有來源引用的關係鏈、替代方案、已搜尋的覆蓋範圍、被封鎖的路徑以及下一步有用的查核。儲存恢復位置，並避免在沒有新理由的情況下重複搜尋。 - 交付要求的檢視。 閱讀輸出慣例以了解離線族譜/報告與 GEDCOM 匯出工具。預設輸出排除在世者與狀態不明的人員。私人輸出需要使用者的請求；不得發佈結果。
當可選問題等待答案時，繼續進行有用的授權研究。當問題在其記錄的證據層級得到解答、有用的可到達路徑已用盡，或使用者停止任務時，即停止。缺口是有效的結果。
主機能力
- 檔案與 Python 3.9+： 核心腳本僅使用標準函式庫。可選的上游工具會記錄其自身的相依套件。
- 無 shell/Python： 使用可用的檔案工具維護捆綁的 CSV 模板；手動執行審計規則，並將自動化審計標記為未執行。請勿宣稱已產出匯出或已執行的檢查。
- 無網路： 分析提供的材料與本地參考；提出建議的搜尋路徑，但不宣稱已檢查。
- 無可靠的影像/文件閱讀器： 保留來源並標記
needs-vision；請勿捏造閱讀結果。 - 無持久性檔案： 提供附有來源引用的暫定分析，並說明未儲存為案例。請勿暗示持久的註冊表或可恢復性。
無需模型委派。如需安裝或主機整合，請參閱相容性。