mcpField
P
paper-writing

paper-writing

github.com/vishalsachdev文档处理41.3k 次安装13 周前更新
代码仓库

关于 paper-writing

为跨学科研究论文写作与修改提供指导的技能,适用于学生和研究人员。它覆盖选题规划、论文结构、论证、风格、修订和引用,并采用逐步对话方式提供针对性帮助。

主要功能

  1. 01规划研究问题与论文提纲
  2. 02指导摘要及各章节写作
  3. 03改进论证结构与表达清晰度
  4. 04检查图表、引用和格式
  5. 05按需使用模板与参考资料

适用场景

  1. 01规划期刊或会议论文
  2. 02撰写论文的特定章节
  3. 03修改草稿中的结构与论证
  4. 04按投稿要求检查格式和引用

安装

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

$npx skills add https://github.com/vishalsachdev/claude-code-skills --skill paper-writing

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

包含的文件

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

LICENSE.txt
assets/
conference-paper-template.md
README.md
research-paper-template.md
references/
ELITE-PAPERS.md
REFERENCE.md
STRUCTURE.md
STYLE.md
scripts/
check_paper.py

详细介绍

学术论文写作技能

此技能全面介绍如何撰写优秀的学术论文和研究论文,适用于各个学科。内容涵盖结构、风格、论证和最佳实践,从初步规划一直到最终修改。

何时使用此技能

在以下情况下使用此技能:

  • 研究论文和期刊文章
  • 会议论文和会议录
  • 技术报告和白皮书
  • 学位论文的章节和学位论文
  • 文献综述和综述论文
  • 立场论文和观点文章

快速入门

如需立即获取指导,请参阅以下针对具体任务的工作流。如需全面的参考资料,请查看:

  • references/REFERENCE.md - 完整的写作指南和最佳实践
  • references/STRUCTURE.md - 不同论文类型的详细模板
  • references/STYLE.md - 写作风格和清晰度指南
  • assets/ - 可直接使用的论文模板

核心工作流

1. 规划阶段

了解要求

  • 确定目标发表场所(期刊、会议、报告)
  • 查看格式要求(APA、IEEE、ACM、Chicago 等)
  • 记录页数限制、章节要求和引用格式
  • 明确提交截止日期和评审流程

明确研究问题

  • 提出清晰、聚焦的研究问题或假设
  • 确保问题具体、可衡量且可回答
  • 找出现有知识或实践中的空白
  • 陈述你的工作将作出的贡献

创建提纲

  • 根据论文类型拟定章节标题(参见“结构”部分)
  • 为每个章节分配大致篇幅
  • 确定每个章节的要点
  • 将证据和参考文献对应到各个章节
2. 写作阶段

遵循结构化方法

按章节逐一撰写,不一定要按顺序进行。许多作者会按以下顺序撰写:

  1. 方法(最清晰、最具体)
  2. 结果(呈现研究发现)
  3. 引言(构建问题背景)
  4. 讨论(解读结果)
  5. 结论(总结贡献)
  6. 摘要(最后撰写,概括全文)

各章节的具体指南

摘要(150-300 个词)

  • 陈述问题和研究动机(1-2 句)
  • 描述你的方法或研究方法(1-2 句)
  • 概述关键结果(2-3 句)
  • 陈述结论和影响(1-2 句)
  • 确保内容自成一体(不含引用、不使用未定义的缩写)

引言

  • 引入:为什么读者应该关注?(1 段)
  • 背景:更广泛的问题领域是什么?(1-2 段)
  • 空白:现有解决方案缺少什么?(1 段)
  • 你的贡献:本文做了什么?(1 段)
  • 论文结构:简要介绍文章结构(可选,1 段)

相关工作 / 文献综述

  • 按主题而非时间顺序组织相关工作
  • 比较不同方法并指出其异同
  • 指出现有工作的局限
  • 清楚说明你的工作与其他方案的区别
  • 公平、准确地进行论述(不要歪曲竞争方案)

方法论 / 方法

  • 详细描述方法,使其足以供他人复现
  • 说明设计选择的理由
  • 定义指标和评估标准
  • 解释数据收集和分析流程
  • 为复杂流程添加图示

结果

  • 客观呈现研究发现,不作解读
  • 有效使用表格和图示(参见“可视化”部分)
  • 在适用时报告统计显著性
  • 同时说明正面和负面结果
  • 按研究问题或假设组织内容

讨论

  • 结合研究问题解读结果
  • 与相关工作进行比较
  • 解释意外发现
  • 诚实地承认局限
  • 讨论对理论和实践的影响

结论

  • 重申关键贡献(1 段)
  • 总结主要发现(1 段)
  • 讨论更广泛的影响(1 段)
  • 提出未来工作方向(1 段)
  • 以有力的结束语收尾
3. 修订阶段

第一轮修订:结构与论证

  • 每个章节是否都发挥了应有的作用?
  • 论证是否合乎逻辑且完整?
  • 各章节之间的过渡是否流畅?
  • 证据是否支持所有主张?
  • 是否回应了反方论点?

第二轮修订:清晰度与风格

  • 删除行话,并定义技术术语
  • 消除冗余和冗长表达
  • 使用主动语态以提升清晰度(优先使用“我们分析了”,而非“进行了分析”)
  • 确保列表中的结构平行
  • 检查段落长度(建议每段 4–8 句)

第三轮修订:润色

  • 检查语法、拼写和标点
  • 确认所有引文格式正确
  • 确保正文中引用了所有图表
  • 统一章节、公式和图表的编号
  • 仔细校对(大声朗读会有所帮助)

可视化最佳实践

表格

  • 用于精确的数值比较
  • 保持简洁易读(避免过多网格线)
  • 使用清晰的列标题和单位
  • 表格标题放在表格上方
  • 在表格出现之前先在正文中引用

图

  • 用于展示趋势、模式和关系
  • 确保坐标轴标注了单位
  • 使用易读的字体(最终尺寸至少为 10pt)
  • 图注放在图下方
  • 确保以灰度打印时仍易于理解(避免仅用颜色区分)

一般规则

  • 正文中必须引用每个表格和图
  • 每个表格和图都应能通过其标题独立理解
  • 按顺序编号(图 1、图 2 等)
  • 尽可能放在首次引用的位置附近

应避免的常见问题

结构问题

  • ❌ 将贡献点埋在文章中段
  • ✅ 在引言中明确说明贡献
  • ❌ 结果部分进行解读,而非呈现结果
  • ✅ 保持结果客观,在讨论部分进行解读
  • ❌ 结论引入新信息
  • ✅ 结论只综合已有内容

写作问题

  • ❌ 使用被动表达:“研究发现……”
  • ✅ 使用主动语态:“我们发现……”
  • ❌ 过度使用模糊措辞:“似乎可能表明……”
  • ✅ 直截了当:“结果表明……”
  • ❌ 未定义缩写和行话
  • ✅ 首次使用时定义术语

引文问题

  • ❌ 主张缺少引文
  • ✅ 每项事实性主张都需要来源
  • ❌ 为显而易见的事实引用过多
  • ✅ 常识无需引用
  • ❌ 未阅读就引用(堆砌引文)
  • ✅ 只引用自己实际阅读并核实过的资料

各学科的注意事项

计算机科学 / 工程学

  • 强调可复现性和实现细节
  • 适当时进行复杂度分析
  • 提供算法伪代码或代码片段
  • 与最先进的基线方法进行比较
  • 尽可能公开代码和数据

自然科学

  • 遵循严格的 IMRAD 结构(引言、方法、结果、讨论)
  • 报告统计功效和效应量
  • 提供详细的实验方案
  • 讨论混杂变量
  • 如实报告无显著结果

社会科学

  • 将研究置于理论框架中
  • 说明抽样和参与者选择的依据
  • 报告人口统计信息
  • 讨论潜在偏差
  • 讨论研究结论的普适性限制

人文学科

  • 提出清晰的论点
  • 以文本证据支持论述
  • 参与学术讨论
  • 进行细读和分析
  • 将研究置于历史/文化框架中

以对话为先的方法

帮助用户撰写论文时,应优先进行自然对话,而不是接连抛出问题:

  1. 从简单的问题开始:提出一个开场问题,了解他们的情况

    • “你的论文主题是什么?”(主题/暂定标题)
    • 或者:“你现在进展到哪个阶段了?”(如果他们已经有明确方向)
  2. 倾听并跟进:根据他们的回答,提出接下来最相关的问题

    • 如果他们刚开始:询问目标投稿 venue 或研究空白
    • 如果他们正在修改:询问需要修改哪个部分
    • 如果他们卡住了:询问他们遇到的具体挑战
  3. 逐步了解背景:让信息在对话中自然呈现

  4. 提供有针对性的帮助:聚焦他们当前的需求,而不是面面俱到

  5. 保留作者的表达风格:编辑时以改进为目的,不要改写成另一种风格

  6. 解释建议的理由:帮助他们理解这些修改为何能增强论文

  7. 按需加载参考资料:仅在相关时使用参考文档提供更深入的指导

使用参考资料

此技能包含详细的参考资料,可提供更深入的指导:

  • 加载 references/REFERENCE.md,获取全面的写作指南、风格指南和详细的最佳实践
  • 加载 references/STRUCTURE.md,获取不同论文类型(期刊文章、会议论文、学位论文等)的完整模板
  • 加载 references/STYLE.md,深入了解学术写作风格、用词和清晰度
  • 查看 assets/,获取可直接使用的各种格式模板

仅在需要时加载这些资料,以节省上下文。对于大多数任务,上述指导已足够。

渐进式完善

基础用法:遵循核心工作流撰写或修改论文

进阶用法:针对具体部分或挑战查阅参考资料

高级用法:使用 assets/ 中的模板,并针对特定 venue 进行定制

质量检查清单

在确认论文完成前,请核实:

  • 引言中明确说明了研究问题或贡献
  • 所有论断都有证据或引用支持
  • 各部分之间逻辑连贯
  • 方法细节足够充分,便于复现
  • 结果客观呈现
  • 讨论部分对结果进行解读,并说明局限性
  • 正文中引用了所有图表,且图注清晰
  • 引用格式统一
  • 摘要准确概括论文内容
  • 没有拼写或语法错误
  • 符合 venue 要求(格式、篇幅、风格)

示例

示例 1:逐步了解情况——从头开始

User: Help me write a research paper.

Claude: What's your paper about? (topic, working title, or research question)

User: It's about federated learning for edge devices.

Claude: Got it—that's a focused topic. Are you at the stage of having completed
research and needing to write it up, or are you still planning the work?

User: I've done the research and have preliminary results. I just don't know
where to start.

Claude: Perfect—let me help you structure this. What's your target venue?
(e.g., a specific conference, journal, or is this a thesis chapter?)

注意:先提一个问题,再根据对方的回答自然地提出下一个问题。


示例 2:有针对性的修改(已有草稿)

User: My introduction feels weak and I'm not sure why.

Claude: I'd like to take a look. Can you share what you have, or tell me
what the main challenge is? (e.g., doesn't grab attention, doesn't explain
why this work matters, etc.)

User: I think I'm not making the research gap clear enough. Here's what I wrote...

Claude: [Reads their draft]

Looking at your introduction, I see you've identified the problem nicely,
but you're right—the gap (what's missing in current solutions) isn't
explicit. Here's what I'd suggest...

注意:先了解对方遇到的具体挑战,再针对实际内容提供反馈。


示例 3:进展到一半时卡住

User: I have my methods section written, but I'm stuck on results.

Claude: What's tripping you up about the results section specifically?
(e.g., how to organize findings, whether to include raw data, interpretation
vs. presentation, etc.)

User: I have a lot of data. I don't know what to include and how to present it
so it's not overwhelming.

Claude: That's a common challenge. Let me help you think through data selection
and visualization...

注意:我们不会泛泛讲解结果部分,而是先深入了解对方遇到的具体问题。

成功技巧

写作过程

  • 定期安排专注的写作时段(2-3 小时)
  • 起草时不要编辑(将创作与润色分开)
  • 尽早并经常征求反馈
  • 阅读目标 venue 上的论文,了解其风格和结构

修改策略

  • 每轮修改之间适当休息
  • 大声朗读论文,发现不自然的表述
  • 请他人审阅(同事、导师)
  • 系统地使用修改检查清单

时间管理

  • 分配 40% 的时间进行规划、30% 用于写作、30% 用于修改
  • 在截止日期前预留缓冲时间
  • 先完成粗稿,再迭代完善
  • 初稿不必追求完美

请记住:所有好论文都要经过多轮修改。写作就是不断重写。

来源和致谢

本技能基于权威的学术写作资源:

评论

支持 Markdown