personal-voice-calibrationlisted

# 個人筆法校準（Personal Voice Calibration） 目的：把**使用者本人的筆法**與**目標期刊慣例**轉成可操作的風格指引，讓後續編修有所本，而不是憑空套用通用學術英文。本技能專責「個人筆法」；泛用的「學術英文原則」文件（使用者從網路蒐集或自行整理者）由 [`academic-principles-calibration`](../academic-principles-calibration/SKILL.md) 處理。 ## 兩件產出（分清楚） 1. **共用摘要 `writing-style/personal-voice/personal-voice.md`**（跨所有論文）：從 `writing-style/personal-voice/sources/` 裡使用者自己寫的文章蒸餾出的「筆法 DNA」。只在個人素材變動時更新。 2. **該篇風格指引 `papers/<paper>/style-guide.md`**（每篇一份）：結合 `personal-voice.md` ＋ `academic-principles.md` ＋ `style-defaults.md` ＋ 該篇 `target-journal-samples/`，落定這一篇實際依循的規範。 ## 何時執行 - 專案第一次設定。 - 使用者在 `writing-style/personal-voice/sources/` 或 `papers/<paper>/target-journal-samples/` 新增、更換、刪除檔案後。 - 使用者明確說「重新校準」「更新我的筆法」「更新風格指引」。 ## 步驟 ### A. 更新共用個人筆法摘要（個人素材有變動時） 1. **盤點素材**：列出 `writing-style/personal-voice/sources/` 下的檔案。 - 空 → 不硬產出。以標準說法提示使用者把自己寫過、已發表或滿意的英文論文／段落放進去（md／docx／pdf 皆可），並說明沒有個人素材時只能靠學術原則與通用預設。 2. **讀取素材**：md 用 Read 直接讀；**docx／pdf 重用** `source-document-extraction` 的腳本在 `research` conda 環境抽成文字再讀（見下「抽取指令」）。重點看「英文怎麼寫」，不是研究內容。 3. **維護「§0 素材檔案庫索引與搜尋協定」**：`personal-voice.md` 採**索引＋蒸餾兩層**設計。§0 是給 AI 的檢索地圖，須隨 sources 變動更新——一份**檔案庫清單表**（每個來源檔：檔名／內容與分類／何時該搜尋它）＋每檔**分類錨點**（`grep -n "^## \|^### " <檔>` 取得的標題作穩定錨點，行號僅輔助、會位移）＋一段**搜尋協定**（grep/Read 範例指令）。目的：蒸餾必有損失，索引讓完整素材始終可檢索，尤其素材增多時。 4. **萃取並寫入 `writing-style/personal-voice/personal-voice.md`**：用下方模板；每條盡量附一個從素材觀察到的短例（節錄 <15 字，不整段照抄）。**更新而非重寫**——保留使用者手動補充區。 5. **不刪除 sources**：原始文件一律保留。 ### B. 產生／更新該篇 style-guide.md 1. **讀四類輸入**：`personal-voice.md`（個