我的论文写作工作流

我的论文写作工作流

Jackknifer
Jackknifer 博主

最早写课程论文、实验报告的时候,我是 Overleaf 的忠实用户。大概写作流程是,将论文主体放在 Overleaf 里,公式使用 SimpleTex 这类 OCR 工具去识别,参考文献和查找的各种资料散落在浏览器标签页、本地下载和一些临时笔记里。那个时候我对“论文写作”的理解也很简单:就是一个文档,文档写完了,事情也就差不多结束了。

但大模型发展得越来越快,我的写作方式也随之开始变化。简单说,就是变成了在 Overleaf 网页和 AI 对话网页之间来回切换。一边在 Overleaf 里改正文,一边把段落、或者某些句子丢给模型去润色,把手写的数学公式、网页的公式截图交给模型去识别。相比之前全靠手敲,效率当然提高了不少,但写久了还是会觉得麻烦。各种文件依旧是散落得到处都是,文本在一个地方,代码在另一个地方,参考文献又在第三个地方。AI 对项目整体没有把握,也没有记忆,有时候不得已大量复制粘贴,让 AI 知道我都做了什么、做到了哪一步,真正的上下文其实一直都是断的。

再后来,AI IDE 和 VS Code 里的 AI 插件逐渐成熟,我也终于把论文写作从 Overleaf 搬到了本地 IDE。这个变化看起来只是换了个工具,但其实改变的是写论文这件事的组织方式。

对于绝大多数论文来说,论文不可能只包含正文。正文之外,还必须要有实验代码、数据结果、参考文献、格式要求、导师修改意见⋯⋯。甚至还可以增加相应的修改计划、对整个项目修改的执行情况看板和审计记录。如果这些东西是分散的,AI 再强,也只能局部帮忙,但如果把这些东西被放进一个完整的文件夹里,AI 才可以参与整条写作链路。

感谢 Antigravity,感谢 Claude Code 插件,感谢 Codex 插件。这些 AI 工具极大提升了我的论文写作效率,也让我成功搭建了写作工作流。

我搭建出来的大概是这样一套论文写作工作流:

论文正文、实验代码、参考文献、格式要求与修改意见,以及修改计划与看板,汇入统一项目工作区,由 AI IDE 协助处理。
论文正文、实验代码、参考文献、格式要求与修改意见,以及修改计划与看板,汇入统一项目工作区,由 AI IDE 协助处理。

最初设计这套流程的时候,我的想法很简单:把写论文、写代码、读文献三件事放到一起。这样 IDE 里的 AI agent 就可以直接读取项目里的参考文献,理解论文的上下文,修改实验脚本,评估实验输出结果,再把结果填回论文。这个构想在 AI 模型的加持下取得极大成功,很多无意义的、需要手动操作和切换工作,AI 都能顺利执行。

从我的写作初期来看,这种方法似乎是降维打击。以前写论文,需要在浏览器开一大堆网页,在这些网页之间不断复制、粘贴、切换、整理;现在则更像是在维护一个工程。正文、代码、结果和资料都放在一个项目文件夹,AI 可以直接操作这个工程。输出也不会像早期那样凌乱,在 AI 加持的 IDE 中,进行项目管理:组织目录、文件命名和调整、清理中间产物等等,都能够轻松解决。

我现在的毕业论文就是这样组织的。正文主文件、实验代码、实验结果、参考资料、学校格式要求、修改计划和状态看板,都在同一个仓库里。正文就是最终的论文,代码用来进行数值模拟,参考文献和学校格式要求作为约束,修改计划和看板用来控制论文修改。

除此之外,我还把一些经常会用的一些操作单独整理成 skills 来使用。比如运行实验、对正文进行更新、检查论文和数据结果的一致性、进行修改情况审计、同步仓库等等,这些事情如果每次都向 AI 叙述一遍,很浪费上下文。整理成 skills 之后,AI 在处理这些任务时,可以直接按照预先写好的流程去执行。

这套结构可以画得更具体一点:

论文项目中正文层、实验层、资料层、治理层和技能层的组织关系。
论文项目中正文层、实验层、资料层、治理层和技能层的组织关系。

不过,这套流程在论文写作初期很好用,但到了后期,反而会开始吃力。

原因很简单。论文写作初期,是从零开始创作:搭建整个项目结构、创作论文内容、修改代码。这时候 AI agent 的优势很明显,因为它可以快速地输出内容,补充内容。但论文写作后期,论文已经形成了草稿,整个项目也逐步定型,现在再进行修改,往往需要关注整个项目的协同性和一致性。修改了表格,改了实验脚本的参数,或者根据导师意见调整了文章结构,这些做法,都需要将正文、代码、修改计划等等文件进行同步更新。

也就是说,写到后面,问题已经不再是“怎么生成内容”,而是“怎么管理修改”。

于是我又在原有工作流上补了一层:

修改计划、状态看板、逐步修改、调试与审计组成的修改流程。
修改计划、状态看板、逐步修改、调试与审计组成的修改流程。

这个流程不复杂,但它对后期写作很有作用。最开始先建立修改计划文档,把导师意见、学校要求、存在的问题和需要补的实验都整理进去。然后再建立一个执行看板文档,清晰展示哪些已经完成,哪些还在进行。

论文的修改就可以根据看板上的条目逐步推进。每做完一轮修改,我会再做一轮核对:正文是否与实验结果保持一致,表格映射有没有变化,代码、结果文件和论文分析之间是否保持一致,计划文档和当前状态有没有进行同步的。

感觉现在已经很难再回到最初那种 Overleaf + 若干个浏览器标签页的工作方式了。倒不是说那种方式不能写论文,只是这种方式更适合篇幅比较短,对各种参考文件依赖性低的写作任务。对于毕业论文,尤其是需要依赖大量实验脚本、模拟数据结果和参考文献,单文档式写作很难支撑后期的写作了。

回过头看,这套工作流对我真正有意义的地方,不是把写作变成了更快的复制粘贴,而是把论文从一个单独的文档,变成了一个可以持续维护、持续修改的项目。

评论

评论由 GitHub Giscus 提供。若当前网络无法加载,可 前往 GitHub Discussions 查看或参与讨论。

目录
我的论文写作工作流