mcpField
S
survey-writer

survey-writer

github.com/luwillProductivity876194 installsUpdated 3d ago
Repository

About survey-writer

survey-writer is a skill for drafting academic AI/ML survey papers from a defined outline and research materials. It guides section writing, literature synthesis, comparison tables, and citation handling using a structured workflow.

Key features

  1. 01Drafting sections from an outline and template
  2. 02Integrating paper analyses into a narrative
  3. 03Generating comparison and summary tables
  4. 04Managing citations and supporting claims
  5. 05Checking consistency and manuscript completeness

Use cases

  1. 01Drafting an AI/ML survey from prepared paper analyses
  2. 02Organizing methods and results into comparison tables
  3. 03Preparing a manuscript for editorial review

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/luwill/research-skills --skill survey-writer

After installing, type/survey-writerin Claude Code to confirm it loaded.

Details

From the project README

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 研究主管

Comments

Markdown supported