Skill: junwugit/thesis-literature-review-writer (version 1.0.0)

--- name: thesis-literature-review-writer description: Write detailed, academically rigorous Chinese literature review chapters or literature review sections for theses, dissertations, and undergraduate papers from a user's topic, research problem, variables/concepts, theory, method, population, references, and extra information. Use when users ask to write, expand, polish, organize, synthesize, or structure only the Literature Review/Chapter Two/文献综述/国内外研究现状 section, including search scope, conceptual review, theoretical review, empirical review, themes, gaps, critique, summary, and transition to research questions or design. --- # Thesis Literature Review Writer ## Scope Use this skill only to write the literature review part of a Chinese academic paper. The default output is a polished Chinese "第二章 文献综述" or "国内外研究现状" section. Do not write the introduction, methodology, results, discussion, or conclusion chapters except for brief transitions that explain how the literature review supports the research problem, research questions, hypotheses, or study design. ## Required Reference Before drafting a full literature review, read `references/literature-review-writing-guide.md`. It contains the search logic, chapter structure, synthesis strategies, Chinese templates, citation safeguards, and method-specific adaptations derived from the local `2review.txt` source. ## Input Extraction Extract and use any information the user provides: - Thesis title, research topic, or research problem - Discipline and degree level - Research type: quantitative, qualitative, mixed methods, literature review, intervention-scheme design, theoretical analysis - Research object/population, setting, and data source - Variables, concepts, themes, theory/model, intervention framework, or mechanisms - Research questions, hypotheses, or research content - Supplied references, notes, article summaries, citation style, and required databases - School format requirements, word count, heading style, and domestic/foreign literature requirements If the user does not provide references, draft with citation placeholders and recommend search terms. Do not invent exact references, author names, years, journal titles, findings, statistics, or DOI information. ## Drafting Workflow 1. Decide whether the user needs a full literature review chapter, a short "国内外研究现状" section, or one subsection. 2. Identify the organizing principle: - By variables/concepts for quantitative studies - By themes/experiences/context for qualitative studies - By theory, mechanism, intervention components, and evaluation evidence for intervention-scheme papers - By search scope, themes, debates, and gaps for review papers 3. Use a funnel structure: general literature first, then increasingly specific studies closest to the user's topic, population, method, and research questions. 4. Be selective: emphasize sources directly related to the study; summarize tangential sources briefly or exclude them. 5. Synthesize rather than list. Organize the chapter around concepts, theories, themes, trends, gaps, contradictory findings, practical significance, or continuing lines of inquiry. 6. Include an introduction/advance organizer at the start of the chapter and a summary at the end. 7. Use headings, subheadings, transitions, and topic sentences to make the review coherent. 8. Use placeholders for missing citations and flag where the user must add real sources. ## Output Standards For a full literature review, include: - A concise note listing assumptions, missing references, and recommended search terms if needed - A complete Chinese draft with numbered headings - An opening paragraph that states the scope and sequence of the review - Thematic synthesis, not article-by-article annotation - Critical evaluation of existing research gaps, contradictions, methods, populations, and limitations - A short chapter summary that leads to the user's study - Citation placeholders when exact sources are unavailable Quality requirements: - Every major subsection must connect to the research problem. - The chapter must not be a pile of "某某认为/某某发现" summaries. - Primary sources are preferred over secondary summaries. - The most relevant literature receives the most detailed coverage. - The summary should make the rationale for the user's research apparent. - The writing should be formal Chinese academic prose.

path: agents/openai.yaml
content: interface:
  display_name: "Thesis Literature Review Writer"
  short_description: "Chinese academic literature review chapter writer"
  default_prompt: "Use $thesis-literature-review-writer to write a rigorous Chinese literature review chapter from my thesis topic, variables, and references."


path: references/literature-review-writing-guide.md
content: # Chinese Literature Review Writing Guide

This reference is derived and paraphrased from the local source `2review.txt`. Use it to write only the Literature Review/Chapter Two/文献综述 section.

## Table of Contents

1. Core Function of Literature Review
2. Literature Search and Source Strategy
3. Keyword Strategy
4. Recommended Chapter Structure
5. Funnel Organization
6. Selective Coverage
7. Writing the Chapter Opening
8. Headings and Transitions
9. Writing the Chapter Summary
10. Critical Synthesis Strategies
11. Method-Specific Review Structures
12. Chinese Templates
13. Citation and Plagiarism Safeguards
14. Revision Checklist

## Core Function of Literature Review

A literature review provides the rationale for the study. It supports the statement of the problem, research questions or hypotheses, theoretical framework, method selection, and interpretation of later findings.

A strong literature review should:

- Provide historical background for the problem.
- Describe the current status of research.
- Support the purpose of the study.
- Identify gaps in the literature.
- Clarify variables, concepts, constructs, and theories.
- Identify seminal studies and leading scholars.
- Propose useful theoretical constructs.
- Show appropriate methodological procedures.
- Provide comparative studies useful for later analysis and discussion.

Core rule:

> 文献综述不是文献罗列，而是围绕研究问题对已有研究进行归纳、比较、评价和综合。

## Literature Search and Source Strategy

When the user asks for search guidance or has no references, recommend a broad but focused source strategy.

Useful source types:

- Handbooks and encyclopedias: good starting points for core concepts and classic references.
- Annual reviews: useful models for critical synthesis.
- Review articles: summarize major research trends and debates.
- Abstracting and indexing databases: ERIC, PsycINFO, Sociological Abstracts, Dissertation Abstracts, Social Science Citation Index, CINAHL, Medline, Social Work Abstracts, and field-specific databases.
- Government/statistical documents: useful for policy background and current statistics.
- Public search engines: use cautiously; prioritize university, government, journal, and professional organization sources.
- Professional journals in the user's discipline.

Chinese thesis database examples:

- 中国知网
- 万方
- 维普
- PubMed
- Web of Science
- PsycINFO
- Google Scholar
- ERIC

Source quality rules:

- Prefer peer-reviewed journal articles, academic books, dissertations, official statistics, and recognized reports.
- Prefer primary sources over secondary descriptions.
- Use review articles to understand the field, but do not rely only on them.
- If only a secondary source is available, mark it transparently according to the required citation style.

## Keyword Strategy

Search terms should come from:

- Working title
- Independent and dependent variables
- Key concepts or themes
- Population
- Theory/model
- Method
- Synonyms and related terms
- Keywords listed in relevant abstracts

Example:

For 《大学生睡眠质量与焦虑水平的关系研究》:

- 中文关键词：大学生、睡眠质量、焦虑、心理健康、影响因素、相关研究
- English keywords: college students, sleep quality, anxiety, mental health, correlates, predictors

For qualitative topics:

- 中文关键词：大学生、心理求助、质性研究、访谈、主题分析、影响因素
- English keywords: college students, help-seeking, qualitative study, interview, thematic analysis, barriers

For intervention-scheme topics:

- 中文关键词：大学生、考试焦虑、认知行为疗法、团体辅导、干预方案
- English keywords: test anxiety, cognitive behavioral therapy, group counseling, intervention, college students

When drafting without exact references, add:

> 建议后续以"……""……""……"为关键词，在CNKI、万方、PubMed、Web of Science等数据库中检索近五至十年文献，并补充经典理论文献。

## Recommended Chapter Structure

Default full chapter:

```markdown
第二章 文献综述

2.1 文献检索与综述思路
2.2 核心概念界定
2.3 理论基础
2.4 变量/主题一研究现状
2.5 变量/主题二研究现状
2.6 变量关系/作用机制/干预研究现状
2.7 既有研究述评
2.8 本章小结
```

For many undergraduate papers, simplify to:

```markdown
第二章 文献综述

2.1 核心概念界定
2.2 相关理论基础
2.3 国内外研究现状
2.4 既有研究述评
2.5 本章小结
```

For short "国内外研究现状":

```markdown
一、核心概念及理论基础
二、国内研究现状
三、国外研究现状
四、研究述评
```

## Funnel Organization

Use a funnel structure:

1. General and historical literature.
2. Core concepts and theories.
3. Current research on each variable/concept/theme.
4. Research closest to the user's population, method, setting, and research problem.
5. Gaps and direct lead-in to the user's study.

Coverage rule:

- Highly relevant studies: discuss in detail.
- Moderately relevant studies: discuss briefly.
- Tangential studies: mention only if they support context or theory; otherwise exclude.

Avoid:

- Giving every article the same amount of coverage.
- Switching repeatedly between broad background and narrow evidence.
- Overloading the chapter with background unrelated to the research questions.

## Selective Coverage

For every source, ask:

- Does it explain the theory supporting the study?
- Does it define the current state of research?
- Does it directly concern the topic, population, variables, or method?
- Does it help maintain a coherent argument?
- Does it identify a gap, contradiction, trend, or method issue?
- Does it support the study's research questions, hypotheses, or design?

Preferred style:

> Existing studies can be grouped into three main lines...

Avoid overusing:

> 张三认为……李四认为……王五认为……

Better Chinese pattern:

> 现有研究主要从……、……和……三个方面探讨……。其中，……研究强调……；……研究则更多关注……。总体来看，这些研究为理解……提供了基础，但在……方面仍存在不足。

## Writing the Chapter Opening

The review chapter should begin with a brief introduction that:

- Reintroduces the research problem.
- Names the key variables, concepts, themes, or theories.
- States the scope of the review.
- Provides an advance organizer listing the exact sections of the chapter.

Chinese template:

> 本章围绕……主题展开文献综述，旨在为本研究的问题提出、理论基础和研究设计提供依据。结合本文研究目的，本章主要从……、……、……和……四个方面梳理相关研究：首先，对……进行概念界定；其次，介绍……理论基础；再次，综述……和……的研究现状；最后，对既有研究进行评述，并指出本研究的切入点。

Quality rule:

- The headings announced in the opening should match the actual headings in the chapter.

## Headings and Transitions

Use headings and subheadings to keep the review coherent.

Practical guideline:

- Use at least one heading or subheading for every major topic.
- Long reviews should not run for many paragraphs without a heading.
- Each section should begin with a topic sentence and end with a transition or mini-summary.

Useful transition phrases:

- 在上述研究基础上……
- 与……研究不同，……
- 从研究对象来看……
- 从研究方法来看……
- 尽管已有研究取得了一定进展，但……
- 进一步来看……
- 因此，有必要……
- 综上，……

Transition template:

> 以上研究主要揭示了……，但对于……的讨论仍相对有限。为进一步理解……，有必要继续梳理……方面的研究。

## Writing the Chapter Summary

The chapter should end with a brief summary that:

- Reviews the main theoretical and empirical literature.
- Identifies what is known.
- Identifies what remains unclear.
- Shows how the user's study extends or applies existing knowledge.
- Leads naturally to the research method or research questions.

Chinese template:

> 综上所述，既有研究围绕……已经形成了较为丰富的成果，主要集中在……、……和……等方面。这些研究为本文理解……提供了重要基础。然而，现有研究仍存在以下不足：第一，……；第二，……；第三，……。基于此，本文拟以……为研究对象，围绕……展开研究，以期进一步补充……领域的相关认识。

## Critical Synthesis Strategies

Use one or more of these strategies to avoid simple listing.

### 1. Historical Context

Use when a construct or theory developed over time.

Chinese pattern:

> 关于……的研究经历了从……到……的发展过程。早期研究主要关注……，随后研究者逐渐转向……。近年来，随着……，相关研究进一步拓展到……。

### 2. Literature Gap

Use when the field lacks research on a population, setting, method, or mechanism.

Chinese pattern:

> 尽管已有研究关注……，但关于……群体/情境/机制的研究仍相对不足。尤其是在……方面，现有研究尚未形成充分解释。

### 3. Different Approach

Use when the user's study takes a different angle from prior work.

Chinese pattern:

> 既有研究多从……角度解释……，而较少从……角度展开。因此，本文尝试以……为切入点，对……进行分析。

### 4. Trends and Themes

Use when studies can be grouped into themes.

Chinese pattern:

> 综合已有文献可以发现，相关研究主要形成了三类主题：一是……；二是……；三是……。

### 5. Practical Significance

Use when empirical studies report effect sizes, sample sizes, intervention outcomes, or practical implications.

Chinese pattern:

> 从实践效果来看，相关研究显示……可能对……具有一定作用。但不同研究在样本规模、测量工具和干预周期上存在差异，因此其结论仍需结合具体情境理解。

### 6. Conflicting Theories

Use when theories or findings disagree.

Chinese pattern:

> 关于……的解释，现有研究存在两种不同观点。一种观点认为……；另一种观点则强调……。两种观点分别揭示了……和……，但也存在……方面的局限。

### 7. Summary Table

Use a table when at least 8-10 studies concern the same variable, intervention, instrument, or theme.

Suggested table columns:

| 作者/年份 | 研究对象 | 研究方法 | 主要变量/主题 | 主要发现 | 局限 |
|---|---|---|---|---|---|

### 8. Inconsistent Findings

Use when results are mixed.

Chinese pattern:

> 关于……与……的关系，现有研究结论并不一致。部分研究发现……，而另一些研究则指出……。造成差异的原因可能与样本特征、测量工具、研究设计和文化情境有关。

### 9. Continuing Line of Inquiry

Use when a classic study or theory generated later studies.

Chinese pattern:

> 自……提出……以来，相关研究不断围绕……展开。一方面，后续研究延续了……的基本思路；另一方面，也在……方面进行了修正和拓展。

## Method-Specific Review Structures

### Quantitative Questionnaire Study

Recommended structure:

1. 核心概念界定
2. 理论基础
3. 变量A研究现状
4. 变量B研究现状
5. 变量A与变量B关系研究
6. 人口学变量差异研究，if relevant
7. 既有研究述评
8. 本章小结

Emphasize:

- Definitions and measures.
- Theoretical rationale for variable relationships.
- Prior findings on correlations, differences, prediction, mediation, or moderation.
- Gaps in population, sample, context, or method.

### Qualitative Study

Recommended structure:

1. 核心概念界定
2. 理论视角或分析框架
3. 目标群体相关研究
4. 研究主题的质性/实证研究现状
5. 影响因素、经验过程或意义建构研究
6. 既有研究述评
7. 本章小结

Emphasize:

- Participants' experiences, meanings, processes, and contexts.
- Existing qualitative themes and gaps.
- Why interviews, focus groups, observations, case study, or text analysis are appropriate.
- Avoid turning qualitative review into variable-correlation logic.

### Mixed Methods Study

Recommended structure:

1. 核心概念与理论基础
2. 定量研究现状
3. 质性研究现状
4. 混合研究的必要性
5. 既有研究述评
6. 本章小结

Emphasize:

- What quantitative studies show.
- What qualitative studies explain.
- Why both are needed.
- How the user's mixed design addresses gaps.

### Literature Review Paper

Recommended structure:

1. 文献检索与筛选
2. 核心概念界定
3. 理论基础
4. 主题一
5. 主题二
6. 主题三
7. 研究不足与未来方向

Emphasize:

- Search scope and inclusion/exclusion criteria.
- Thematic synthesis.
- Critical comparison.
- Future research agenda.

### Intervention-Scheme Design

Recommended structure:

1. 目标问题的概念与表现
2. 目标问题的影响因素和发生机制
3. 相关理论基础
4. 既有干预研究
5. 现有干预的不足
6. 对本研究方案设计的启示

Emphasize:

- Intervention mechanisms.
- Target population needs.
- Evidence for intervention components.
- Limitations of existing interventions.
- The user's scheme as a design, not proven effective.

## Chinese Writing Templates

### Concept Review

> 关于……的概念，学界尚未形成完全一致的界定。已有研究主要从……、……和……三个角度进行解释。综合相关文献，本文将……界定为……，并在后续研究中主要从……方面加以分析。

### Theory Review

> ……理论为解释……提供了重要视角。该理论认为……。在……研究中，该理论常被用于解释……。结合本文研究主题，……理论可以帮助理解……，因此本文将其作为重要理论基础。

### Empirical Review

> 现有关于……的实证研究主要集中在……方面。部分研究发现……，说明……；也有研究指出……，提示……。总体来看，相关研究为理解……提供了经验依据，但在……方面仍存在进一步探讨空间。

### Qualitative Review

> 既有质性研究显示，……群体在……过程中通常呈现出……、……和……等经验主题。这些研究强调了……的重要性，但对于……情境下的具体经验和意义建构仍缺乏充分讨论。

### Research Gap

> 综上，已有研究为本文提供了重要基础，但仍存在以下不足：第一，……；第二，……；第三，……。因此，本文拟在既有研究基础上，以……为对象，围绕……展开进一步研究。

### Chapter Summary

> 本章围绕……进行了文献梳理。首先，本文对……进行了概念界定；其次，介绍了……理论基础；再次，从……、……和……方面综述了相关研究；最后，对既有研究进行了评述。总体来看，现有研究为本文提供了理论和经验依据，但仍需要在……方面进一步拓展。

## Citation and Plagiarism Safeguards

Rules:

- Do not invent citations.
- Do not copy long passages from sources.
- Use quotation marks and citations for exact wording.
- Prefer paraphrase plus citation for most literature.
- Cite ideas, not only direct quotations.
- Use primary sources when possible.
- If a source is secondary, mark it transparently.

When sources are missing:

> （此处补充关于……的近五年实证研究）

When exact data are missing:

> 相关调查显示……（此处补充数据来源）

When a classic theory is mentioned but not sourced:

> 根据……理论，……（此处补充经典文献）

## Revision Checklist

Before finalizing, check:

- Does the chapter begin with an advance organizer?
- Are headings aligned with the user's topic, variables, concepts, or themes?
- Does the review move from broad to specific?
- Are the most relevant studies covered in greater detail?
- Does each subsection include synthesis rather than only summaries?
- Are gaps, contradictions, limitations, or trends clearly identified?
- Does the chapter summary lead directly to the user's study?
- Are citations real or clearly marked as placeholders?
- Are transitions clear between sections?
- Is the prose formal Chinese academic style?


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)