literature-analysislisted
Install: claude install-skill LoWeiLee/academic-ai-workflow
# 逐篇文獻深度分析技能[現行版,見檔尾版本區]
> 本檔守決策層(Step 0、批次協議、三種執行模式、寫作原則、段落涵蓋規則、完成清單回寫)。雙檔結構與格式規格下放 `references/`,於產出階段才載入:
> - `references/file-specs.md` —— 切分線規格、知識檔/應用檔結構與 frontmatter YAML、_index.json、自我檢核模板、Obsidian 相容性(產出/拆分階段載入)
> - `references/example-literature-knowledge.md`/`references/example-literature-application.md` —— 知識檔/應用檔的格式與深度基準範本(Step 0 強制讀取,隨 skill 同捆,正本隨 skill 包版控)
>
> 雙檔架構(知識檔 paper-agnostic 正本+應用檔綁定 paper_id)、三模式(全新分析/複用/既有檔批次拆分依 `_index.json` 是否命中 citation_key 自動切換)、vault 佈局與變更歷程詳見 repo CHANGELOG,本檔不嵌補丁說明。
---
## 環境偵測(所有讀取動作之前,最先執行)
本 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`、既有產出檔或凍結狀態回讀斷點,在無工作區模式下改為請使用者於開場提供前輪產出(附件或貼上內容);無法取得時,明示「本次為無工作區模式,跨對話狀態不自動續作」後,以本次提供的材料為準推進。
**啟動宣告中必須載明當前模式**:「工作區模式」或「無工作區模式」。
## 📌 執行步驟 Step 0(所有步驟之前,無例外)
**在進入任何分析動作之前,必須依序完成以下步驟:**
1. **讀取兩份範本**(雙份,隨 skill 同捆):
- `references/example-literature-knowledge.md`:知識檔的格式與深度基準
- `references/example-literature-application.md`:應用檔的格式與深度基準
兩份範本是本次輸出的格式與深度品質錨點。範本對齊優先於規則窮舉。範本正本隨 skill 包版控、與升版同