Sourcefold 文件手記

02 / 可重現交接

不使用客戶文件,建立可重現的研究交接資料夾

把三組可執行範例與簡單清單放在一起,但不假裝它們是同一來源自動抽出的結果。

好的重現範例應讓別人不用傳送機密報告,也能重跑發現。三個工具各自提供合成資料,但檔名相近不表示有來源關係;需要明確寫下關係,並標示哪些只是示範。

獨立輸入保持獨立

把三個公開儲存庫 clone 到同一工作目錄,保留各自的 examples/。帳本包含虛構披露資料;雙語文件是另行撰寫的文字;PDF 則是空白幾何頁面。它們不是同一份真實公告自動抽出的三種版本。

handoff/
  filing-evidence-ledger/examples/sample.json
  bilingual-markdown-map/examples/source.md
  bilingual-markdown-map/examples/zh-Hant.md
  pdf-geometry-inspector/examples/sample.pdf
  manifest.json

清單記錄假設,不放機密

{
  "kind": "synthetic-training-bundle",
  "automatic_cross_format_extraction": false,
  "review_questions": ["missing-period", "missing-image", "rotation"]
}

記下各工具版本或 commit、執行命令及輸出目錄。清單不應包含 API key、客戶名稱或私有路徑。重新執行 CLI,不要手改輸出的 JSON。個別命令可參考三個產品站:證據帳本、雙語對照與幾何檢查。

提供明確的練習終點

預期發現是兩筆欄位不完整的證據、一個未配對的原文章節,以及刻意混合尺寸與方向的三頁 PDF。這只證明範例有實際執行工具,不驗證客戶文件。先請接收者重跑合成範例,再換入獲准處理的本機資料。

這是普通資料夾約定,不是新工作流框架。沒有工具監看另一個資料夾或上傳結果。使用真實資料時,來源到引文、來源到譯文的關係都要人工建立,原檔也應保留在自己的存取控制下。