fund-literature-review-writer

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: "fund-literature-review-writer"
description: "撰写NSFC申请书的国内外研究现状及发展动态分析+文献评述。Invoke when user asks to write NSFC literature review, 国内外研究现状, 文献综述, 文献评述, or 1.2部分 of NSFC proposal."
---

# NSFC 文献综述与文献评述写作技能

## 核心定位

本技能不是"写文献"，而是**将文献转化为"NSFC研究论证结构的一部分"**。

在用户已有研究构想基础上，学习NSFC成功项目中的"文献综述—文献评述"组织方式，对文献部分进行学术化重构、逻辑组织优化、批判性归纳、面向NSFC表达体系的规范化输出。

## 触发条件

当用户需要撰写以下内容时触发：
- NSFC申请书的"1.2 国内外研究现状及发展动态分析"
- NSFC申请书的"文献综述"部分
- NSFC申请书的"文献评述"部分
- 用户明确要求"写文献综述"、"写文献评述"、"写研究现状"

## 核心原则

1. **不预设固定结构**：文献综述的结构从16本NSFC成功本子中"学习出来"，不是"写死出来"
2. **不文献摘要堆叠**：禁止文献摘要式输出，文献必须融入论证
3. **不脱离NSFC语境**：文献服务NSFC研究论证结构
4. **强调结构归纳能力**：从本子中归纳组织逻辑，不固化模板
5. **强调批判性评述能力**：文献评述是结构性判断，不是总结
6. **强调文献服务研究问题能力**：文献→研究问题/方法/创新的完整论证链

## 技能范围

本技能只负责 NSFC 申请书中立项依据的 1.2 国内外研究现状及发展动态分析 + 文献评述 部分。需读取用户研究构想以确保文献服务研究论证。

## 知识库引用

执行本技能前，必须读取以下知识库文件：

### knowledge_base/
1. `literature_review_style_guide.md`：文献综述写作风格指南
   - 文献综述的整体叙事逻辑
   - 主题划分策略（4种方式）
   - 段落组织规范（论证功能，非固定句式）
   - 文献引用格式
   - 文献间连接词使用规律
   - 表格使用规范
   - 综述→评述的过渡方式
   - 批判性表达规律
   - 字数规范

2. `literature_review_patterns.md`：文献综述组织逻辑范式
   - 五种项目类型的典型文献综述组织
   - 方法型/机制型/系统型文献组织差异
   - 文献群的构建逻辑
   - 文献→研究问题/方法/创新映射模式
   - 文献评述的4种批判性判断类型
   - 文献组织的选择决策树

3. `literature_mapping_rules.md`：文献→研究问题/方法/创新映射规则
   - 文献→研究问题映射规则
   - 文献→方法合理性映射规则
   - 文献→创新合理性映射规则
   - 与用户研究构想的对齐机制

### references/
1. `info_form.md`：用户输入信息表
2. `output_skeletons.md`：输出骨架（论证功能，非固定模板）
3. `validation_menu.md`：验证菜单
4. `anti_patterns.md`：反模式清单
5. `literature_search_strategy.md`：文献检索策略
6. `fund-search-workflow.md`：完整搜索工作流（脚本调用链、降级策略）

### search/（内化搜索包）
- `search/scripts/`：搜索脚本（search_all.py, citation_finder.py, rank_and_filter.py, format_bibtex.py, dedup.py，另有 tier_utils/exa_search/search_google_scholar 等内部依赖，无需直接调用）
- `search/references/`：搜索参考文档（search-strategy.md, api-reference.md, data-schema.md, journal-tiers.md）
- `search/data/`：期刊数据（priority_journals.csv, blacklist_journals.csv）
- `search/.env.example`：API 密钥模板（需复制为 .env 并填写）
- `search/requirements.txt`：Python 依赖（requests, exa-py, scholarly）

## 工作流程

### Step 1: 理解研究目标
- 读取用户研究构想（研究主题、研究目标）
- 确定文献综述的总体方向

### Step 2: 解析研究内容
- 读取用户研究内容（通常3-5个）
- 确定文献综述的主题划分

### Step 3: 识别关键科学问题
- 读取用户关键科学问题（通常1-3个）
- 确定文献评述的研究空白方向

### Step 4: 检索文献
- 读取 `references/fund-search-workflow.md` 获取完整搜索流程

**4a. 构造主题检索查询**：从研究主题/内容/方法/关键科学问题生成英文查询组

**4b. 英文文献搜索**（四源并行）：
```bash
# 设置环境变量（从 search/.env.example 复制为 search/.env 并填写）
# 对每个英文查询组执行：
python search/scripts/search_all.py --query "{英文查询}" --email "$OPENALEX_EMAIL" --output runs/cf/query_N.json
# 合并所有查询组：
python search/scripts/citation_finder.py merge runs/cf/query_*.json --output runs/cf/merged.json
# 补算期刊层级：
python search/scripts/citation_finder.py enrich-tiers --input runs/cf/merged.json --priority-csv search/data/priority_journals.csv --blacklist-csv search/data/blacklist_journals.csv --output runs/cf/enriched.json
```

**4c. Zotero MCP / 本地文件搜索**（可选）：按 `fund-search-workflow.md` Step 4/5 执行

**4d. 全源合并去重排序**：
```bash
python search/scripts/dedup.py --input runs/all_merged.json --output runs/deduped.json
python search/scripts/rank_and_filter.py --input runs/deduped.json --weights relevance=0.4,journal_tier=0.3,citation_count=0.2,recency=0.1 --output runs/final.json
python search/scripts/format_bibtex.py --input runs/final.json --output runs/nsfc_references.bib
```

### Step 5: 确认文献集合
- 直接使用 Step 4d 输出的 `runs/final.json`（已去重、排序、筛选）
- 如需调整筛选权重或优先级，参见 `references/literature_search_strategy.md`

### Step 6: 自动归纳文献组织方式
- 根据 `literature_review_patterns.md` 选择文献组织方式
- 根据项目类型选择典型组织模式
- 根据研究内容划分文献主题
- 根据研究方法确定方法介绍侧重点

### Step 7: 生成文献综述
- 按 `literature_review_style_guide.md` 和 `output_skeletons.md` 生成文献综述
- 主题划分策略（4种方式，根据研究内容选择）
- 段落组织（论证功能：引入→举例→对比→转折→总结）
- 文献引用格式（作者-年份制优先）
- 表格使用（方法研究型默认使用）
- 嵌入式评述（每个主题段末）

### Step 8: 生成文献评述（独立模块）
- 按 `output_skeletons.md` 生成文献评述
- 评述方式（嵌入式/独立式，根据项目类型选择）
- 批判性判断（方法性/数据适用性/模型解释能力/研究边界）
- 引出本项目研究方向

### Step 9: 校验与用户研究构想一致性
- 按 `validation_menu.md` 逐项验证
- 文献综述与研究内容的一致性检查
- 文献评述与研究问题的对应检查
- 文献→方法→创新的闭环检查
- 引用格式一致性检