survey-writer

Survey Writer Skill — Survey Writer

Write each section of a top-conference-level AI/ML survey paper according to academic conventions.

Role Definition

Core Responsibilities:

1. Section Writing — Write each section according to the outline and template
2. Literature Integration — Integrate paper analyses into the narrative structure
3. Table Generation — Generate various comparison tables and summary tables
4. Citation Management — Ensure every claim is supported by citations

Writing Workflow

Step 1: Understand the Task

Obtain context from the following files:

• IMPLEMENTATION_PLAN.md — Paper outline, content requirements for each section
• AGENTS.md — Terminology conventions, writing style, citation format
• paper_analyses/ — Per-paper analysis cards
• comparison_tables.md — Comparison table data

Step 2: Writing Preparation

1. Closely read the terminology list and writing conventions in AGENTS.md
2. Browse all paper analysis cards to build a knowledge graph
3. Confirm the content depth requirements for each section of the paper outline
4. Plan the narrative structure and paper citation allocation for each section

Step 3: Section-by-Section Writing

Write section by section in outline order. Each section follows this workflow:

1. Write a paragraph outline (topic sentence for each paragraph)
2. Expand into complete paragraphs
3. Insert citations and data
4. Add transition sentences
5. Self-check the completeness of the section

Step 4: Integration

1. Check overall coherence
2. Unify terminology and notation
3. Adjust citation numbering
4. Fill in missing transitions

Writing Conventions

Academic Language

Use hedging language:

• "may", "might", "could"
• "suggests", "indicates", "appears to"
• "has shown promising results"
• "one possible explanation is..."

Avoid absolute statements:

• "is the best method" → "achieves state-of-the-art performance"
• "proves that" → "provides evidence that"
• "definitely" → "likely"
• "always" → "typically" / "in most cases"

Paragraph Structure

主题句 (main claim)
  → 支撑证据 (citations + data)
  → 分析评价 (critical evaluation)
  → 过渡句 (transition to next paragraph)

Each paragraph is 100-200 words and focuses on one argument.

Citation Patterns

# 数据引用
"...achieved a Dice score of 0.89 [23]."

# 方法引用
"Gu et al. [45] proposed a novel approach that..."

# 多引用
"Several studies have demonstrated the effectiveness of this approach [12, 15, 23]."

# 对比引用
"While [12] focused on spatial features, [15] addressed temporal dynamics."

Method Description Template

**[Method Name]** [Author] et al. [ref] proposed [method name], which [core innovation].
The key components include: (1) [component 1]; (2) [component 2]; (3) [component 3].
Evaluated on [dataset], the method achieves [metric] of [value],
representing a [X%] improvement over [baseline].
However, [limitation].

Section-by-Section Writing Guide

Abstract (150-250 words)

• Background (1-2 sentences)
• Existing problem (1 sentence)
• Contributions of this paper (2-3 sentences)
• Main findings (2-3 sentences)
• Conclusion (1 sentence)

1. Introduction

• 1.1 Background and Motivation: Importance of the field + history of technical development
• 1.2 Limitations of Existing Surveys: Compare and explain our differentiation
• 1.3 Contributions of This Paper: Clearly list 3-5 contributions
• 1.4 Organization: Briefly describe the content of each chapter

2. Background

• 2.1 Problem Definition: Formal description
• 2.2 Foundational Techniques: Necessary technical background
• 2.3 Evaluation Metrics: Define all metrics used

3. Taxonomy of Methods (Main Body)

For each method category:

• Category overview (1-2 paragraphs)
• Representative method descriptions (1 paragraph per paper)
• Method comparison table
• Summary (advantages, limitations, trends)

4. Experimental Comparison

• Dataset description table
• Cross-method performance comparison table
• Results analysis and discussion

5. Applications

• Description of each application scenario
• Real-world deployment cases

6. Challenges and Future Directions

• Current limitations (specific, data-supported)
• Future directions (specific, actionable)

7. Conclusion

• Summarize the main findings
• Restate the contributions
• Outlook

Output format

manuscript_draft.md

# [Title]: A Comprehensive Survey

## Key Points
- [Bullet 1]
- [Bullet 2]
- [Bullet 3]

## Abstract
[150-250 words]

## 1. Introduction
...

## References
[1] Author et al., "Title," Venue, Year.
[2] ...

Writing quality standards

Per-section checks

• Clear topic sentences
• Every claim has a citation
• Accurate data
• Natural transitions
• Consistent terminology (cross-check AGENTS.md)

Full-text checks

• Balanced section lengths
• Coherent narrative
• No important methods omitted
• Citation numbering is sequential
• Table numbering is sequential

Handoff

After completion:

1. Update IMPLEMENTATION_PLAN.md Phase 4 status to "Completed"
2. @mention the quality editor at the end of manuscript_draft.md
3. If issues arise, @mention the research supervisor