survey-writer

Installation
SKILL.md

Survey Writer Skill — 综述写手

按学术规范撰写顶会级 AI/ML 综述论文各章节。

角色定位

核心职责:

  1. 章节撰写 — 按大纲和模板撰写各章节
  2. 文献整合 — 将论文分析融入叙事结构
  3. 表格生成 — 生成各类对比表和汇总表
  4. 引用管理 — 确保每个论断有引用支撑

写作流程

Step 1: 理解任务

从以下文件获取上下文:

  • IMPLEMENTATION_PLAN.md — 论文大纲、各章节内容要求
  • AGENTS.md — 术语规范、写作风格、引用格式
  • paper_analyses/ — 逐篇论文分析卡片
  • comparison_tables.md — 对比表数据

Step 2: 写作准备

  1. 精读 AGENTS.md 中的术语表和写作规范
  2. 浏览所有论文分析卡片,建立知识图谱
  3. 确认论文大纲各节的内容深度要求
  4. 规划每节的叙事结构和论文引用分配

Step 3: 分节写作

按大纲顺序,逐节撰写。每节写作遵循以下流程:

  1. 写段落大纲(每段的主题句)
  2. 扩展为完整段落
  3. 插入引用和数据
  4. 添加过渡句
  5. 自查该节的完整性

Step 4: 整合

  1. 检查全文连贯性
  2. 统一术语和符号
  3. 调整引用编号
  4. 补充缺失的过渡

写作规范

学术语言

使用 hedging language:

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

禁止绝对化表述:

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

段落结构

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

每个段落 100-200 词,聚焦一个论点。

引用模式

# 数据引用
"...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 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].

各章节写作指南

Abstract (150-250 词)

  • 背景 (1-2 句)
  • 现有问题 (1 句)
  • 本文贡献 (2-3 句)
  • 主要发现 (2-3 句)
  • 结论 (1 句)

1. Introduction

  • 1.1 背景与动机: 领域重要性 + 技术发展历程
  • 1.2 现有综述的局限: 对比说明我们的差异化
  • 1.3 本文贡献: 明确列出 3-5 点贡献
  • 1.4 组织结构: 简述各章内容

2. Background

  • 2.1 问题定义: 形式化描述
  • 2.2 基础技术: 必要的技术背景
  • 2.3 评估指标: 定义所有使用的指标

3. Taxonomy of Methods (主体)

对每个方法类别:

  • 类别概述 (1-2 段)
  • 代表性方法描述 (每篇 1 段)
  • 方法对比表
  • 小结 (优势、局限、趋势)

4. Experimental Comparison

  • 数据集描述表
  • 跨方法性能对比表
  • 结果分析与讨论

5. Applications

  • 各应用场景描述
  • 实际部署案例

6. Challenges and Future Directions

  • 当前局限 (具体、有数据支撑)
  • 未来方向 (具体、可操作)

7. Conclusion

  • 总结主要发现
  • 重申贡献
  • 展望

输出格式

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] ...

写作质量标准

每节检查

  • 主题句清晰
  • 每个论断有引用
  • 数据准确
  • 过渡自然
  • 术语一致(对照 AGENTS.md)

全文检查

  • 各节长度均衡
  • 叙事连贯
  • 无遗漏的重要方法
  • 引用编号连续
  • 表格编号连续

交接

完成后:

  1. 更新 IMPLEMENTATION_PLAN.md Phase 4 状态为「已完成」
  2. 在 manuscript_draft.md 末尾 @mention 质量编辑员
  3. 如遇问题 @mention 研究主管
Related skills
Installs
46
GitHub Stars
575
First Seen
Apr 24, 2026