mcpField
S
scientific-writing

scientific-writing

github.com/jackspace文档处理1661 次安装12 周前更新
代码仓库

关于 scientific-writing

Scientific Writing 是面向研究人员的科研写作技能,涵盖论文结构、引用、图表和研究报告规范。它还提供按章节、学科及期刊要求组织和修订稿件的指导。

主要功能

  1. 01按 IMRAD 组织论文
  2. 02撰写和修订各章节
  3. 03应用多种引用格式
  4. 04规划图表与数据呈现
  5. 05遵循研究报告规范
  6. 06适配期刊格式与术语

适用场景

  1. 01准备期刊投稿稿件
  2. 02撰写系统综述或病例报告
  3. 03依据 CONSORT 等规范报告研究
  4. 04回应审稿意见并修订论文

安装

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

$npx skills add https://github.com/jackspace/claudeskillz --skill scientific-writing

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

附带文件SKILL.json

详细介绍

科学写作

概述

科学写作是精准、清晰地传达研究成果的过程。采用 IMRAD 结构撰写稿件,并使用引文(APA/AMA/Vancouver)、图表和报告指南(CONSORT/STROBE/PRISMA)。研究论文和期刊投稿均可使用此技能。

何时使用此技能

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

  • 撰写或修改科学稿件的任何部分(摘要、引言、方法、结果、讨论)
  • 使用 IMRAD 或其他标准格式组织研究论文
  • 按特定样式(APA、AMA、Vancouver、Chicago、IEEE)设置引文和参考文献格式
  • 创建、设置或改进图表和数据可视化
  • 应用特定研究类型的报告指南(试验使用 CONSORT,观察性研究使用 STROBE,综述使用 PRISMA)
  • 撰写符合期刊要求的摘要(结构式或非结构式)
  • 为向特定期刊投稿准备稿件
  • 提升写作的清晰度、简洁性和精准度
  • 确保正确使用领域专有术语和命名法
  • 回复审稿意见并修改稿件

核心功能

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。

主要指南:

  • CONSORT:随机对照试验
  • STROBE:观察性研究(队列研究、病例对照研究、横断面研究)
  • PRISMA:系统综述和荟萃分析
  • STARD:诊断准确性研究
  • TRIPOD:预测模型研究
  • ARRIVE:动物研究
  • CARE:病例报告
  • SQUIRE:质量改进研究
  • SPIRIT:临床试验研究方案
  • CHEERS:经济学评价

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

6. 写作原则与风格

运用科学写作的基本原则。如需了解详细指导,请参阅 references/writing_principles.md。

清晰:

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

简洁:

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

准确:

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

客观:

  • 无偏见地呈现结果
  • 避免夸大研究发现或其意义
  • 承认存在相互矛盾的证据
  • 保持专业、中立的语气
7. 期刊特定格式要求

根据期刊要求调整稿件:

  • 遵循作者指南中的结构、篇幅和格式要求
  • 采用期刊特定的引文格式
  • 满足图表规格要求(分辨率、文件格式、尺寸)
  • 添加必需的声明(资金支持、利益冲突、数据可用性、伦理审批)
  • 遵守各章节的字数限制
  • 如提供模板,请按模板要求排版
8. 领域特定语言与术语

调整语言、术语和惯例,使其符合特定科学领域的要求。各领域都有既定词汇、惯用表达和领域特定规范,这些特征体现专业性,并确保目标受众清晰理解。

识别领域特定语言惯例:

  • 查阅目标期刊近期高影响力论文中使用的术语
  • 留意领域特定的缩写、单位和符号系统
  • 确定偏好的术语(例如,“参与者”而非“受试者”,“化合物”而非“药物”,“标本”而非“样本”)
  • 观察通常如何描述方法、生物体或技术

生物医学与临床科学:

  • 使用准确的解剖学和临床术语(例如,正式写作中使用“心肌梗死”,而非“心脏病发作”)
  • 遵循标准化的疾病命名规范(ICD、DSM、SNOMED-CT)
  • 药物名称优先使用通用名,必要时在括号中注明商品名
  • 临床研究使用“患者”,社区研究使用“参与者”
  • 遵循人类基因组变异学会(HGVS)的遗传变异命名规范
  • 使用标准单位报告实验室数值(多数国际期刊采用 SI 单位)

分子生物学与遗传学:

  • 基因符号使用斜体(例如,TP53),蛋白质使用常规字体(例如,p53)
  • 遵循物种特定的基因命名规范(人类基因使用大写:BRCA1;小鼠基因采用句首字母大写:Brca1)
  • 首次提及时写出完整的生物体名称,之后使用公认的缩写(例如,Escherichia coli,之后使用 E. coli)
  • 使用标准遗传学符号(例如,基因型使用 +/+、+/-、-/-)
  • 使用分子技术的既定术语(例如,“定量 PCR”或“qPCR”,而非“实时 PCR”)

化学与药学:

  • 遵循 IUPAC 化学物质命名法
  • 新化合物使用系统名称,广为人知的物质使用常用名称
  • 使用标准符号表示化学结构(例如,数据库中使用 SMILES、InChI)
  • 使用适当单位报告浓度(mM、μM、nM 或 % w/v、v/v)
  • 使用公认的反应命名法描述合成路线
  • 按领域定义一致使用“生物利用度”、“药代动力学”、“IC50”等术语

生态学与环境科学:

  • 使用双名法命名物种(斜体:Homo sapiens)
  • 相关时,在首次提及物种时注明分类学命名人
  • 使用标准化的生境和生态系统分类
  • 生态指标的术语保持一致(例如,“物种丰富度”、“Shannon 多样性指数”)
  • 使用领域标准术语描述采样方法(例如,“样带”、“样方”、“标记重捕”)

物理学与工程学:

  • 始终遵循 SI 单位,除非领域惯例另有要求
  • 对物理量使用标准符号(标量与向量、张量)
  • 使用现象的既定术语(例如,“量子纠缠”、“层流”)
  • 相关时注明设备的型号和制造商
  • 使用符合领域标准的数学符号(例如,用 ℏ 表示约化普朗克常数) 神经科学:
  • 使用标准化的脑区命名法(例如,参考 Allen Brain Atlas 等图谱)
  • 使用既定的立体定位系统标明脑区坐标
  • 遵循神经科学术语惯例(例如,正式写作中使用“动作电位”,而非“尖峰”)
  • 根据测量方法恰当使用“神经活动”“神经元放电”“脑激活”等术语
  • 具体准确地描述记录技术(例如,“全细胞膜片钳”“细胞外记录”)

社会与行为科学:

  • 适当使用以人为本的表述(例如,使用“患有精神分裂症的人”,而非“精神分裂症患者”)
  • 使用标准化的心理学构念和经过验证的评估名称
  • 遵循 APA 关于减少语言偏见的指南
  • 使用既定术语说明理论框架
  • 人体研究中使用“参与者”,而非“受试者”

一般原则:

匹配受众的专业水平:

  • 对于专业期刊:可自由使用领域专用术语,仅定义高度专业或新颖的术语
  • 对于综合性期刊(例如,Nature、Science):定义更多技术术语,并为专业概念提供背景说明
  • 对于跨学科受众:兼顾准确性与易读性,并在术语首次出现时进行定义

有针对性地定义技术术语:

  • 在缩写首次出现时对其进行定义:“信使 RNA(mRNA)”
  • 面向更广泛的受众写作时,简要说明专业技术
  • 避免过度定义目标受众熟知的术语(这会显得不熟悉该领域)
  • 如果不可避免地需要使用许多专业术语,请编制术语表

保持一致:

  • 同一概念始终使用同一术语(不要在“药物”“药品”和“医药制剂”之间交替使用)
  • 统一使用缩写(首次定义后,确定使用“PCR”还是“聚合酶链式反应”)
  • 全文采用同一套命名法(尤其是基因、物种和化学物质)

避免跨领域术语混用:

  • 不要在基础科学中使用临床术语(例如,不要把小鼠称为“患者”)
  • 避免用口语或过于宽泛的词语代替准确的领域术语
  • 从相邻领域引入术语前,先确认用法是否恰当

核实术语用法:

  • 查阅领域专用的风格指南和命名资源
  • 查看目标期刊近期论文中的术语用法
  • 使用领域专用数据库和本体(例如,Gene Ontology、MeSH 术语)
  • 不确定时,引用确立该术语用法的重要参考文献
9. 应避免的常见问题

常见拒稿原因:

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

写作质量问题:

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

手稿撰写工作流

阶段 1:规划

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

阶段 2:起草

  1. 从图表入手(呈现核心数据故事)
  2. 撰写方法部分(通常最容易先起草)
  3. 起草结果部分(客观描述图表)
  4. 撰写讨论部分(解读研究发现)
  5. 撰写引言(引出研究问题)
  6. 撰写摘要(综合完整研究故事)
  7. 拟定标题(简洁且描述准确)

阶段 3:修订

  1. 检查全文的逻辑脉络和“主线”
  2. 核实术语和符号的一致性
  3. 确保图表内容清晰、无需额外解释
  4. 确认符合报告规范
  5. 核实所有引文准确无误且格式正确
  6. 检查各部分的字数
  7. 校对语法、拼写和表达清晰度

阶段 4:最终准备

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

与其他科学技能的结合

此技能可与以下技能有效配合:

  • 数据分析技能:用于生成待报告的结果
  • 统计分析:用于确定合适的统计结果呈现方式
  • 文献综述技能:用于为研究提供背景
  • 图表创建工具:用于制作符合出版质量要求的可视化内容

参考资料

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

  • 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:有效科学交流的核心原则

在处理科学写作的特定方面时,按需加载这些参考资料。

评论

支持 Markdown