名称: 医学手稿描述: 通过论证驱动的结构、分部分的最佳实践和句子层面的技巧来指导医学手稿写作。适用于撰写、修订或评审生物医学期刊的原创研究手稿，或当草稿读起来平淡或审稿人指出结构问题时使用。

医学手稿写作

将手稿从数据报告转化为有说服力的科学论证。

核心转变

停止报告。开始论证。

报告思维	论证思维
“我做了X，发现了Y，得出结论Z”	“存在一个问题，当前答案不足，这里有一个更好的答案”
段落呈现数据	每个段落推进论证
读者看到你的实验室笔记本	读者看到你的见解

在撰写任何段落之前，问：这个在我的论证中扮演什么角色？ 如果你无法回答，这个段落就不属于——或需要重新定位。

使用时机

撰写新的原创研究手稿
修订读起来“平淡”或“无聊”的草稿
评审同事手稿的结构问题
准备对审稿人评论的回应
从论文/报告风格过渡到期刊风格

主检查清单

复制并跟踪每个部分的进度：

写作前

[ ] 定义你的一句话论证（你填补了什么空白以及为什么重要）
[ ] 确定目标期刊及其惯例
[ ] 概述逻辑链：空白 → 方法 → 关键发现 → 含义

引言

[ ] 以具体的临床困境开头，而不是教科书句子
[ ] 文献构建逻辑链指向你的空白（不是引用堆叠）
[ ] 空白陈述清晰具体
[ ] 最后一段陈述确切的研究策略（数据、方法、结果）
[ ] 每个引用都有目的（重要性、先前限制或理论基础）

详细指导： references/introduction.md

方法

[ ] 按研究逻辑组织，而不是按工具类别
[ ] 关键方法论决策包括理由（“为什么用这个方法”）
[ ] 敏感性分析针对你最大的有效性威胁
[ ] 报告遵循指南（STROBE、CONSORT、PRISMA等）

详细指导： references/methods.md

结果

[ ] 以鸟瞰图开头，在任何细节之前
[ ] 文本中的基线特征限于临床相关差异
[ ] 呈现顺序遵循研究问题，而不是分析时间顺序
[ ] 无解释或推测（无“这表明…”或“这可能是因为…”）
[ ] 表格和图表按发现引用，而不是逐行叙述

详细指导： references/results.md

讨论

[ ] 第一段是概念电梯推销（发现 + 临床图景 + 意义）
[ ] 解释按层次组织（生物学 → 方法论 → 临床）
[ ] 不一致结果诚实处理，而不是忽略
[ ] 文献比较构建你的解释框架，而不是引用列表
[ ] 局限性平衡：承认 → 减轻 → 背景化
[ ] 结论陈述临床含义，而不仅仅是统计摘要

详细指导： references/discussion.md

句子层面润色

[ ] 主语是研究变量或动作，而不是被动结构
[ ] 每个段落的第一句和最后一句承载主要信息
[ ] 无堆叠修饰（“可能可能潜在地暗示…”）
[ ] 消除空形容词（“有趣的”、“重要的”、“值得注意的”）
[ ] 朗读——每个句子自然流畅

详细指导： references/sentence-craft.md

图表与表格

[ ] 每个图表有单一要点消息
[ ] 图例自包含（方法、样本、关键统计、缩写）
[ ] 表格仅显示研究相关变量（额外内容放入补充材料）
[ ] 大样本比较在适当情况下使用SMD而不是p值

详细指导： references/figures-tables.md

整体节奏

[ ] 信息密集的段落后接解释性呼吸空间
[ ] 无三个连续段落有相同的“发现A，p=B，与C一致”模式
[ ] 部分间过渡感觉引导的，而不是机械的
[ ] 朗读——如果听起来对你来说单调或生硬，对别人读起来更糟

部分快速参考

部分	目标	致命错误	修复
引言	构建你的研究的逻辑案例	以“X是主要死亡原因”开头	以具体临床困境开头
方法	赢得读者信任	列出工具而无理由	解释为什么关键决策
结果	呈现推进论证的事实	走私解释（“暗示…”）	仅事实；解释在讨论中
讨论	提供概念意义	用p值重述结果	以意义开头，而不是数字
图表	每个图表传递一个消息	杂乱图表无清晰要点	围绕要点消息设计

常见反模式

反模式	示例	更好方法
教科书开头	“癌症是全球主要死亡原因”	你研究解决的具体临床困境
引用堆叠	“Smith (2020) 发现 X。Jones (2021) 发现 Y。”	合成到逻辑链并内联引用
模糊研究目标	“我们旨在探索X和Y之间的关系”	“我们用[数据库]和[方法]测试[具体假设]”
实验室笔记本结果	叙述表1的每一行	仅突出临床有意义差异
统计讨论	“HR为2.4 (95% CI 1.8–3.2, p<0.001)”作为讨论开头	以概念意义开头，而不是数字
自我毁灭的局限性	列出每个弱点直到研究听起来无价值	承认 → 减轻 → 背景化
修饰堆叠	“这可能潜在地暗示…”	每个声明一个修饰：“这暗示…”
空形容词	“有趣的是，我们发现…”	直接显示对比或惊喜

快速扫描

运行内置扫描器捕获机械反模式（31个检查，部分感知）：

# 完整扫描
python3 ~/.claude/skills/manuscript/scan-manuscript.py manuscript.md

# 仅错误（高置信度）
python3 ~/.claude/skills/manuscript/scan-manuscript.py --severity error manuscript.md

# 从stdin检查单个部分
cat results.md | python3 ~/.claude/skills/manuscript/scan-manuscript.py --section Results

# JSON输出 / 标记检查清单
python3 ~/.claude/skills/manuscript/scan-manuscript.py --json manuscript.md
python3 ~/.claude/skills/manuscript/scan-manuscript.py --checklist manuscript.md

# 列出所有检查
python3 ~/.claude/skills/manuscript/scan-manuscript.py --list-checks

它能捕获什么（约57%的可脚本化指导）：修饰堆叠、空形容词、结果中的解释、教科书开头、模糊目标、无置信区间的p值、引用堆叠（引言+讨论）、缩写、重复词、冗余首字母缩写（如HIV病毒）、被动语态比例、句子单调、表格/图表叙述、统计讨论开头、统计结论、机械过渡、过度声称、拟人化、非正式语言、英式/美式拼写混合、名词化、冗长短语、冗余修饰语、自我引用填充、句子冗长、双重否定、缺失报告指南、p值排序、单调结果模式。

它不能捕获什么（约43%）：论证质量、逻辑链、空白特异性、解释框架深度、局限性平衡。这些需要人工判断或AI辅助评审。

医学手稿写作Skill manuscript

名称: 医学手稿描述: 通过论证驱动的结构、分部分的最佳实践和句子层面的技巧来指导医学手稿写作。适用于撰写、修订或评审生物医学期刊的原创研究手稿，或当草稿读起来平淡或审稿人指出结构问题时使用。

医学手稿写作

核心转变

使用时机

主检查清单

写作前

引言

方法

结果

讨论

句子层面润色

图表与表格

整体节奏

部分快速参考

常见反模式

快速扫描

相关技能

名称: 医学手稿 描述: 通过论证驱动的结构、分部分的最佳实践和句子层面的技巧来指导医学手稿写作。适用于撰写、修订或评审生物医学期刊的原创研究手稿，或当草稿读起来平淡或审稿人指出结构问题时使用。

医学手稿写作

核心转变

使用时机

主检查清单

写作前

引言

方法

结果

讨论

句子层面润色

图表与表格

整体节奏

部分快速参考

常见反模式

快速扫描

相关技能

名称: 医学手稿描述: 通过论证驱动的结构、分部分的最佳实践和句子层面的技巧来指导医学手稿写作。适用于撰写、修订或评审生物医学期刊的原创研究手稿，或当草稿读起来平淡或审稿人指出结构问题时使用。