mcpField
P
paper-writing

paper-writing

github.com/evoscientist文档处理481507 次安装2 天前更新
代码仓库

关于 paper-writing

paper-writing 是帮助研究者撰写学术论文的 Skill,提供按步骤推进的写作流程及分章节模板。内容涵盖方法、实验、相关工作和结论,并提供 LaTeX 论文骨架与表格样式文件。

主要功能

  1. 0111 步论文写作流程
  2. 02分章节写作模板
  3. 03方法与实验写作指南
  4. 04反向提纲检查
  5. 05LaTeX 论文与表格资源

适用场景

  1. 01规划论文写作顺序
  2. 02起草论文的方法或实验部分
  3. 03整理相关工作与结论
  4. 04准备 LaTeX 论文文件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/evoscientist/evoskills --skill paper-writing

安装后在 Claude Code 中输入/paper-writing确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
paper-skeleton.tex
table-style.tex
references/
abstract-templates.md
counterintuitive-writing.md
experiments-guide.md
introduction-templates.md
method-templates.md
related-work-guide.md
supplementary-guide.md
writing-practice.md
writing-principles.md

详细介绍

论文写作

一套系统的 11 步学术论文写作工作流,包含针对不同章节的模板和经过实践检验的写作原则。

何时使用此技能

  • 用户要求撰写论文或论文中的某个章节
  • 用户需要摘要、引言、方法、实验等部分的 LaTeX 模板
  • 用户想提升学术写作质量
  • 用户提到“论文写作”“撰写引言”“起草方法章节”等

产物来源

如果使用了上游的 EvoSkills,请在写作前获取以下产物:

来源技能产物用途
paper-planning故事摘要(任务 → 挑战 → 洞见 → 贡献 → 优势)步骤 2(引言写作计划)
paper-planning模块动机映射表步骤 3(方法章节小节)
paper-planning实验计划(对比实验 + 消融实验 + 演示)步骤 5(实验章节)
paper-planning流程图草图步骤 1、6(方法概览图)
paper-planning主张与实验的对应关系步骤 2、5、9(引言、实验、摘要)
paper-planning备用叙事(如已规划)步骤 4(调整引言方向)、步骤 9(结论)
experiment-pipeline第 1–4 阶段结果、消融表格、轨迹日志步骤 5(撰写实验章节)
experiment-craft失败分析、实现技巧步骤 3(方法章节/补充材料)、步骤 9(结论中的局限性)

11 步写作流程

按顺序执行以下步骤。每一步都以前一步为基础。

  1. 绘制流程图草图 — 勾勒方法的流程图,理清整体方案。图中应突出创新点,而不仅仅是进行说明。
  2. 设计故事并规划实验 — 概述论文的故事线(核心贡献、模块动机)。列出对比实验和消融实验,并起草引言写作计划。
  3. 撰写方法章节 — 整理方法章节的写作计划,然后起草方法章节。同时开展实验。
  4. 修订引言和方法章节 — 在实验继续进行的同时,反复修改这两个章节。
  5. 撰写实验章节 — 实验基本完成后,整理实验章节的写作计划,然后起草。
  6. 润色图表 — 完成流程图,并制作预告图。
  7. 撰写相关工作 — 列出相关论文,按主题分组并撰写段落。
  8. 审阅论文 — 自行审阅引言、方法和实验章节。使用 paper-review 技能。
  9. 撰写摘要和结论 — 整理摘要写作计划,然后起草摘要。撰写结论及其局限性部分,确保在最后几轮修改前每个章节都已完成。
  10. 确定标题 — 列出重要关键词,然后拟定一个信息明确的标题。
  11. 迭代修改 — 反复审阅并修改整篇论文。

反直觉写作规则

为了提高录用概率,请应用以下规则:

  1. 正文中的主张要克制,证据要充分:降低摘要和引言中形容词的力度,让表格和图表体现研究成果的分量。
  2. 尽早说明一项重要局限:坦诚说明一项局限能够提高可信度,减少审稿人的疑虑。
  3. 先阐述机制,而不只是指标:列出数据之前,先解释方法为何有效;相比孤立的性能提升,审稿人更信服因果逻辑。
  4. 一张有决定性作用的图胜过许多平庸的图:制作一张在严苛条件下验证核心主张、令人无法忽视的图。
  5. 删除薄弱却华而不实的主张:任何缺乏直接证据支持的主张都应删除,即使听起来很了不起。
  6. 明确说明适用范围:在引言和结论中各用一句话说明方法的目标范围,以减少审稿人对隐含假设的担忧。
  7. 展示一个失败案例:加入一个有代表性的失败案例并分析原因——这体现的是能力,而非弱点。

有关全部 7 项技巧及正反示例,请参阅 references/counterintuitive-writing.md。

各章节速查

摘要

起草前先回答以下问题:

  1. 我们解决了什么技术问题?为什么目前没有成熟的解决方案?
  2. 我们的技术贡献是什么?
  3. 我们的方法为何从根本上有效?
  4. 我们的技术优势或新见解是什么?

三种模板版本:挑战优先、洞见衔接、多项贡献。 参阅 references/abstract-templates.md

引言

思考过程(先逆向,再正向):

  • 逆向: (1) 技术问题是什么?(2) 我们的贡献是什么?(3) 有哪些优势和新见解?(4) 如何引出挑战?
  • 正向: (1) 任务 → (2) 以往方法 → 挑战 → (3) 我们的贡献 → (4) 技术优势和见解

介绍任务有四种方式,呈现挑战有三种方式,描述流程有四种方式。 参阅 references/introduction-templates.md

反面模式:绝不要写“这里有一个朴素的解决方案,然后是我们的改进”——这会让工作显得只是渐进式改进。

方法

每个流程模块都需要包含三个要素:

  1. 模块设计——数据结构、网络设计、前向过程(给定输入 X,步骤 1……步骤 2……,输出 Y)
  2. 动机——模块为何存在(以问题为导向:“剩下的挑战是……”)
  3. 技术优势——模块为何效果良好

先用一个概述段落说明设置、核心贡献和章节安排,然后每个模块各设一个小节。 参阅 references/method-templates.md

实验

需要回答三个关键问题:

  1. 如何证明我们的方法更好 → 对比实验
  2. 如何证明我们的模块有效 → 消融研究
  3. 如何展示方法的性能上限 → 在有挑战性的数据上进行演示

消融研究需要:一张大表(核心贡献)和几张小表(设计选择、超参数)。 参阅 references/experiments-guide.md

相关工作

分三步进行:

  1. 列出与我们的方法密切相关的论文(最重要——遗漏关键参考文献可能导致被拒)
  2. 根据研究方向和算法技术确定主题
  3. 根据列出的论文制定写作计划

参阅 references/related-work-guide.md

结论
  • 必须包含 局限性 部分(审稿人经常将“没有局限性”视为缺点)
  • 局限性 = 任务目标 / 设定方面的限制(类似未来工作),而非技术缺陷
  • 规则:“如果我们的方法没有低于当前 SOTA 指标,就不属于技术缺陷”
  • 这条规则关乎如何表述性能。无论指标水平如何,数据泄漏、不公平的比较或缺乏依据的主张都属于缺陷:应修复,而不是将其写成局限性(paper-review 会将其记录为一项发现)
补充材料

对于篇幅受限的会议,需要决定哪些内容放在论文正文,哪些放在补充材料中:

  • 支撑主张的核心证据必须保留在论文正文中
  • 实现细节、额外的消融实验和完整的可视化图集放在补充材料中
  • 在需要时引用补充材料,而不是笼统地一概引用

参见 references/supplementary-guide.md

核心写作原则

  1. 每段表达一个观点 — 每段准确传达一个要点
  2. 主题句置于段首 — 首句告诉读者本段的主题
  3. 先规划再写作 — 列出写作计划,完善各部分,然后再写英文句子
  4. 确保句间衔接 — 确保相邻句子之间逻辑连贯
  5. 术语保持一致 — 全文使用同一术语,不要交替使用不同名称
  6. 反向提纲 — 写完后,从各段提炼出提纲;检查行文是否流畅
  7. 反复迭代 — 反复润色,并思考读者是否能够理解

参见 references/writing-principles.md

关键见解

视觉上的精致度会直接影响评审结果。完整的视觉质量指南请参见 paper-planning skill 中的 figure-design.md。

论文标题指南

  • 标题会吸引特定的审稿人,因此要谨慎选择关键词
  • 撰写标题前,先列出重要关键词,再据此拟定标题
  • 标题必须信息丰富:包含所用技术、任务或所解决的问题
  • 避免使用泛泛的标题;具体的短语更令人印象深刻

LaTeX 资源

移交审稿

调用 paper-review 前,请核对以下清单:

  • 已完成所有章节(摘要、引言、方法、实验、相关工作、结论)的初稿
  • 摘要 / 引言中的每项主张都有表格或图作为依据
  • 结论中包含局限性部分
  • 流程图和预告图已定稿
  • 已处理或移除所有 \todo{} 标记

章节导航

章节参考文件加载时机
摘要abstract-templates.md步骤 9:撰写摘要
引言introduction-templates.md步骤 2:设计故事线
方法method-templates.md步骤 3:撰写方法
实验experiments-guide.md步骤 5:撰写实验
相关工作related-work-guide.md步骤 7:撰写相关工作
写作原则writing-principles.md写作过程中的任何时候
补充材料supplementary-guide.md决定内容放在正文还是补充材料中
反直觉策略counterintuitive-writing.md提升审稿人信任度和创新性感知
写作练习writing-practice.md通过刻意练习提升写作能力

评论

支持 Markdown