agentleFS
songyuyao7952songyuyao7952/scientific-article-writing-skill/SKILL.md

scientific-article-writing

Skill0 starsChanged 4 months agoMITView on GitHub

指导SCI/学术论文的写作、评价与修改。Use when the user asks to draft, evaluate, score, critique, revise, polish, or re-orient a scientific manuscript, thesis chapter, or paper (e.g. 帮我写论文/评价这篇稿子/打分/修改论文/返修/调整方向/润色). Provides IMRAD section-by-section checklists, abstract/title/references guidance, tense & language rules, a full evaluation→suggestions→how-to-revise→revised-output pipeline, and target-journal direction adjustment. Based on Ecarnot et al. 2015.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. bas1l/claude-skills★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

Files
SKILL.md

学术论文写作 / 修改 / 方向调整指南

用途与触发时机

当用户需要:写一篇新的学术论文/学位论文章节、修改或润色已有稿件、按审稿意见返修、调整论文的研究或叙事方向、为投稿选刊、或评审一份手稿时,使用本技能。

本技能基于 Ecarnot 等(2015)的经典写作指南,按 IMRAD 结构给出每一节的具体写作要素、示例、时态建议与常见误区,并延伸出三类工作流:局部修改与审稿返修、方向调整、评价与修改全流程(评价 → 修改建议 → 如何修改 → 修改结果)。三类工作流的触发边界如下:

工作流何时用典型请求
一:局部修改与审稿返修只改/润色特定段落、单节,或按审稿意见返修,不需要整稿评价"改改这个段落"、"润色结果部分"、"回复审稿人意见"
二:方向调整稿件"看起来不对"、被拒、选刊没把握、研究重定位"这篇投哪里好"、"帮我调整方向"
三:评价与修改全流程给出/贴出完整稿件,要求评价、打分并修改"评价这篇稿子并给出修改意见"、"整稿审查"

核心原则

  1. 写作前准备先行:好的论文来自好的研究计划。写作用到的文献综述、统计结果、图表,应在研究规划阶段就积累好。
  2. 从读者角度写作:目标读者决定内容深度。专业性期刊可写得更技术化,综合类期刊需更通俗。
  3. 一致性:研究目标(objective)的表述必须在题目、摘要、引言、结果、讨论中保持一致,重复不是坏事。
  4. 不夸大、不解释过度:结果只陈述事实,解释留给讨论;讨论中不得改变结果的细微含义。
  5. 先写初稿再精修:本指南帮助写出合格初稿,然后交给合著者与资深导师打磨。

写作前准备(动手写之前的清单)

  • 已做充分的文献综述,确定研究的新颖性(originality)
  • 阅读文献时随手记录"要点/原句 + 精确出处",使用文献管理软件(EndNote / Zotero / Mendeley 等)
  • 已有统计分析的最终结果,作为结果部分的基础;标注最重要的发现,准备用作图件
  • 已选定目标期刊:确认稿件在期刊范围内(scope),阅读"作者须知"
  • 明确读者类型(领域专家 / 跨学科专家 / 一般读者)
  • 明确期刊的编辑政策偏好(基础研究 vs 临床/应用研究)

论文主体结构:IMRAD

绝大多数期刊采用 IMRAD 结构:Introduction → Methods → Results → Discussion,外加 Abstract、Title、References(以及可选的 Acknowledgements、Conflicts of interest、Authors' contributions)。动笔前务必核对目标期刊的作者须知。


1. Introduction(引言)

作用:吸引读者(尤其审稿人),让其产生"我怎么没想到"的感觉。说明为什么做这项研究、要达成什么、对已有证据库有什么补充。

写作顺序(逻辑流):

  1. 背景:用恰当的参考文献简要说明该主题已知什么(不要面面俱到,选最相关的文献即可)
  2. 收窄:指出仍存在不确定性的领域,引用既往(可能相互矛盾的)数据
  3. 明确研究空白(gap):这是证明研究价值的关键,必须明确表述
  4. 工作假说(hypothesis):明确提出
  5. 目标(objective):包含将要测量的具体参数、研究人群/临床背景、次要目标;"We hypothesized that … would reduce/increase … in the context of …"
  6. 策略简述:一句话带过实现目标的方法("Through a prospective, single-/multicentre, observational/interventional … study")

要点:

  • 每句话都要有目的,避免跑题;引言一般约 1 到 1.5 页(以期刊限制为准)
  • 目标表述要与研究方案(protocol)一致,并在全文(题目、摘要、引言、结果、讨论)中使用同一表述
  • 目标要明确,指明测量什么参数、用什么手段
  • 在引言中就点出研究能为领域带来的"新增价值"(sales pitch,但措辞要得体)

Introduction 时态建议(Table 2):

目的时态示例
描述当前知识状态一般现在时Cancer is a common disease
描述他人已发表的研究过去时Smith et al. showed that drug A reduced the rate of death
描述始于过去且未完成的过程现在完成时Several researchers have investigated the effect of drug A
描述尚未发生的事现在完成时It has not yet been determined whether …
表述假说第一个动词过去时,第二个现在时We hypothesized that drug A increases the risk of bleeding
表述目标过去时We aimed to measure …

2. Methods(方法)

作用:精确描述做了什么、怎么做,详细到任何具有同等资源的普通读者都能复现。

要素清单:

  • 研究设计:前瞻/回顾、随机/非随机、双盲/开放、对照、交叉、析因等;非常规方法须给出依据(文献、指南或具体背景说明)
  • 研究对象/人群:纳入与非纳入(exclusion)标准;筛选合格病例的流程(门诊、入院、查房、病例讨论会等)
    • 回顾性研究:先描述数据来源、纳入/排除标准、最终入选病例数
    • 前瞻性研究:纳入/排除标准放在方法,最终纳入人数是结果,应写在结果部分
  • 测量方法与终点:逐一说明所有记录参数所用的方法;必须说明主要终点(primary endpoint)与次要终点及其测量方法——主要终点的选择决定研究成败,是唯一允许对研究结局下正式结论的标准
  • 细节:每项检查/干预/操作都要写明;必要时给出设备厂商(制造商名、城市、国家);可用小标题分段(demographic data, treatments 等)
  • 伦理:伦理委员会批准(委员会名称、批准日期、必要时文件号);书面知情同意;随机对照试验需注明临床试验注册号(如 ClinicalTrials.gov)
  • 统计分析:数据呈现方式(正态分布用 mean ± SD,非正态用 median [IQR],分类数据用 n (%));具体检验方法与变量对应;多因素分析及纳入变量;生存分析方法;样本量计算(含预期结局频率、方差、期望差异、α 和 β 风险);显著性水平;所用软件;预先计划好的亚组分析(避免事后分析的质疑;注意多重比较需 Bonferroni 校正)

Method 时态:主要用一般过去时(we performed, we recorded, we measured, we tested);研究之前发生的事件用过去完成时("when thrombolysis had failed, we initiated …")。

检查项:结果部分出现的每一个结果,方法部分都必须有对应的方法。


3. Results(结果)

作用:客观描述观察到的结果,不加评论、不加解释。

要点:

  • 不再重复方法;一个结果对应一个方法;结果顺序与方法顺序一致
  • 使用与方法相同的小标题,便于阅读
  • 典型段落写法:先点明分析类型("QCA analysis revealed that …"),再给出结果并引用图表("the number of lesions was significantly higher in group A compared to group B")
  • 时态:一般过去时("serum creatinine was correlated with glomerular filtration rate")
  • 禁用:"surprisingly…"、"interestingly…" 等评论性/解释性表述
  • 图表选择:能一两句话说明的结果写进正文;多组间同一变量的数据(基线特征、结局、治疗)用表格;关系与趋势用图。不要在正文中重复表格/图里已出现的数据
  • 控制图表数量,避免过多插图削弱其价值

4. Discussion(讨论)

作用:解释结果的意义,并把结果放进更大的图景中。

结构建议:

  1. 简要重述主要发现:用与引言中主要目标、方法中主要终点相同的表述
  2. 解释结果:不简单复述结果,也不过度解释;陈述要事实化("our results indicate that drug X may have significant adverse effects",而不是把"20/25 患者出血"改写为"80% 患者会出血")
  3. 与文献对比:与其他研究的异同;如有差异,给出合理解释(人群、环境、方法上的差异);惊讶或有趣的发现要讨论并给出可能解释
  4. 整体意义:多种分析/干预放在一起看,说明总体意义;结果能否外推到其他情境/人群,不能则说明原因
  5. 新的贡献:明确本研究发现的新证据,如何填补引言中提出的知识空白
  6. 对实践/认识的影响:结果可能如何影响实践或共识
  7. 未来研究方向:尤其是次要目标观察衍生出的新假说
  8. 优点与局限性:主动列出局限性——既显示作者清醒,又给自己辩护的机会;优点也要提及

外交措辞:批评他人研究时用软化措辞——不说"Smith's study was underpowered",而说"Smith's study may have been underpowered",或更好"our study had sufficient statistical power to detect …"。

关于阴性结果:不要害怕写阴性结果。设计良好、执行规范的阴性研究同样是有价值的贡献(挑战普遍观点、支持少数矛盾证据、强化小样本证据)。

警惕:非英语母语作者改写他人文献时,注意措辞和语序可能悄悄改变原意——合著者与资深导师的复核非常重要。


5. Abstract(摘要)

作用:独立的、可脱离全文理解的单元(用于数据库检索、审稿邀请);是研究的"营销工具",需简洁、信息量大、有吸引力。

内容(Table 4):

  • Background:2–3 句,简述背景 + 主要目标 + 要填补的空白
  • Methods:主要纳入标准(如"成人[>18岁]脓毒性休克,定义为充分液体复苏后仍持续低血压")、分组、干预/治疗简述、主要终点
  • Results:列出主要结果(均值、OR、p 值),先主要终点,后次要结局;为方法部分提到的每个方法给出对应结果;细节足以支撑结论
  • Conclusion:一句话总结主要发现,有余力可加一句未来研究意义;结论须直接对应主要目标与终点

禁止:摘要中不得出现参考文献、讨论或评判性表述(如"Surprisingly, we observed …")、图表。

技巧:引言中 1–2 句可缩写后复用;结果主要从结果部分复制;结论即主要 take-home message;最难的是压缩到期刊字数限制。


6. Title(题目)

作用:含关键词以便检索(PubMed 等),激发阅读欲望,并体现本文的相对贡献。

要点(Table 5):

  • 体现研究的主要因素:药物/干预名称、人群/临床背景、设计类型、主要发现
  • 最重要的一点放最前面(如干预是本研究的特色,就以干预名开头)
  • 避免空洞表述:不用 "a report of …"、"the effects of …"(若有效应,就写明是什么效应)
  • 药物用国际通用名,避免商品名(商品名暗示厂商偏好,且各国不一致)
  • 副标题慎用,仅用于研究组名等;注意期刊对字数/字符数的限制
  • 从高水平期刊(综合与领域顶级)的题目中寻找灵感

7. References(参考文献)

责任:准确记录所用来源是伦理与职业责任;引文支撑假说并帮助读者延伸阅读。

要点:

  • 引用标准:凡来自他人(而非自己)的想法或事实都要引;普遍真理无需引("cancer is a major cause of death");他人提出的专有名词/命名系统必须引原文(如 "McConnell Sign"、"BARC criteria")
  • 优先引英文同行评议期刊的原始研究文章,少引综述;引书需精确到章节、页码、作者/编者与出版信息
  • 尽量避免网络来源、私人通信、未发表数据
  • 若多个候选文献,优先选最新、来源期刊最权威的
  • 引二手文献时要回到原始文献核对,引用原始作者而非中间文献;自己核验每条引文的准确性(即使是转录自他文),不要指望期刊帮你核对
  • 按目标期刊的引文格式排版,可借助文献管理软件
  • 阅读文献时随手记录要点与出处,避免事后大海捞针

工作流一:局部修改与审稿返修(Focused Revision)

触发条件:用户只要求修改/润色特定段落或单节(不要求整稿评价),或按审稿意见返修。若用户给出完整稿件并要求系统评价,改用工作流三。

  1. 明确范围:确认要改的是哪一节/哪几句;确认目标期刊;确认当前阶段(初稿 / 待润色 / 返修)
  2. 定位问题:先引用原文,说明问题(缺失、不一致、表述不当、时态错误等),并对照上文各节规范给出依据
  3. 分级:每个问题按严重度分级(Critical 必须改 / Major 重要 / Minor 润色级),并标注问题类型(编辑性 / 科学性 / 统计性 / 政策 / 需作者决策)。分级标准见工作流三 A3
  4. 先改事实与数字,再动文字:涉及数据/结论的修改必须以用户提供的原始资料为准,标【待确认】;绝不臆造
  5. 按审稿意见返修:对每条审稿意见 分类 → 定位受影响段落 → 先改数据/事实再改文字 → 回复中说明"改了什么、改在哪"。不因审稿意见而捏造、隐瞒或夸大
  6. 输出格式:三栏对照表——修改前原文 | 修改后文本 | 修改理由;涉及数据的标【待确认】;修改后提醒用户复核

工作流二:方向调整(Direction Adjustment)

当稿件"看起来不对"、"被拒"、"投哪个刊没把握",或研究中途需要重新定位时使用。

  1. 定位问题层级:是叙事方向问题(整个故事讲错了),还是结构问题(内容对但组织乱),还是目标错位(研究与期刊/读者不匹配)?
  2. 重新审视"研究空白":引言中 gap 是否清晰且成立?若被质疑新颖性,调整叙述重心,把亮点(最有别于已有文献之处)前置
  3. 目标-内容对齐:若目标与结果不匹配,二选一——要么调整目标的表述以准确涵盖实际做的研究,要么调整展示的内容聚焦于目标(不能伪造结果去迁就目标)
  4. 选刊与读者重定位:明确期刊读者类型与编辑偏好,据此调整背景的详细程度、术语密度、篇幅;确认稿件在期刊 scope 内;必要时建议更合适的目标期刊
  5. 结构重排:按"引言 gap → 方法 → 结果(与方法同序)→ 讨论"重新组织;把最重要的信息(干预/发现)前置到题目与引言
  6. 强化 or 弱化:识别可扩展为图/表的重点结果;删除重复或离题内容
  7. 输出:给出调整前后的整体叙事大纲(outline)对比、每个被改动节的理由、以及重写后的关键段落(题目、摘要、引言 gap 段落等)

工作流三:评价与修改全流程(Evaluation → Revision Pipeline)

当用户给出/贴出完整稿件(或要求"评价这篇稿子"、"给稿子打分并给出修改意见")时,按四阶段完整走一遍:A 评价 → B 修改建议 → C 如何修改 → D 修改结果。每阶段都必须在同一轮答复中连续产出,形成闭环。

A 阶段:评价(Evaluation)

A1. 逐维度评价:按下列 10 个维度逐项给分并写明依据与证据定位(引用原文句/段落/图表)。评分标准:优 9–10 分(可作为范例)/ 良 7–8 分(有小瑕疵)/ 中 5–6 分(存在明显不足)/ 差 <5 分(不达标,需重写)。

#维度评什么评分
1新颖性与研究空白引言是否明确指出 gap;gap 是否真实成立;研究价值是否说清
2结构与逻辑流是否 IMRAD 顺序;引言漏斗逻辑是否顺畅;小节标题是否与内容对应
3目标一致性目标表述在题目/摘要/引言/结果/讨论中是否完全一致
4方法完整性是否可复现;设计/人群/终点/测量/伦理/统计六要素是否齐全
5结果呈现是否只陈述不解释;顺序是否与方法一致;是否有对应方法;是否重复图表数据
6讨论深度与克制是否重述结果/过度解释;是否与文献对比并软化批评;有无优点与局限性
7摘要是否独立可读、结构完整(B/M/R/C);是否含数据;有无禁止项(文献/图表/评判语)
8题目与关键词是否含检索关键词;是否体现因素/人群/设计/主要发现;有无空洞表述
9参考文献格式是否合规;是否准确;是否引用二手文献而未回溯原始出处;是否为必要引用
10语言与期刊匹配时态是否符合各节要求;是否为该刊读者调整了深度与篇幅;有无评论性/口语化表述

A2. 总体结论:给出一句话总体判断(如"内容扎实但结构混乱,建议重点修改引言与讨论")+ 与目标期刊水平的差距评估(若用户提供期刊名)。附评分聚合规则(辅助快速判断,不替代问题清单):存在任一 Critical → 大改后再投;无 Critical 且 Major ≤ 3 → 小改后可投;全部 ≤ Minor → 润色后即可投。

A3. 问题清单:把发现的所有问题编号(P1, P2, …),每项含:问题描述 → 具体位置(引用原文)→ 严重度分级 → 问题类型。两个轴是正交的,每个问题都必须同时标注,全技能统一使用这套体系:

  • 严重度:
    • Critical(必须改,涉及科学正确性):数据错误/缺失、方法-结果不对应、结论超出证据、gap 不成立、伦理缺失、主要终点缺失
    • Major(重要,明显影响发表):结构混乱、目标不一致、讨论过度解释、摘要不合格、图表冗余
    • Minor(润色级):时态错误、词汇、标点、格式、重复表达
  • 问题类型(描述问题性质,不替代严重度):编辑性 / 科学性 / 统计性 / 政策(伦理与合规) / 需作者决策(如作者排序、期刊选择、结论取舍)

B 阶段:修改建议(Revision Suggestions)

B1. 逐条给建议:对 A3 中每个问题给出 2–3 条可执行的修改建议,说明"建议改成什么 + 为什么这么改"。建议必须引用本技能各节的写作规范作为依据。

B2. 按问题类型给出标准修法:

问题类型如何修改(标准修法)
gap 不清晰/不成立重写引言漏斗:已知 → 不确定/矛盾 → 明确一句"To date, no study has investigated …";必要时把对比文献换成更能凸显空白的近期文献
目标不一致选定一个标准表述(含参数+人群+手段),替换题目/摘要/引言/结果/讨论中所有相关句
结构混乱按 IMRAD + 各节内部顺序重排;每节配小标题并保持结果与方法小标题一致
方法-结果不对应逐个结果反查方法:缺方法→在方法中补写;缺结果→从结果删除或标注;逐一消除错配
讨论过度解释/复述删掉复述句;把超出数据的推断降级为"may/our results indicate";把解释性内容从结果移入讨论
摘要不合格重写为 B/M/R/C 四段;先主要终点后次要;补齐数据支撑结论;删评判语
时态错误按上文各节时态规范逐句修正(Introduction 见时态表,Methods/Results 见对应小节)
数据表述夸大保留原始数据精确表述(n/总数、mean±SD),不换算成误导性百分比;重述时用"may indicate"级推断
批评他人措辞生硬改用软化措辞("may have been underpowered" / "our study had sufficient power to detect …")
参考文献问题回到原始文献核对;按期刊格式重排;删除引而不述或述而不引的条目
语言润色精简冗余、去口语化(surprisingly/interestingly/very/obviously)、统一术语、被动语态与主谓结构符合期刊风格

C 阶段:如何修改(How to Revise)

C1. 修改顺序:先修 Critical(数据/事实层),再修 Major(结构/内容层),最后 Minor(语言/格式层)。必须先改事实与数字,再动文字,避免文字改完了数据又要推翻。

C2. 逐项给出"具体改法":对每个问题给出可直接使用的修改文本(改写句、替换段落、补写的方法段落、重排后的小节顺序等),并标出需要用户核实/提供的数据(用【待确认】标记,如样本量、p 值、伦理批件号——AI 绝不自行填补)。

C3. 边界:涉及科学结论、数据真实性、作者贡献、期刊选择等决策,AI 只给建议与备选方案,最终由用户定夺。

D 阶段:修改结果(Revised Output,全流程交付)

D1. 交付四件套:

  1. 评价报告:A 阶段的维度评分表 + 总体结论 + 问题清单(含分级)
  2. 修改方案书:B 阶段的逐条建议 + 标准修法对照表
  3. 修改对照表:对每个实际修改给出三栏——修改前原文 | 修改后文本 | 修改理由(引用对应规范);涉及数据的标注【待确认】
  4. 修改后全文:若用户要求,输出整合后的完整稿件/章节(用批注或标记高亮所有改动处)

D2. 复核清单(提交前逐项自查):

  • 所有 Critical 问题已清零;Major 已解决或用户确认放弃
  • 题目/摘要/引言/结果/讨论的目标表述完全一致
  • 每个结果都有对应方法;方法没有"空转"(无结果的描述)
  • 摘要为独立可读单元,含数据、无禁止项
  • 全文时态符合各节规范
  • 正文与图表数据无重复、无冲突;单位/样本量/分母统一
  • 参考文献格式合规、准确、无【待确认】残留
  • 无虚构数据/引文/DOI;所有 AI 补写内容已标注需作者复核

D3. 闭环说明:交付后列出"仍需作者本人完成"的事项(核实原始数据、补充伦理文件、与合著者确认作者排序、期刊格式微调),避免把 AI 初稿误当可投终稿。

必须遵守的底线

  • 绝不编造:不虚构数据、结果、引文、DOI、样本量、统计值、伦理审批、作者贡献
  • 不确定就标注:缺失或未核实的信息明确标记,不与用户核实不得填写
  • 保密:未发表稿件、审稿材料等敏感内容不外传
  • 数据核实:任何数字/事实性修改必须以用户提供的原始资料为准
  • 不当"作者":AI 是写作助手,科学决策与最终定稿由人类作者负责

参考文件

  • references/ecarnot2015_source.txt — Ecarnot et al. 2015 原文全文(含 Table 1–5 与 Fig.1 说明),需要核对原文字句时查阅

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.