| 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申请书的"文献评述"部分
- 用户明确要求"写文献综述"、"写文献评述"、"写研究现状"
核心原则
- 不预设固定结构：文献综述的结构从16本NSFC成功本子中"学习出来"，不是"写死出来"
- 不文献摘要堆叠：禁止文献摘要式输出，文献必须融入论证
- 不脱离NSFC语境：文献服务NSFC研究论证结构
- 强调结构归纳能力：从本子中归纳组织逻辑，不固化模板
- 强调批判性评述能力：文献评述是结构性判断，不是总结
- 强调文献服务研究问题能力：文献→研究问题/方法/创新的完整论证链
技能范围
本技能只负责 NSFC 申请书中立项依据的 1.2 国内外研究现状及发展动态分析 + 文献评述 部分。需读取用户研究构想以确保文献服务研究论证。
知识库引用
执行本技能前，必须读取以下知识库文件：
knowledge_base/
-
literature_review_style_guide.md：文献综述写作风格指南
- 文献综述的整体叙事逻辑
- 主题划分策略（4种方式）
- 段落组织规范（论证功能，非固定句式）
- 文献引用格式
- 文献间连接词使用规律
- 表格使用规范
- 综述→评述的过渡方式
- 批判性表达规律
- 字数规范
-
literature_review_patterns.md：文献综述组织逻辑范式
- 五种项目类型的典型文献综述组织
- 方法型/机制型/系统型文献组织差异
- 文献群的构建逻辑
- 文献→研究问题/方法/创新映射模式
- 文献评述的4种批判性判断类型
- 文献组织的选择决策树
-
literature_mapping_rules.md：文献→研究问题/方法/创新映射规则
- 文献→研究问题映射规则
- 文献→方法合理性映射规则
- 文献→创新合理性映射规则
- 与用户研究构想的对齐机制
references/
info_form.md：用户输入信息表output_skeletons.md：输出骨架（论证功能，非固定模板）validation_menu.md：验证菜单anti_patterns.md：反模式清单literature_search_strategy.md：文献检索策略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. 英文文献搜索（四源并行）：
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. 全源合并去重排序：
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 逐项验证
- 文献综述与研究内容的一致性检查
- 文献评述与研究问题的对应检查
- 文献→方法→创新的闭环检查
- 引用格式一致性检查
- 字数检查
- 文献质量检查
- 反模式检查（按
anti_patterns.md）
适配机制
用户已有文献
- 优先使用用户已有文献
- 补充检索缺失的文献
- 验证用户文献的质量和相关性
用户无文献
- 完全依赖自动检索
- 按
literature_search_strategy.md 执行检索
- 生成完整的BibTeX引用库
用户部分文献
- 以用户已有文献为基础
- 补充检索缺失的文献
- 确保文献覆盖所有研究内容
输出格式
输出1：文献综述主体 + 文献评述（MD文件）
# 1.2 国内外研究现状及发展动态分析
## 1.2.1 主题1（对应研究内容1）
[引入段]
[子主题1.1 文献群]
[子主题1.2 文献群]
[主题评述段（嵌入式评述）]
## 1.2.2 主题2（对应研究内容2）
[引入段]
[子主题2.1 文献群]
[子主题2.2 文献群]
[主题评述段（嵌入式评述）]
## 1.2.3 主题3（对应研究内容3）
[引入段]
[子主题3.1 文献群]
[子主题3.2 文献群]
[主题评述段（嵌入式评述）]
## 1.2.X 文献评述（独立评述小节，可选）
[开头段]
[主题评述段1]
[主题评述段2]
[主题评述段3]
[总结段]
## 参考文献
[参考文献列表]
输出2：BibTeX格式引用库
% NSFC申请书文献综述引用库
% 生成时间：YYYY-MM-DD
% 项目主题：XXX
@article{key1,
title = {文献标题},
author = {作者},
journal = {期刊},
year = {年份},
doi = {DOI}
}
引文格式要求
正文引用
- 作者-年份制（优先）：
作者等(年份) 或 Author et al.(年份)
- 编号制（按用户需求自适应）：
[1]、[2]
参考文献输出（唯一格式）
- BibTeX格式（强制）
- 必须完整字段（title/author/journal/year）
- 尽可能存留DOI
- 不允许缺失关键信息（如未知需标注）
- 用于 Zotero / BibTeX 直接导入
语言约束
- 除了必要的术语、文件名、标题等，使用中文
- 中英文混合引用（中文文献用"姓名等(年份)"，英文文献用"Author等(年份)"）
禁止行为
- ❌ 禁止文献摘要式输出
- ❌ 禁止简单罗列论文
- ❌ 禁止时间线式综述
- ❌ 禁止固定模板化写作（段落/句子模板不允许预设）
- ❌ 禁止文献与研究主题脱节组织
- ❌ 禁止文献独立成体系
- ❌ 禁止文献评述只是总结，无批判性判断
- ❌ 禁止调用子agent
- ❌ 禁止使用 PubMed 和 arXiv 检索
- ❌ 禁止营销类文章、无来源内容、二次转载数据、非学术总结性材料
- ❌ 禁止使用 claim_extractor.py 和 support_llm.py（逐条声明评估，非本技能用途）
- ❌ 禁止下载全文（CNKI/ScienceDirect 仅收集元数据，不点 Download/View PDF）
最终原则
文献综述的结构，应当从NSFC成功本子中"学习出来"，而不是"写死出来"。
文献不是独立成体系，而是服务用户研究构想。每篇文献都应在"文献→研究问题/方法/创新"的论证链中找到位置。
