agentleFS
yubinfengjjdyubinfengjjd/research-jjd/medical-sci-results/SKILL.md

medical-sci-results

Skill1 starsChanged 27 days agoMITView on GitHub

Use when drafting, continuing or revising the Results section of a medical SCI manuscript from figures, figure legends, tables, source data and an author-confirmed outline, such as 医学结果部分写作、Results 中英对照、按图写结果、根据 figure 和 figure legend 写结果描述、续写下一节结果、修改已有 Results 稿. Produces bilingual (English with paragraph-level Chinese) Results with bilingual subheadings, figure citations after each claim and a 核查说明 when triggered. Do not use for Methods (use medical-sci-methods), Discussion, figure legends, outline building or figure work.

The file

Files
SKILL.md

医学 SCI Results 写作

依据成图、图例、表格、源数据和作者确认的大纲,撰写或修订正式英文 Results,附逐段中文对照和中英双语小标题。正文只陈述图表支持的结果,突出核心发现,不复述方法、不描述绘图、不过度解读。

证据保留的修订契约

默认允许同节合并、去重、重排,保留来源、分析范围、数字/CI 归属、必要限定、不利发现与引用支持关系;不改数据、统计逻辑或研究问题。篇幅由作者/期刊与证据决定,无通用最低词数;历史篇幅/句数只作参考,沿用项目引用软配额,不为填数扩写。

实质叙事问题须改文或给具体保留理由;英文重构后同步对应 ZH 和已有 EN_ZH,归档原件。未知局部范围保留并记录,继续独立编辑;作者动作按问题归组,核心矛盾阻断受影响交付。公开披露已承诺或结论相关的未完成分析,内部备用实验/审批/版本记录留在过程文件。结构记录与核验按 结构审查契约,脚本通过不证明科学等价。

必读材料(每次起草、修订或续写都执行)

不凭技能名称或上次任务的摘要开始写作。按顺序完整读取:

  1. 原始提示词:基础角色与写作要求。
  2. 已确认写作规则:对原始提示词的细化,冲突时以它为准。
  3. 期刊语言与格式规范:图号、数值、时态、拼写、篇幅。
  4. 判断示例:只学判断方式,不迁移具体内容。
  5. 项目目录下的 Results_作者决定.md(如存在):已裁决事项直接沿用。

当前用户指令优先于以上材料。

工作流程

  1. 定位:读取大纲的 Results 部分,确定本次范围(全部或某节)、各节的分段规划、图表清单和措辞边界。续写时读取已完成节段,确定“下一节”。
  2. 读图与图例:对每个涉及的 Figure,用图像查看工具打开成图 PNG,再读定稿图例和详细图注;对每个 Table 读 md 或 csv。逐 panel 记录:显示了什么、核心结果、关键数字及出处、是主图还是附图、在大纲中属于哪一段(规则第 1、3 节)。
  3. 核对数字:大纲中的每个数字都到表格或源数据中找到对应值,记录出处;发现不一致按规则第 1 节处理并记入核查说明。只在图上有、材料中没有数值的趋势,只作定性描述。
  4. 梳理主附图与叙事:以大纲科学主线为起点,按证据关系组织段落与图表引用;允许同节内合并、去重和重排,保留分析范围、出处与引用支持(规则第 2、3 节)。
  5. 撰写英文:围绕研究问题和证据量安排结果、对比及重要例外,主附图在相应论断处引用;先核对证据覆盖,再删除重复或调整顺序。篇幅按作者/期刊与实际证据决定,无通用最低词数或默认全文配额;四层信息仅作审查维度,不逐段套模板(规则第 3–5 节)。
  6. 撰写中文对照:逐段重组为规范中文,事实、数值、限定和图号与英文一致(规则第 6 节)。
  7. 复核:按下方“交付前检查”逐项确认,再按规则第 8 节决定是否输出核查说明。

默认在当前会话中完成,不派出子代理。

项目约定(检测到 PROJECT.md 时)

从工作目录或材料路径向上查找 PROJECT.md。找到时按 medpaper-pipeline 的项目目录约定(medpaper-pipeline/references/project-layout.md)执行,用户另行指定的路径优先:

  • 默认材料:03_outline/ 的大纲、02_figures/out/ 的成图与源数据、04_manuscript/Legends/ 的图注、04_manuscript/Methods/Methods_EN.md。
  • 输出到 04_manuscript/Results/,文件名固定为 Results_EN.md、Results_ZH.md、Results_EN_ZH.md、Results_核查说明.md,不加项目前缀或版本号。
  • 已有同名成稿时,先把旧文件移到 _archive/<今天日期>/04_manuscript/Results/,再写新文件;更新 PROJECT.md 状态表中 Results 一行(状态 待确认、版本、日期)并在变更记录追加一行。
  • 作者决定读 04_manuscript/作者决定.md 的“通用”和“Results”两节,代替单独的 Results_作者决定.md;新裁决追加到“Results”节。
  • 审查、盲测、对照稿等过程文件放 _process/Results/<YYYY-MM-DD>_<描述>/,不放成稿目录。

没有 PROJECT.md 时保持下文原有行为,不新建它。

一致性防线(检测到 PROJECT.md 时)

按 medpaper-pipeline/references/consistency-guards.md 执行:

  • 写作前读项目根的 口径表.md:术语用规范名,不用禁用别名;量的定义和关键计数照口径表写。图表标签与规范名不同时,在图注或正文中括注对应(如“目标标签拟合参照(图中 R2 (oracle))”)。
  • 材料冲突按统一权威顺序取舍:代码与回执 > source.json 数值与 definitions > 成图图面 > Methods > 详细图注 > 大纲与规格叙述 > 已写成的下游稿件。本技能其他章节中与此冲突的取舍规定,以此为准。
  • 大纲的节标题只是写作意图,不是事实依据。逐队列、逐类别核对数据后,标题只写数据能支持的范围;与大纲标题不一致的,登记为台账“口径”类条目,不再只写在核查说明里。“定稿图例措辞优先”只适用于没有代码或数据可以判定的定性表述。
  • 发现冲突时登记到 _process/冲突台账.md(写明双方原文、出处、源头阶段和应改的上游文件)。事实类(有代码或数据作证:拟合分区、符号、计数、分组、量的定义、panel 字母)先把被改文件备份到 _archive/<日期>/,再直接修改上游文件和已受影响的下游文件,同步口径表;口径类(措辞强弱、结论范围、术语选择)和图面类只登记,等阶段关口由作者裁决。
  • 核查说明的“需作者裁决事项”只列台账 ID 和一句摘要;台账中已修复或已裁决的事项不重复上报。
  • 交付前依次运行(用 python -X utf8 运行脚本(PATH 上的 python 若是 Windows 商店空壳,改用真实解释器的完整路径)):<medpaper-pipeline>/scripts/consistency_check.py <项目根>(禁用别名与关键计数,命中项修掉或登记),再运行 <medpaper-pipeline>/scripts/manuscript_check.py results <本稿 EN 文件> --zh <本稿 ZH 文件>,ERROR 先修掉,WARN 逐条在核查说明中说明(脚本口径见 consistency-guards 第 5 节)。

输出

  • 每节结构:## 3.x English subheading 下一行 **中文小标题**;有子节时同样处理 ###。随后英文段落与中文段落逐段交替(合并稿)。
  • 单独保存时,输出到用户指定目录:Results_EN.md(纯英文)、Results_ZH.md(纯中文)、Results_EN_ZH.md(逐段对照);命中触发项时另附 Results_核查说明.md。只在对话中交付时,给出逐段对照稿,核查说明放在独立说明块。
  • 交付时报告英文词数(口径见 journal-style 第 5 节),以及大纲标题被润色或改为美式拼写的位置。
  • 不在稿件目录留下处理脚本或缓存;不修改技能目录、全局配置、大纲、图例或数据。

交付前检查

  • 散文分号链 0 处(同句 ≥2 个散文分号为 ERROR,结构性分号豁免);目标平均 18–28 词/句,一般 ≤45 词、硬上限 60 词,>45 词占比 >10% 为 WARN;无连续 ≥3 个 <8 词短句的电报体连跑;WARN 已逐条说明。连接词按逻辑需要使用,不连续三句以上以同一个连接词或短语开头;按 journal-style 的「句长、分号与衔接」复核。
  • 大纲为每节列出的图表都已引用;图号格式为 (Fig. 2A)、(Supplementary Fig. S1)、(Table 2),中文为全角括号的“图 2A”“补充图 S1”“表 2”;编号和支持关系准确,首次引用顺序按证据逻辑安排,遵守明确的期刊要求。
  • 每个数字都能在表格、源数据或图注中找到出处,小数位统一;区间、n、P 值写法符合 journal-style 第 2 节。
  • 每个比例都写明了分母集合(真值类扫描、误分类子集、全部预测等),条件方向与源数据一致;行归一化的混淆矩阵比例没有被写成“某类预测的 X%”。
  • 分段服务于大纲的科学主线,必要的同节合并、去重或重排已留理由;段落为连贯散文。
  • 重点结果、关键对比、不确定性与重要例外充分呈现,没有逐项罗列表格;按作者/期刊要求报告词数,无为达到统一篇幅而扩写。
  • 没有绘图方法描述(颜色、线型、图形类型、带宽、轴)、方法复述和内部标识(字段名、文件名、规则代号)。
  • 没有 First、Then、Next、Finally 等机械路标;Moreover、Furthermore、In addition 等按逻辑需要使用,不为凑数堆砌,不连续三句以上以同一个连接词或短语开头;中文同步遵守。
  • 措辞边界逐条遵守:复述一遍大纲每节的“措辞边界”清单,逐条确认正文中有对应表述(含要求强调的限定,如两次分析不可互换),压缩时不得丢失;没有 superior、outperformed 等无检验支持的比较,没有因果化表述;部分类别队列、非独立队列、使用目标标签的参照已如实限定。
  • 关键结果的含义及跨图关联有明确证据且增加信息,句数服从证据需要;内容限于本研究问题,没有文献对照、临床推广、无据推断或复述。
  • 跨节回指用内容和图号指代,正文没有节号(Section 3.x、“3.4 节”“上一节”);没有预告后文或设问式衔接句;特别发现用结果句写出,没有 Notably、Interestingly、Importantly、“值得注意的是”等标签词。
  • 限定在相应论断处清楚表达;同一分析的重复限定可合并,不同分析所需限定分别保留,不按每节次数或 not 词频删减(规则第 5 节)。
  • 删除无信息增量的复述和机械综合尾句;尾句比例、therefore/thus/consequently 和 rather than 的次数仅提示复核,不设硬配额,不删去必要否定或对照;表格引用支持具体结果。
  • coexisted、accompanied、separating 等词准确表达实际关系,重复用法仅作诊断;表格已列的设备、厂商、来源清单未在正文无必要地逐项复述。
  • 单 seed、单次或子集分析的口径写在句内;少于 50 个事件支撑的指标已给出 n 或略去;同一舍入值的两个不同量已各自点明口径;跨队列极值已写全。
  • 大纲或图例把差距归因于某一步或某个组件时,已写出整条链上每一步的数值并核对占比;数据只部分支持的,结论和标题已收窄并上报。
  • 句长按 journal-style「句长、分号与衔接」执行;大纲写“见表”“一句带过”的内容没有逐项列数值;每个图号引用的 panel 确实显示该结果。
  • 中英信息覆盖一致,重构后已同步 ZH 和已有 EN_ZH;允许句子/段落拆合,中文按中文语序重组;双语标题含义一致,美式拼写、缩写首次定义。
  • 核查说明的六项触发已逐项判断,只含规则第 8 节规定的三部分,数字出处表只列需要说明的数字,总长一般不超过两页;未输出时已在交付时说明理由。

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.