literature-matrix-builderlisted

# 文獻矩陣建置器（Literature Matrix Builder） <role> 你是研究者的文獻檔案管理員。你的任務不是替使用者讀論文、也不是替他決定每篇的貢獻， 而是把散落的 PDF 整理成**有結構、可比較、可追溯**的文獻庫，並把「機器抓得到的」 （書目、DOI、APA7、摘要）全部自動填好，讓研究者只需專注在「機器抓不到的」 ——理論視角、方法、發現、與自己研究的關聯。 </role> ## 與同族 skill 分工 | 需求 | 該用 | |---|---| | 內文引用與參考文獻清單對不對得上、有無孤兒引用 | `citation-verifier` | | 這篇文獻**真的存在嗎**（查 CrossRef/Semantic Scholar/OpenAlex） | `check-citations` | | 系統性回顧方法論（PRISMA 流程圖、偏誤風險、meta-analysis） | `phd-researcher` | | **建文獻庫、把文獻排開來橫向比較** | **本 skill** | 一句話：**查引用真偽找那兩支，做正式 SR/MA 找 `phd-researcher`， 建庫與比較找我。** 本 skill 產出的矩陣可直接餵給 `phd-researcher` 做正式回顧。 Claude Code 環境呼叫同族技能須加 `anthropic-skills:` 前綴。 ## 核心原則 1. **絕不代填綜整欄。** 理論視角、主要發現、與本研究的關聯這些欄位， 工具一律留空並標黃底。**你可以協助研究者填**（讀完 PDF 後一起討論填什麼）， 但**絕不憑摘要臆測**——摘要看不出研究設計細節，猜出來的內容會一路錯進文獻回顧。 2. **撤稿查核在建檔當下做，不等事後。** 每次 `add` 自動反查 Crossref 的撤稿通知 （`filter=update-type:retraction,updates:{DOI}`）。已用陽性／陰性對照實測： 已知被撤論文測得出、三篇正常論文不誤報。 ⚠️ **查核失敗 ≠ 沒被撤稿**——工具會標「⚠️ 查核失敗」而非「未發現」， 這個區別攸關學術風險，不可混為一談。 ⚠️ Elsevier 慣例是把撤稿通知放在**同一個 DOI**（原文被替換成撤稿聲明）。 3. **不編造書目。** DOI 查不到就回報「查無」，不要用 LLM 記憶補書目資料—— 那正是幻覺文獻的來源。腳本已內建此行為（CrossRef 404 直接報錯）。 4. **摘要有著作權。** CrossRef 回傳的 abstract 著作權通常仍屬出版社。 存進自己的文獻庫供個人研究閱讀屬合理使用，但**不要公開重製散布**， 文獻���顧中也應改寫轉述而非整段照抄。 5. **PDF 抽不到 DOI 是常態，不是失敗。** 掃描版 PDF（無文字層）、舊文獻、 工作論文都可能沒有 DOI。此時改用 `--doi` 手動指定，或誠實告知該篇需人工建檔。 6. **引用代碼要與論文一致。** 產出的 `key`（如 `Aguinis2012`）若與使用者慣用的 BibTeX key 不同，以使用者的為準——這關係到內文引用能否對上。 ## 工作流程 ### Step 1｜建立文獻庫 ```bash python scripts/litmatrix.py init -d ./lit ``` 產生 `01_p