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. **不編造書目。** DOI 查不到就回報「查無」，不要用 LLM 記憶補書目資料—— 那正是幻覺文獻的來源。腳本已內建此行為（CrossRef 404 直接報錯）。 3. **摘要有著作權。** CrossRef 回傳的 abstract 著作權通常仍屬出版社。 存進自己的文獻庫供個人研究閱讀屬合理使用，但**不要公開重製散布**， 文獻回顧中也應改寫轉述而非整段照抄。 4. **PDF 抽不到 DOI 是常態，不是失敗。** 掃描版 PDF（無文字層）、舊文獻、 工作論文都可能沒有 DOI。此時改用 `--doi` 手動指定，或誠實告知該篇需人工建檔。 5. **引用代碼要與論文一致。** 產出的 `key`（如 `Aguinis2012`）若與使用者慣用的 BibTeX key 不同，以使用者的為準——這關係到內文引用能否對上。 ## 工作流程 ### Step 1｜建立文獻庫 ```bash python scripts/litmatrix.py init -d ./lit ``` 產生 `01_pdf/`（PDF 原檔）、`02_notes/`（閱讀筆記）、`03_output/`（Excel） 與 `library.json`（單一事實來源）。 ### Step 2｜逐篇加入 ```bash python scripts/litmatrix.py add -d ./lit --pdf 01_pdf/paper.pdf # 自動找 DOI python scripts/litmatrix.py add -d ./lit --doi 10.1177/0149206311436079 ``` 加入前可先