literature-synthesislisted
Install: claude install-skill LoWeiLee/academic-ai-workflow
# 跨文件主題綜整技能 v1.1.2
> 本檔守決策層與雙檔規格。論證判斷框架下放 `references/reasoning-framework.md`(四支共用副本,第二階段分析按需載入);兩份範本(example-literature-synthesis-knowledge/-application)同捆於 `references/`,第零階段強制讀取。雙檔架構(綜整知識檔 paper-agnostic 長期累加正本+綜整應用檔綁定 paper_id)、三模式(Mode A 全新綜整/Mode B 增量更新/Mode C 既有檔批次拆分,依「主題資料夾內有無綜整知識檔」自動切換,不使用索引檔)為現行設計。Mode C 為一次性遷移工具,置於檔末附錄。變更歷程見 repo CHANGELOG,本檔不嵌補丁/遷移公告。
---
## 核心目標
將多篇文獻的個別分析,整合為一份**帶有明確文獻歸屬的理論知識圖譜**,並拆為兩份檔案各司其職:
**綜整知識檔(synthesis-knowledge)=文獻的內在屬性**
這個主題「確信什麼/爭什麼/假設什麼」。paper-agnostic,對使用者的任一論文皆可複用。承載:場域狀態導讀、理論版圖、關鍵概念節點庫、隱性假設清單。它是長期累加的單一正本。
**綜整應用檔(synthesis-application)=對本研究的定位與寫作指引**
這個主題「對當前這篇論文意味著什麼、缺口在哪、第二章怎麼鋪」。綁定單一 paper_id,可多份。承載:本主題對當前研究的整體意義、研究缺口地圖、文獻回顧架構建議(含概念與共識的章節使用對照)、三句話版本。
**切分核心原則**:paper-bound 內容(對當前研究意涵、概念使用建議、缺口挑選與定位、章節指引)一律歸應用檔;文獻的內在屬性歸知識檔。
這兩份檔案共同滿足兩個使用需求:知識檔是**理解工具**(對主題的系統性全局掌握)兼**寫作素材**(每個論點都標記來源,供 chapter-drafting 直接生成正式引用);應用檔是**鋪稿藍圖**(為這一篇論文把素材組織成可撰寫的結構)。
---
## 環境偵測(所有讀取動作之前,最先執行)
本 skill 以 `00_專案控制/` 作為控制檔的預設路徑,此路徑假設一個**持久的工作區資料夾**(Claude 桌面應用的 Cowork 模式,或 Claude Code)。**若該路徑不存在,代表使用者在無工作區環境(例如 claude.ai 網頁版)執行本 skill。此時一律進入「無工作區模式」,不得以「檔案缺失」為由拒絕啟動。**
無工作區模式的三條規則:
1. **控制檔改在別處尋找**。依序查找同名檔案:對話附件 → 專案知識庫(claude.ai 的 Project files)→ 使用者於本次對話明確指定的位置。找到即視同滿足必讀要求,正常推進;三處皆無才回報缺失,並明確告知使用者可透過對話附件或 Project files 提供。**此規則覆蓋本 skill 所有「缺漏即拒絕啟動」的硬閘門條文**——閘門的實質要求是「讀得到該檔的內容」,不是「該檔位於特定路徑」。
2. **產出改以可下載檔案交付**,不嘗試寫入 `05_輸出/` 或任何工作區路徑。晉升流程(審定後移入正式位置)改由使用者手動完成,於交付時一併說明。
3. **跨 session 狀態改由使用者提供**。本 skill 若依賴 `05_輸出/progress-log.md`、既有產出檔或凍結狀態回讀