geointelmining848/科学写作精通

科学写作精通 是做什么的？

本技能浓缩了四本写作经典：Strunk的《文体要素》（1918/1920）；Zinsser的《写作法宝》（2001年版）；Alley的《科学写作技巧》（第4版，2018）；以及Heard的《科学家写作指南》（2016）。参考文件中的每条规则都来自其中一本，并指明了作者，以便你权衡其适用性，读者也可以核查。这些书在目标上达成共识：清晰到让读者从未察觉其存在。Heard称之为心灵感应。Alley的法则就是爱因斯坦的名言：尽可能简单，但不能更简单。Zinsser的方法是做减法。Strunk的则是“省去不必要的词语”。

所有规则服务的四条原则

1. 读者的努力是唯一的衡量标准。 如果读者感到困惑，那是作者不够用心（Zinsser）。在解决任何写作技巧问题时，问问自己哪种选择能让读者更容易理解故事（Heard）。在选择措辞前，先分析谁在读、为什么读、他们已经知道什么（Alley）。
2. 说出你的本意，且不要言过其实。 精确性和清晰度往往相互冲突；不必要的复杂性是科学写作中最常见的失败（Alley）。措辞的限定程度要精确匹配证据，不要夸大任何内容（Heard， Alley）。
3. 每个词都有其存在的价值。 一个句子不应包含不必要的词语，一个段落不应包含不必要的句子（Strunk）。大多数初稿可以砍掉一半词语而不丢失信息（Zinsser）。迫使每个字符都证明自己存在的理由（Heard）。
4. 事实与推论，一线之隔。 科学写作是一个接一个的句子，而“接”这个顺序正是困难所在（Zinsser）。一个句子一个观点，动作发出者紧邻动作，新信息放在句末（Alley, Heard, Strunk）。

规则背后的理由比规则本身更重要。当规则与读者的利益发生冲突时，读者优先，参考文件会说明每条规则为何存在，以便你判断例外情况。

每次开始前：

1. 指明模式。 Draft（起草）：生成新文本；Revise（修订）：重写提供的文本；Diagnose（诊断）：列出问题优先级，不重写；或Plan（规划）：在起草前设计文档结构。根据请求暗示选择；只有当模式不明确时才说明你的选择。
2. 明确读者、目的、场合（Alley）。谁在读、为什么读、他们知道什么、以及出版平台允许的长度和形式。期刊页数限制只能给一个主张一句论证；报告或章节可以给一段。
3. 只加载需要的内容。 每次都先加载 references/house-style.md（它很短）：它保存了作者的固定偏好，并附带一个作者可以编辑的起始模板。然后根据下面参考图谱的阅读列表，加载模式所需的文件。这些文件带有目录；只阅读任务涉及的部分，不要从头到尾读完每个文件。
4. 最多运行两次信号脚本：一次用于检查提供的任何长度超过一个段落的文本（在仔细阅读之前），一次用于检查最终交付的文本：python3 scripts/prose_signals.py <file> (或 --json)。它会报告句子长度、被动语态候选词、赘词开头、名词化、冗余短语、限定词、强调词、句首裸“this”、名词串、破折号、以及一次性使用的缩写词。页眉会说明其性质：是信号，不是判决。用它来决定从何处着手检查，然后进行阅读。
5. 确定哪些不可更改。 数字、结论、引用、已定义的术语，并且，当文本是作者自己写的时候，还包括论点转折和house-style文件中保护的语风。绝不要编造源文件中没有的数字、引用、结果或主张。将缺失之处标记为 ??? 并列出来。

模式：起草 (Draft)

根据笔记、大纲或结果进行起草。

1. 先找到故事核心。 写两句话的迷你摘要：核心问题及其答案（Heard）。这能确定内容归属：包含这个内容是有助于讲述故事还是会分散注意力？对于书籍章节，陈述该章节要回答的、且上一章节尚未回答的读者问题（遵循 house style）。如果笔记中没有答案，故事就是问题加上设计，并说明这一点。
2. 从 references/structure.md 获取骨架。 引言应从大的领域过渡到研究空白，再到本文的工作，并以问题、方法和主要结果结尾（Heard）；开篇的广度由出版平台决定。摘要应是一个提供信息的总结，并明确给出结果（Alley, Heard）。讨论部分应在第一段回答问题，并以最重要发现及其意义结尾（Heard）。章节应以引导句开头，并勾勒其各部分内容（Alley, house style）。
3. 写作前确定统一性（Zinsser）：人称代词、时态、语气。坚持到底。
4. 快速起草，然后按顺序修订。 先完成一个完整的草稿，任何缺失的内容用占位符代替（Heard）。然后在交付前，对草稿执行下面“修订”模式中的步骤。读者只会看到修订后的草稿。
5. 只写来源支持的内容，并将缺失之处排除在可直接粘贴的文本之外。 不要添加笔记中没有的主张、机制或结果，即使是为了衔接论证也不行（“种植植被可以降低社区温度，但不能提高其收入”是一个主张，不是过渡）。使用笔记中已有的事实进行衔接，或者保留缝隙并在笔记中标记；披露添加的主张并不使其变得可接受。当笔记中没有主要结果时，引言应以问题和研究方法结尾（Heard列出的替代顺序），而不是以占位符结尾；笔记会说明添加一个结果句会带来什么影响。优先性声明（“首次测试”）必须保留其限定词（“据我们所知”），因为分析无法判定文献检索的彻底性（house style：对真正悬而未决的内容使用限定措辞）。
6. 交付：以请求的格式交付文本（可直接粘贴的手稿散文；参见输出格式），并附带一个简短的说明，列出缺失之处、假设，以及作者可能希望推翻的一两个选择（例如：“草稿以设计结尾；如果你希望以主要结果结尾，请添加一句：……”）。

模式：修订 (Revise)

收紧或澄清用户提供的文本。当共同作者说“读起来很糟糕”时，就应该使用此模式。

1. 先通读整个段落，理解其故事和作者的意图，然后再动一个字。记下“开始前”中的“不可更改项”。
2. 根据请求选择编辑的尺度，并说明你的选择。 三种情况：
   • 要求修改一个短语，或者一个作者已经完成的章节：只修改确切的短语或句子，并仅报告其他地方的事实或科学错误（house style）。
   • 要求加强、改进或让一段文字读起来更好（包括作者自己的文本）：执行以下所有三项，并分别报告。第一，价值测试：指出任何不承载主张的句子（如“本章旨在阐述……”这样的自我宣告、复述、不改变主张的限定说明、摘要内的章节路线图），并作为可逆项目提议删除，引用该句子并说明理由；如果你保留了这样的句子，请说明原因。第二，结构上的改进：提出最有帮助的结构性改动（将句子移动到其结论紧随其后的地方、将深埋的发现提前、将四个并列句合并为一个），同样作为可逆项目提出。第三，短语修复：有歧义的连接词（用“since”代替“because”）、指代不清的代词或“those”、比喻性动词、相邻句子中的重复短语。“精确保留每个主张和术语”禁止添加新主张和重命名术语；但它不禁止这些不改变主张的修复。永远不要仅仅为了风格而重写整个段落，并保留作者的语风、术语和主张。
   • 要求收紧草稿：允许重写，但每个事实、数字、术语和引用必须原样保留。 对这个技能的一次真实评审明确指出了中间情况：当被要求提供一个“有力”的摘要时，作者更倾向于那个移动了句子的修改稿，而不是那个只改了三个短语而保持结构不变的稿子。
3. 按单次目的轮次进行修订，顺序如下（Heard, Alley），因为你绝不应该去润色那些你正要删除的内容：
   • 内容：删除那些无助于段落目标的内容；检查主张是否与证据匹配；只保留证据所需的限定词。
   • 结构与段落：每段一个观点，尽早点明；每个句子的开头方式应与前句建立联系；新的、重要的信息放在句子和段落的末尾（references/paragraphs.md）。
   • 句子：动作发出者紧邻动作，动词尽早出现，一个句子一个观点，使用主动语态（除非被动语态执行其三个特定功能之一），没有裸“this”，没有悬垂修饰语，没有歧义代词（references/sentences.md）。
   • 词语：冗余短语、名词化、强调词、堆砌的限定词、读者不掌握的术语、不必要精确的数字（references/words.md）。在段落中只使用一次的缩写应在正文中拼写出来，而不是保留原样并加注释；如果该缩写稍后在文档中再次出现，则在注释中说明并保留其定义。
   • 技术细节：介绍性短语后的逗号、序列逗号、不使用破折号、章节内时态一致、缩写首次出现时定义。
4. 模拟读者（Heard）。像一个只有文本的陌生人那样阅读修改稿。在脑海中大声朗读，感受句子之间的联系（Zinsser）。
5. 验证没有内容偏差。 每个数字、单位、区间、引用和已定义的术语都与来源完全一致。除非用户要求，否则主张既不比来源更强，也不比来源更弱。
6. 交付：可直接粘贴的文本、改动清单，以及（当你删除了句子时）删除清单（参见输出格式）。

模式：诊断 (Diagnose)

提供按优先级排列的发现，不进行重写。也适用于“为什么这不对？”和“这里该用被动语态吗？”这类问题：说出规则、作者、理由，并从参考文件中提供一个修改前后的例子。

1. 运行脚本；像目标读者一样阅读；始终着眼于整个文档的故事。
2. 按读者阅读成本排序发现，实质内容优先于技术细节：故事和主张（夸大主张、缺失边界、证据不支持结论、深埋主要发现）排第一；结构（顺序、关键位置、缺失衔接、本应是结尾的地方却是总结）排第二；段落排第三；句子排第四；词语排第五；技术细节排最后。
3. 每个发现按统一格式书写： 引用有问题的词语（五到十二个），说明读者会遇到什么问题，指出违反的原则和该原则的作者，并说明修正会带来什么效果。重复出现的相同技术问题合并为一个发现，并附上计数。
4. 整个诊断对于一篇文章的某个部分大约控制在800到1200词，最多十二个发现。前三到五个实质性发现各写一段；其余的每个发现写一行，附上计数和一个引用实例。如果一个读者需要阅读两千字的诊断结果，他很可能不会采取任何行动。从技术性发现上削减长度，绝不要削减重要的发现：一个在本意和声称之间摇摆不定的术语（测量的是“邻近性”，却声称是“空气污染”）、以不同强度出现的主张、深埋的发现。一个从未在章节中定义的缩写总是只需一行即可描述的发现。
5. 除非被要求，否则不要重写。如果某个原则不举例说明就不清楚，则展示一个修改后的句子，并标明是示例。
6. 最后，按顺序列出最重要的两到三个改进点。

模式：规划 (Plan)

在起草前设计论文、项目申请书、章节或小节。

1. 读者、目的、场合、出版平台和长度预算（Alley）。
2. 两句话的迷你摘要，然后是卖点：为什么这个问题对这个读者（而不是作者）很重要（Heard）。拒绝胆怯的表述（“尚未有研究报告”）。
3. 先安排好图表；让问题隐含在图表的答案中（Heard）。对于一篇论文，图表数量最好不超过约五张图和四张表。
4. 从 references/structure.md 获取文档类型的骨架，然后撰写主题句大纲：按顺序，每个段落一行话说明其要点，并标明每个部分的任务。
5. 标记关键位置：每个部分的第一段和最后一段，每个段落的第一句和最后一句，标题，小标题（Alley, Heard）。将最主要的结果放在文字靠近空白区域的地方。
6. 列出需要排除的内容（Heard的三重测试：正文、补充材料或不予发表）以及仍需填充的占位符。

输出格式

• 手稿散文是可直接粘贴的： 纯文本，每个段落一个物理行，没有Markdown标记，没有项目符号，没有编号，没有代码块，没有硬换行符，也没有破折号。作者可以将其直接粘贴到Word中。当新文本替换现有文字时，请指明替换位置：引用要删除的首尾词语，并说明替换的是一个句子、一个段落还是一个子节（house style）。
• 改动清单简短且分组列出：改了什么、依据的规则及作者、对读者有何帮助。琐碎的改动（逗号、错别字）作为一行，附上计数。
• 删除清单指出每个被删除的句子及其删除原因（重复、元话语、不改变主张的限定说明、不会改变读者理解的细节）。
• 发现列表（诊断模式）使用普通的聊天格式，按优先级排列。
• .docx 输入：提取文本，进行处理，交付可直接粘贴的散文。如果需要保留文件本身的修订标记，则需依赖能处理docx的编辑器。