mcpField
A
alterlab-scientific-writing

alterlab-scientific-writing

github.com/alterlab-ieu文档处理7871 次安装5 周前更新
代码仓库

关于 alterlab-scientific-writing

alterlab-scientific-writing 指导研究者撰写和修订科学论文,涵盖 IMRAD 结构、引文格式、图表和报告规范。其写作流程强调先整理提纲,再将要点扩展为连贯的完整段落。

主要功能

  1. 01组织 IMRAD 论文结构
  2. 02撰写摘要及论文各部分
  3. 03应用 APA、AMA、Vancouver 等引文格式
  4. 04编排图表并遵循研究报告规范
  5. 05将提纲要点扩展为连贯段落

适用场景

  1. 01起草或修改期刊论文的各个部分
  2. 02按研究类型采用报告清单
  3. 03为期刊投稿调整稿件格式与表达
  4. 04回应评审意见并修订论文

安装

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

$npx skills add https://github.com/alterlab-ieu/alterlab-academic-skills --skill alterlab-scientific-writing

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

包含的文件

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

assets/
REPORT_FORMATTING_GUIDE.md
scientific_report_template.tex
scientific_report.sty
evals/
evals.json
references/
citation_styles.md
field_terminology.md
figures_tables.md
imrad_structure.md
outline_to_prose.md
professional_report_formatting.md
professional_report_quickref.md
reporting_guidelines.md
writing_principles.md

详细介绍

科学写作

概述

科学写作以精准、清晰的方式传达研究成果。使用 IMRAD 结构撰写稿件,采用引文格式(APA/AMA/Vancouver),并制作图表、遵循报告指南(CONSORT/STROBE/PRISMA)。研究论文和期刊投稿均可使用此技能。论点应以通过 alterlab-research-lookup 技能搜集的文献为依据,并逐条对照来源核实引文。

核心原则:最终稿件应以流畅的完整段落撰写,而非要点列表——审稿人和编辑会将要点列表视为尚未成形的思路,而研究发现之间的逻辑联系体现在列表所省略的过渡中。采用两阶段流程:首先使用 alterlab-research-lookup 创建包含关键要点的章节大纲,然后将大纲扩写为完整段落。

何时使用此技能

以下情况应使用此技能:

  • 撰写或修订科学稿件的任何章节(摘要、引言、方法、结果、讨论)
  • 使用 IMRAD 或其他标准格式构建研究论文
  • 按特定格式规范整理引文和参考文献(APA、AMA、Vancouver、Chicago、IEEE)
  • 创建、排版或改进图表及数据可视化内容
  • 应用针对特定研究的报告指南(试验使用 CONSORT,观察性研究使用 STROBE,综述使用 PRISMA)
  • 撰写符合期刊要求的摘要(结构式或非结构式)
  • 准备投往特定期刊的稿件
  • 提高写作的清晰度、简洁性和准确性
  • 确保正确使用领域专用术语和命名法
  • 回复审稿意见并修订稿件
不适用的情况
场景改用
通过多 Agent 流水线端到端地完成论文,包括 APA 7 LaTeX/DOCX/PDF 输出、双语摘要,或根据审稿意见信制定完整的修订路线图alterlab-paper-writer
特定期刊或会议的 LaTeX 模板、页数限制和格式规范alterlab-venue-templates
构建或清理 BibTeX 参考文献库本身alterlab-citation-mgmt
采用导师式工作流程撰写论文或学位论文的章节alterlab-thesis-supervisor
土耳其期刊的稿件(TR Dizin 规则、土耳其语 APA 7、双语 öz)alterlab-tr-academic-style

图表和视觉元素(可选)

精心选择的图表(例如图形摘要、方法流程图或概念图)可以增强稿件的表现力,但并非必需,只有在确实有助于提升清晰度时才应添加。如果图示或图表有助于理解,请调用 alterlab-scientific-schematics 技能(图表/示意图)或 alterlab-generate-image 技能(图像)。


核心能力

1. 稿件结构与组织

IMRAD 格式:按照大多数科学学科采用的标准“引言、方法、结果和讨论”结构指导论文写作。包括:

  • 引言:介绍研究背景,指出研究空白,陈述研究目标
  • 方法:详细说明研究设计、研究对象、流程和分析方法
  • 结果:客观呈现研究发现,不作解读
  • 讨论:解读结果,承认局限性,提出未来研究方向

有关 IMRAD 结构的详细指南,请参阅 references/imrad_structure.md。

替代结构:支持特定学科的格式,包括:

  • 综述文章(叙述性、系统性、范围综述)
  • 病例报告和病例系列
  • 荟萃分析和汇总分析
  • 理论/建模论文
  • 方法论文和方案
2. 特定章节的写作指南

摘要撰写:撰写简洁、独立成篇的摘要(100-250 词),概述论文的目的、方法、结果和结论。支持带有明确分节标题的结构式摘要,以及单段式非结构化摘要。

引言撰写:撰写引人入胜的引言,以:

  • 阐明研究问题的重要性
  • 系统回顾相关文献
  • 指出知识空白或争议
  • 明确提出研究问题或假设
  • 说明研究的新颖性和重要意义

方法撰写:通过以下内容确保研究可重复:

  • 详细描述参与者/样本
  • 清晰记录研究流程
  • 说明统计方法并阐述选择理由
  • 详细说明设备和材料
  • 声明伦理审批和知情同意情况

结果呈现:呈现研究发现时,应:

  • 按照从主要结局到次要结局的逻辑顺序展开
  • 结合图和表呈现结果
  • 报告统计显著性和效应量
  • 客观报告,不作解读

讨论撰写:综合研究发现时,应:

  • 将结果与研究问题联系起来
  • 与现有文献进行比较
  • 如实承认局限性
  • 提出可能的机制解释
  • 探讨实际意义和未来研究方向
3. 引文和参考文献管理

在不同学科中正确应用引文格式。完整的格式指南请参阅 references/citation_styles.md。

主要引文格式:

  • AMA(美国医学会):采用上标编号引文,医学领域常用
  • Vancouver:采用方括号编号引文,是生物医学领域的标准格式
  • APA(美国心理学会):采用作者-日期文内引文,社会科学领域常用
  • Chicago:采用注释-书目制或作者-日期制,适用于人文和科学领域
  • IEEE:采用方括号编号引文,适用于工程和计算机科学领域

最佳实践:

  • 尽可能引用原始来源
  • 纳入近期文献(活跃领域近 5-10 年的文献)
  • 在引言和讨论中均衡分布引文
  • 对照原始来源核实所有引文
  • 使用参考文献管理软件(Zotero、Mendeley、EndNote)
4. 图和表

制作有助于理解的有效数据可视化。详细的最佳实践请参阅 references/figures_tables.md。

何时使用表格,何时使用图:

  • 表格:适用于精确数值数据、复杂数据集,以及需要呈现确切数值的多个变量
  • 图:适用于趋势、模式、关系和通过视觉呈现更易理解的比较

设计原则:

  • 为每个表/图添加完整标题,使其内容不言自明
  • 在所有展示内容中使用一致的格式和术语
  • 为所有坐标轴、列和行标注单位
  • 注明样本量(n)和统计标注
  • 遵循“每 1000 词一张表/图”的原则
  • 避免在正文、表和图之间重复信息

常见图表类型:

  • 柱状图:比较离散类别
  • 折线图:显示随时间变化的趋势
  • 散点图:展示相关性
  • 箱线图:显示分布和离群值
  • 热力图:可视化矩阵和模式
5. 按研究类型划分的报告指南

遵循既定的报告标准,确保内容完整、透明。有关指南的详细信息,请参阅 references/reporting_guidelines.md。

主要指南(截至 2026-09 的当前版本;如需了解扩展内容,请查看 equator-network.org):

  • CONSORT 2025:随机对照试验(30 个条目,新增开放科学章节)
  • STROBE:观察性研究(队列研究、病例对照研究、横断面研究)
  • PRISMA 2020:系统综述和荟萃分析
  • STARD 2015:诊断准确性研究
  • TRIPOD+AI (2024):预测模型研究,包括回归或机器学习(取代 TRIPOD 2015)
  • ARRIVE 2.0:动物研究
  • CARE:病例报告
  • SQUIRE 2.0:质量改进研究
  • SPIRIT 2025:临床试验研究方案(34 个条目)
  • CHEERS 2022:经济学评价

每项指南都提供检查清单,确保报告涵盖所有关键方法学要素。

6. 写作原则与风格

遵循科学写作的基本原则。详细指导请参阅 references/writing_principles.md。

清晰:

  • 使用准确、明确的语言
  • 首次使用时定义专业术语和缩写
  • 确保段落内部及段落之间逻辑连贯
  • 适当使用主动语态,以提升清晰度

简洁:

  • 删除冗余的词语和短语
  • 尽量使用较短的句子(平均每句 15–20 个词)
  • 删除不必要的限定语
  • 严格遵守字数限制

准确:

  • 以适当的精度报告确切数值
  • 全文使用一致的术语
  • 区分观察结果与解释
  • 适当说明不确定性

客观:

  • 不带偏见地呈现结果
  • 避免夸大研究发现或其意义
  • 承认相互矛盾的证据
  • 保持专业、中立的语气
7. 写作流程:从提纲到完整段落

每个章节都应写成完整段落,并采用相同的两阶段流程:

  1. 提纲(仅用于规划)——使用 research-lookup 搜集文献,然后记下要点,标明主要论点、要引用的关键研究以及要纳入的数据。这些内容是写作框架,并非稿件正文。
  2. 转换为正文——将每个要点扩展为完整句子,通过自然的过渡语将引文融入正文,灵活变换句式,并确保逻辑连贯。

只有方法部分(纳入/排除标准、材料)和补充材料中可以使用列表——摘要、引言、结果、讨论或结论中均不得使用列表。摘要应写成连贯的段落,而非带标签的分节,除非期刊明确要求采用结构式格式。

完整的演示示例(从提纲到正文)、提纲与最终稿对照表、完整的应避免错误清单,以及 research-lookup 的整合方式,请参阅 references/outline_to_prose.md。

8. 专业报告格式(非期刊文档)

对于研究报告、技术报告、白皮书、资助/进度报告以及其他非期刊稿件的专业文档,请使用 scientific_report.sty LaTeX 样式包(Helvetica 字体、彩色框环境、专业表格,以及用于 p 值/效应量/CI 的科学记数法命令)。期刊稿件和会议论文应改用 alterlab-venue-templates;学位论文则使用所在机构的模板。

框环境、表格格式、符号命令、入门导言区,以及 XeLaTeX/LuaLaTeX 编译方法均记录在 references/professional_report_quickref.md 中;完整指南见 references/professional_report_formatting.md,样式包本身及模板位于 assets/。

9. 期刊特定格式要求

使稿件符合期刊要求:

  • 遵循作者指南对结构、篇幅和格式的要求
  • 采用期刊特定的引文格式
  • 满足图表规范(分辨率、文件格式、尺寸)
  • 包含必要声明(经费来源、利益冲突、数据可用性、伦理审批,以及披露准备稿件时是否使用了生成式 AI 协助——ICMJE 和大多数出版商都要求披露,且 AI 工具不能列为作者)
  • 遵守各章节的字数限制
  • 如提供模板,按照模板要求排版
10. 领域特定语言与术语

调整语言、术语和惯例,使其符合特定科学学科的规范。每个领域都有成熟的词汇、偏好的表达方式和领域特定惯例,这些都能体现专业性,并确保目标读者清晰理解。可通过查看目标期刊近期发表的高影响力论文,了解相关惯例,留意领域特定的缩写、单位、符号和偏好术语(例如,“参与者”与“受试者”)。

各领域普遍适用的原则包括:术语应与读者的专业水平相匹配(面向广泛读者的期刊,如 Nature/Science,应提供更多定义);缩写首次出现时应予以定义;全文术语和命名法应保持一致;避免跨领域混用错误(不要把小鼠称为“患者”);并参照领域风格指南、本体(Gene Ontology、MeSH)和近期论文核实用法。

有关各学科(生物医学/临床、分子生物学与遗传学、化学、生态学、物理学/工程学、神经科学、社会科学与行为科学)的惯例,以及完整的一般原则,请参阅 references/field_terminology.md。

11. 应避免的常见问题

主要拒稿原因:

  1. 统计方法不恰当、不完整或描述不充分
  2. 过度解读结果或得出缺乏依据的结论
  3. 方法描述不充分,影响研究的可重复性
  4. 样本量过小、存在偏差或不恰当
  5. 写作质量不佳或文本难以理解
  6. 文献综述或背景介绍不充分
  7. 图表不清晰或设计不佳
  8. 未遵循报告指南

写作质量问题:

  • 时态混用不当(方法和结果使用过去时,公认事实使用现在时)
  • 术语过多或缩写未定义
  • 段落划分打断逻辑脉络
  • 章节之间缺少衔接
  • 符号或术语不一致

手稿撰写工作流

阶段 1:规划

  1. 确定目标期刊并查看作者指南
  2. 确定适用的报告指南(CONSORT、STROBE 等)
  3. 拟定手稿结构(通常采用 IMRAD)
  4. 将图表作为论文的骨架进行规划

阶段 2:起草(每个部分都采用两阶段写作流程)

  1. 从图表开始(核心数据叙事)
  2. 对以下各部分采用两阶段流程:
    • 第一步:使用 research-lookup 创建要点大纲
    • 第二步:将要点扩展为流畅的完整段落
  3. 撰写方法部分(通常最容易先起草)
  4. 起草结果部分(客观描述图表)
  5. 撰写讨论部分(解读研究发现)
  6. 撰写引言(提出研究问题)
  7. 撰写摘要(概述完整的研究内容)
  8. 拟定标题(简洁且具有描述性)

要点只是规划用的脚手架;在交出草稿前,请将其改写为段落。

阶段 3:修订

  1. 检查全文逻辑流畅,并贯穿“红线”
  2. 确认术语和符号的一致性
  3. 确保图表无需额外说明即可理解
  4. 确认符合报告指南
  5. 核实所有引文准确无误且格式正确
  6. 检查各部分的字数
  7. 校对语法、拼写和表达清晰度

阶段 4:最终准备

  1. 按照期刊要求排版
  2. 准备补充材料
  3. 撰写强调研究意义的投稿附信
  4. 完成投稿检查清单
  5. 收集所有必需的声明和表格

与其他科学写作技能的协作

使用此技能掌握一般科学写作技巧(IMRAD、表达清晰度、行文,以及正文中的引文样式)。如果任务属于其他技能的范围,请交由相应的同类技能处理:

  • alterlab-research-lookup — 搜索文献,为阶段 1 的大纲补充内容并为论点提供依据。
  • alterlab-venue-templates — 了解特定投稿渠道的 LaTeX 模板、页数限制/排版规则和专属写作风格(Nature/Science、Cell Press、医学期刊、ML/CS 会议)。先应用此技能的原则,再根据该技能适配。
  • alterlab-citation-mgmt — 构建/验证 BibTeX 参考文献库并获取参考文献元数据(此技能负责正文中的引文样式,但不构建参考文献库)。
  • alterlab-scientific-schematics / alterlab-generate-image — 在图示有助于清晰表达时,制作示意图/图表和图像。

排版路由:期刊手稿和会议论文使用 alterlab-venue-templates。研究报告、白皮书、技术报告和资助/进展报告使用 scientific_report.sty(此技能,第 8 节)。学位论文使用院校模板。

参考资料

此技能包含全面的参考文件,涵盖科学写作的具体方面:

  • references/imrad_structure.md:IMRAD 格式和各部分具体内容的详细指南
  • references/citation_styles.md:完整的引文样式指南(APA、AMA、Vancouver、Chicago、IEEE)
  • references/figures_tables.md:创建有效数据可视化的最佳实践
  • references/reporting_guidelines.md:针对不同研究的报告标准和检查清单
  • references/writing_principles.md:有效科学沟通的核心原则
  • references/outline_to_prose.md:从大纲到段落的两阶段流程,包含完整示例和应避免的错误
  • references/field_terminology.md:各学科的语言惯例和通用术语原则
  • references/professional_report_quickref.md:scientific_report.sty 的方框环境、表格排版、符号命令和入门导言区
  • references/professional_report_formatting.md:使用 scientific_report.sty 进行专业报告排版的综合指南

资源

此技能包含用于专业报告排版的 LaTeX 样式包和模板:

  • assets/scientific_report.sty:专业的 LaTeX 样式包,包含 Helvetica 字体、彩色文本框和美观的表格
  • assets/scientific_report_template.tex:完整的报告模板,展示了所有样式特性
  • assets/REPORT_FORMATTING_GUIDE.md:样式包快速参考指南

scientific_report.sty 的主要特性:

  • Helvetica 字体系列,呈现现代、专业的外观
  • 专业的配色方案(蓝色、绿色、橙色、紫色)
  • 文本框环境:keyfindings、methodology、resultsbox、recommendations、limitations、criticalnotice、definition、executivesummary、hypothesis
  • 具有交替行颜色和专业表头的表格
  • 用于表示 p 值、效应量和置信区间的科学记数法命令
  • 专业的页眉和页脚

根据需要加载这些参考资料,以便撰写科学文本的特定部分。

AlterLab Academic Skills 套件的一部分。

评论

支持 Markdown