write-review-paper

name	write-review-paper
description	Use this when the user wants to write a literature review, survey paper, or thesis chapter from existing papers. Guides reading strategy, note-taking, synthesis, and academic writing. NOT for searching new papers (/research-collect) or generating ideas (/idea-generation).
metadata	{"openclaw":{"emoji":"📝"}}

Literature Review Writing

Don't ask permission. Just do it.

Guide for writing a structured literature review or survey paper from papers you've already collected. This skill helps with reading strategy, note organization, and academic writing.

Outputs go to review/.

Prerequisites

Before starting, ensure you have:

1. Papers collected in papers/
2. Ideally, knowledge base built in knowledge/

Check workspace:

ls papers/
ls knowledge/ 2>/dev/null

---

Phase 1: Reading Strategy

1.1 Triage Papers by Priority

Based on clusters from survey, prioritize reading:

Priority	Criteria	Reading Depth
P1 (必读)	高引用、奠基性工作、你的直接相关方向	精读全文
P2 (重要)	主要方法论、重要实验结果	读摘要+方法+实验
P3 (参考)	辅助材料、边缘相关	仅读摘要

Create review/reading_plan.md:

# Reading Plan

## P1 - 必读 (精读)
- [ ] [paper_id]: [title] - [reason]
- [ ] ...

## P2 - 重要 (选读)
- [ ] ...

## P3 - 参考 (略读)
- [ ] ...

Every entry must keep paper_id and the selection reason. Do not write a reading plan that only lists titles.

1.2 Reading Notes Template

For each paper, create review/notes/{paper_id}.md using template in references/note-template.md.

---

Phase 2: Synthesis & Organization

2.1 Build Comparison Table

Create review/comparison.md:

# Method Comparison

| Paper | Year | Category | Key Innovation | Dataset | Metric | Result | Evidence / Source |
|-------|------|----------|----------------|---------|--------|--------|-------------------|
| [A]   | 2023 | Data-driven | ... | ... | RMSE | 0.05 | `review/notes/{paper_id}.md` |
| [B]   | 2022 | Hybrid | ... | ... | RMSE | 0.08 | `review/notes/{paper_id}.md` |

2.2 Timeline Analysis

Create review/timeline.md:

# Research Timeline

## 2018-2019: 早期探索
- [Paper A]: 首次提出 X 方法
- [Paper B]: 引入 Y 技术

## 2020-2021: 方法成熟
- [Paper C]: 提出 SOTA 方法
- ...

## 2022-2023: 新趋势
- [Paper D]: 开始关注 Z 问题
- ...

## Key Milestones
1. [Year]: [Event/Paper] - [Significance]

2.3 Taxonomy Design

Create review/taxonomy.md:

# Taxonomy of Approaches

## Dimension 1: Method Type
├── Data-driven
│   ├── Statistical (e.g., GPR, SVM)
│   ├── Deep Learning
│   │   ├── CNN-based
│   │   ├── RNN/LSTM-based
│   │   └── Transformer-based
│   └── Hybrid
└── Model-based
    ├── Electrochemical
    └── Equivalent Circuit

## Dimension 2: Data Source
├── Laboratory Data
├── Real-world Driving Data
└── Synthetic Data

## Dimension 3: Prediction Horizon
├── Short-term (< 100 cycles)
├── Medium-term (100-500 cycles)
└── Long-term (> 500 cycles)

---

Phase 3: Writing Structure

3.1 Survey Paper Template

Create review/draft.md using template in references/survey-template.md.

Key sections: Abstract → Introduction → Background → Taxonomy → Comparison → Datasets → Future Directions → Conclusion

At the end of each major section, add one short summary sentence that clearly reflects the evidence already written in review/notes/ or review/comparison.md.

3.2 Thesis Literature Review Template

For a thesis chapter:

# Chapter 2: Literature Review
## 2.1 Introduction
## 2.2 [Topic Area 1]
## 2.3 [Topic Area 2]
## 2.4 Summary and Research Gaps

---

Phase 4: Writing Tips

Citation Density Guidelines

Section	Citation Density
Abstract	0 citations
Introduction	10-20 citations
Background	5-10 citations
Main Survey	50-100+ citations
Conclusion	2-5 citations

Transition Phrases

Introducing similar work:

• "Similarly, [Author] proposed..."
• "Following this direction, ..."
• "Building upon [X], [Author] extended..."

Introducing contrasting work:

• "In contrast, [Author] argued..."
• "However, [Author] took a different approach..."
• "Unlike previous methods, ..."

Summarizing:

• "In summary, existing methods can be categorized into..."
• "The key insight from these works is..."

Common Mistakes to Avoid

1. 列举式写作 - 不要只是 "A did X, B did Y, C did Z"
2. 缺乏比较 - 要分析方法之间的关系和区别
3. 时态混乱 - 描述方法用现在时，描述实验结果用过去时
4. 过度引用 - 不是每句话都需要引用
5. 遗漏重要工作 - 确保覆盖领域的奠基性工作
6. Body text detached from notes - Do not write conclusions into the draft unless they already appear in notes / comparison
7. Trend written as certainty - When evidence is not stable, frame it as an observation or discussion rather than a firm conclusion

---

Output Files

review/
├── reading_plan.md       # 阅读计划
├── notes/                # 阅读笔记
│   ├── {paper_id}.md
│   └── ...
├── comparison.md         # 对比表格
├── timeline.md           # 时间线分析
├── taxonomy.md           # 分类体系
├── draft.md              # 综述草稿
└── bibliography.bib      # 参考文献

---

Commands

• "帮我写综述" → Full workflow from reading to writing
• "生成阅读计划" → Create reading_plan.md
• "对比这些论文" → Generate comparison.md
• "写综述草稿" → Generate draft.md
• "润色这一段" → Polish specific section