Efficient Literature Survey

efficient-literature-survey

**中文** | [English](README_EN.md)

---

高效文献综述工作流

一个 Claude Code skill，用于高效处理大量**多格式文献**（PDF、DOCX、TXT、MD、EPUB）并撰写**绪论**和**文献综述**，实现 **99%+ 的 Token 节省**。

它能做什么

将 10-100 篇文献转换为一个结构化的文献地图，然后输出完整的论文绪论和文献综述——**不需要逐字阅读每篇文献**。

支持**自定义章节结构**或选择**默认模板**（中文/英文论文框架），自动适配用户指定的引用格式与输出语言。

阶段	动作	输出
0. 配置	确认语言、引用格式、章节结构、研究定位（题目/摘要/关键词均可）、文献文件夹路径、输出类型（学位论文/综述论文）	配置清单 + 研究方向记录
1. 提取	脚本遍历文献文件夹提取元数据（支持子文件夹递归）	JSON 报告 + Markdown 汇总（标题/作者/页数/字数/期刊/卷期页/DOI/扫描检测）
2. 聚类	按主题聚成 5-8 个簇，对照用户研究定位评分相关度（Direct/Adjacent/Peripheral/Tangential），标定精读优先级	文献地图（P0/P1/P2 三级阅读策略）—— 用户确认后继续
3. 精读	按优先级差异化阅读（全文/摘要+结论/仅摘要）—— 阅读计划用户确认后执行	提取的论点与可引用原文
3.5 大纲确认	根据阅读摘要生成 bullet-point 级别写作大纲（论点、引用编号、预估字数、专著映射）—— 用户确认后方可进入 Stage 4	结构化大纲（待确认）
4. 撰写	按用户给定的章节框架输出，引用格式符合学术规范	格式化的绪论 + 文献综述草稿

---

5 分钟快速上手

场景：你有一个文件夹的文献，想快速写综述

**Step 1：安装**

mkdir -p ~/.claude/skills/
cp -r efficient-literature-survey ~/.claude/skills/
pip install -r requirements.txt

**Step 2：打开 Claude Code，说一句**

"帮我写文献综述，文献在 `/Users/alice/Documents/references`"

**Step 3：Claude 会经历以下流程**

轮次	Claude 做什么	你需要做什么
1	扫描文献文件夹（含子文件夹），告诉你找到多少篇、什么格式、有没有扫描件	看结果，确认文献数量
2	问你：语言、引用格式、研究题目、章节结构模板	回答这 4 个问题
3	做主题聚类，给你看分类和优先级（P0/P1/P2）	确认分类，或说"把某篇移到 P0"
4	给你阅读计划：精读哪几篇、略读哪几篇	确认或调整阅读深度
5	按优先级阅读文献，提取论点	等 Claude 读完
6	输出绪论 + 文献综述初稿	审阅，提出修改意见

**整个过程中你可以在任意轮次叫停、调整、修改。**

---

支持格式矩阵

| 格式 | 元数据提取 | pages | word_count | 期刊/卷期页/DOI | 扫描检测 | 依赖 | |-----