Skip to content
Back to search

nature-writing-skill

Claude Code / Codex skill — Nature-family paper writing (NMI / NC / NCS / Nature) for Chinese AI/ML researchers, distilled from 44 OA papers

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/syntaxsmith--nature-writing-skill/badge.svg)](/listings/syntaxsmith--nature-writing-skill)

HTML

<a href="/listings/syntaxsmith--nature-writing-skill"><img src="/api/listings/syntaxsmith--nature-writing-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

# 用户级(所有项目都能用)
git clone https://github.com/SyntaxSmith/nature-writing-skill.git ~/.claude/skills/nature-writing

# 或项目级(仅当前项目)
git clone https://github.com/SyntaxSmith/nature-writing-skill.git .claude/skills/nature-writing

Claude Code 启动后会自动读取 `SKILL.md` 的 frontmatter。在对话里输入 `/nature-writing` 触发,或直接自然语言:"用 nature-writing skill 帮我打磨这段 abstract"。

Codex CLI

Codex 没有 skill 概念,把仓库 clone 到任意位置,然后在项目 `AGENTS.md` 里加指针:

git clone https://github.com/SyntaxSmith/nature-writing-skill.git ~/skills/nature-writing
<!-- AGENTS.md -->
## Writing for Nature-family journals
When drafting or revising papers for NMI / NC / NCS / Nature, first read
`~/skills/nature-writing/SKILL.md`, then load only the relevant
`references/*.md` per the routing table in §1.1.

或临时把对应章节作为附件丢给 Codex:

codex "@~/skills/nature-writing/references/03-abstract.md 用这一节检查我的 abstract"

其他 agent / chatbot

`SKILL.md` 是纯 Markdown,没有专属语法。任何能读文件的 LLM 工具(Cursor、Continue、Aider、ChatGPT custom GPT、Gemini Code Assist……)都可以把它当 system prompt 或附件用。

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 451 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: nature-writing
  3. description: 面向中国 AI / ML 研究者,主投 Nature Machine Intelligence、次投 Nature Communications / Nature Computational Science、必要时冲刺 Nature 的论文写作技能(craft + taste + story-craft)。v5 在 v4 拆分版上吸收了 8 篇 2024–2026 NMI/NC/Nature 纯 AI 方法论文(DeepSeek-R1、Densing law、AligNet、ADeLe、Webb-MAP、DiscoRL、Farquhar semantic-entropy、Whitelam Simmering),新增 measurement / new-ruler hook、correctness-gap limitation、pure-AI 数字密度 carve-out、SI black hole 反模式、AI evaluation/measurement 子门类剧本等。本 SKILL.md 为瘦索引:骨架公式、写作顺序、按任务加载的 routing table、提交前 checklist、屏幕边 quick card、附录。详细章节按需 Read `references/01-story.md` … `references/15-taste-development.md`。视觉/figure 设计见姊妹 skill `FIGURE-SKILL.md`。所有 verbatim 引文可回查 `extracts/01-singlecell.md` … `extracts/07-ai-methods.md` 7 个文件 / 共 44 篇论文。
  4. ---
  5. # Nature 系 AI / ML 论文写作技巧 v4(拆分版)
  6. ## Craft, Taste, and Story-Craft for NMI / NC / NCS / Nature
  7. > **资料来源**:7 类领域共 44 篇开放获取论文的逐句抽取在 `extracts/01-singlecell.md` … `07-ai-methods.md`;抽取框架见 `_framework.md`(v5:补 8 篇 2024–2026 NMI/NC/Nature 纯 AI 方法论文)。
  8. > **读者**:中文母语或中文工作语境中的 AI / ML 研究者。主投 **Nature Machine Intelligence**;次投 **Nature Communications** 与 **Nature Computational Science**;少数旗舰工作冲 **Nature**。
  9. > **目标**:不只是“能过审”,而是让审稿人读完后说:*well-written, clearly motivated, compelling, careful, and hard to put down.*
  10. > **约定**:
  11. > - 英文引号里的句子是 corpus verbatim,除非标注为“模板 / 构造 / 改写”。
  12. > - `<X>` 是占位符。
  13. > - `[…]` 是删节;`…` 是原文或节选中的省略。
  14. > - 本文档把规律分为三档:
  15. > - **常见模式**:44 篇里多数遵循,可作为默认。
  16. > - **子门类倾向**:只在 foundation model / benchmark / AI-for-X / clinical AI 等特定类型里成立。
  17. > - **强约定**:罕有例外,违反通常会显得生硬或不可信。
  18. > - 不使用“铁律 / 必须 / 绝不”。好论文知道规矩,也知道何时破规矩。
  19. > **本文档为瘦索引**:保留全篇都需要看到的部分(骨架公式、写作顺序、提交前 checklist、Quick card、附录),其余按主题拆到 `references/01-story.md` … `references/15-taste-development.md`。详细加载规则见 §1。
  20. ---
  21. ## 0. 先记住这句话:论文不是实验清单,是阅读体验
  22. **Patron sentence** — FunSearch:
  23. > "Many problems in mathematical sciences are 'easy to evaluate,' despite being typically 'hard to solve.'"
  24. 这句话好,因为它不是“我们提出一个方法”。它把整篇论文的戏剧张力先说出来:有一类问题,答案很难找,但好坏很容易判。于是 FunSearch 的 LLM + evaluator 设计变成必然,而不是作者硬塞给读者的系统图。
  25. v3 教你 craft:title 怎么写,abstract 怎么排,Results 怎么开句,Methods 报什么。
  26. v4 还要教 taste:**哪个结果该当 Fig. 1,哪个该进 Supplementary,哪句话该收住,哪句话该响一点,哪种故事配得上 “paves the way”。**
  27. ### 0.1 一篇 Nature 系 AI 论文的默认骨架
  28. 多数论文仍遵循这一条骨架:
  29. ```text
  30. TITLE
  31. ← 4–6 种定式之一:工具名 / 工具名+冒号 / X enables Y / Towards a… / Discovery of…
  32. ABSTRACT
  33. s1 BIG-PICTURE / 重要性
  34. s2 GAP
  35. [s3 GAP-2 / contrast / opportunity]
  36. s4 HERE-WE pivot:Here we / We introduce / We propose / We report / This paper introduces
  37. s5 METHOD-SPEC:数字最密的一句(默认;纯 AI 方法 / safety / evaluation 论文可把数字峰值后移到 KEY-RESULT 或 VALIDATION——见 `references/03-abstract.md` §3.2.2 carve-out)
  38. s6 KEY-RESULT:一个强数字 + 命名 baseline / benchmark / human anchor
  39. [s7 VALIDATION / GENERALIZATION / 第二轴结果]
  40. s8 IMPLICATION:paves the way / opens the door / democratizes / represents a step
  41. INTRODUCTION
  42. 宽 hook → recent advances → gap → pivot → results preview
  43. RESULTS
  44. 4–10 个子节:每节一个 claim / task / capability;Fig. 1 建立阅读地图
  45. METHODS
  46. 复现细节、数据切分、baseline、公平性、compute、statistics、code/model/data availability
  47. DISCUSSION
  48. 重述贡献 → 与 prior work 比较 → limitation → outlook / community / deployment
  49. ```
  50. ### 0.2 v4 的核心判断
  51. Craft 问:
  52. > “Nature 系论文通常怎么写?”
  53. Taste 问:
  54. > “这篇论文的最强阅读路线是什么?”
  55. Craft 给你模板。Taste 决定你何时不用模板。
  56. AlphaGeometry 的标题 **"Solving olympiad geometry without human demonstrations"** 没有工具名、没有冒号、没有 `X enables Y`,但它把贡献的张力放在标题里:不是“solving geometry”,而是 **without human demonstrations**。
  57. FunSearch 的 abstract 有 10 句,明显超过 5–8 句默认骨架,但每一句都推进:capability → hallucination flaw → here-we → result 1 → result 2 → mechanism contrast → interpretability value。
  58. SemanticLens 用 aeroplane analogy 开篇:
  59. > "Unlike human-engineered systems such as aeroplanes, where each component's role and dependencies are well understood, the inner workings of AI models remain largely opaque…"
  60. 这些都不是破坏规矩。它们是在更高层面服从故事。
  61. ### 0.3 写作顺序不要反过来
  62. 不要先把所有实验按时间顺序贴进 Results,再想标题。正确顺序是:
  63. ```text
  64. 1. 选 story shape:这篇论文到底是什么故事?
  65. 2. 选 climax:哪个结果是读者必须记住的?
  66. 3. 选 Fig. 1:读者第一眼看到的是 bottleneck、machine、funnel、scaling law,还是 human benchmark?
  67. 4. 删弱枝:不能服务主故事的实验,进 Supplementary 或删掉。
  68. 5. 再写 abstract / intro / results。
  69. 6. 最后逐句打磨 rhythm、verb、restraint、overclaim boundary。
  70. ```
  71. ---
  72. ## 1. Routing — 按任务加载
  73. 写作不是线性的;读 SKILL 也不该线性。每个写作阶段或具体困境,按下面表格只 Read 1–2 个 reference 文件。
  74. ### 1.1 按写作阶段加载
  75. | 阶段 / 困境 | 主 load | 辅 load |
  76. |---|---|---|
  77. | 构思 / 还在选 story shape,未决定 climax | `references/01-story.md` | `references/12-subgenres.md`, `references/14-journals.md` |
  78. | 选 venue / 不知道投哪个刊 | `references/14-journals.md` | `references/12-subgenres.md` |
  79. | 写标题 | `references/02-title.md` | — |
  80. | 写 abstract | `references/03-abstract.md` | `references/11-language-bank.md` |
  81. | 写 introduction | `references/04-intro.md` | `references/11-language-bank.md` |
  82. | 写 Results 子节 / figure call-out / 数字+统计 | `references/05-results.md` | `FIGURE-SKILL.md`(视觉端) |
  83. | 写 Methods / 复现性 / LLM-agent prompt 报告 | `references/06-methods.md` | — |
  84. | 写 Discussion / limitation / outlook | `references/07-discussion.md` | `references/08-sentence-taste.md`(outlook 动词等级) |
  85. | 一句话卡了:节奏 / 经济 / restraint / overclaim 边界 | `references/08-sentence-taste.md` | `references/11-language-bank.md` |
  86. | 自审稿 / 模拟 reviewer | `references/09-reviewer-protocol.md` | `references/13-antipatterns.md` |
  87. | 文风像 arXiv 不像 Nature / 不知子刊 voice 差异 | `references/10-voice.md` | `references/14-journals.md` |
  88. | 词不准 / 强动词 / hedge / 段间连接 | `references/11-language-bank.md` | — |
  89. | 写 ML 方法 / Foundation / LLM-agent / Interpretability / Benchmark / AI-for-X 任一具体子门类 | `references/12-subgenres.md` | `references/01-story.md` |
  90. | 自查反模式 | `references/13-antipatterns.md` | — |
  91. | 长期 taste 培养 / 读法 / 临摹 | `references/15-taste-development.md` | — |
  92. | 提交前总扫 | 本文 §2 checklist + `references/13-antipatterns.md` | `references/09-reviewer-protocol.md` |
  93. ### 1.2 References 目录(主题索引)
  94. | 文件 | 主题 | 大致行数 |
  95. |---|---|---|
  96. | `references/01-story.md` | Story Architecture:7 种 canonical shapes、Fig. 1 四种功能、climax 选择、降级与删枝 | 130 |
  97. | `references/02-title.md` | Title 6 种定式、关于 "novel" 的真相、Title before/after | 90 |
  98. | `references/03-abstract.md` | 5–8 句句式图、三条强约定、Two-gap、何时打破默认、Abstract before/after | 195 |
  99. | `references/04-intro.md` | 漏斗 4–6 段、6 种 hook、GAP 词库、pivot 模板、末段 taste、Intro before/after | 200 |
  100. | `references/05-results.md` | 标题三风格、开句三模板、figure call-out、caption、统计写法、baseline、ablation、discovery funnel、综合句、Results before/after | 340 |
  101. | `references/06-methods.md` | Methods 子目、LLM-agent 专用清单、复现三处呼应、常漏报项、Methods 也要有 taste | 140 |
  102. | `references/07-discussion.md` | Discussion 开句两条路径、Limitation、Outlook 动词等级表、Overclaim 边界、Closing、Discussion before/after | 185 |
  103. | `references/08-sentence-taste.md` | 10 句 memorable sentences 解剖、rhythm、经济、name-your-noun、negative space | 370 |
  104. | `references/09-reviewer-protocol.md` | 5-pass harsh referee protocol、SNEER/NOD/ASK/CUT、每段末尾 invisible answer | 150 |
  105. | `references/10-voice.md` | DeepMind / NMI / NC / NCS / 临床 5 种 voice、confident vs arrogant、modest vs timid | 160 |
  106. | `references/11-language-bank.md` | 强动词 / hedge / 6 类段间连接词 / 高复用句型 | 75 |
  107. | `references/12-subgenres.md` | 7 个子门类剧本:ML 方法 / Foundation / LLM-agent / Interpretability / Benchmark / AI-for-X / 临床 | 335 |
  108. | `references/13-antipatterns.md` | craft + AI-specific + taste 三类反模式 | 90 |
  109. | `references/14-journals.md` | Nature / NMI / NC / NCS / NM / Nat Med 各自 voice 与策略 | 160 |
  110. | `references/15-taste-development.md` | 读法 / rewrite-by-hand / taste notebook / mentor / OpenReview review / 返回旧草稿 | 80 |
  111. ### 1.3 与 FIGURE-SKILL.md 的衔接
  112. 视觉设计是另一回事,由独立的 `FIGURE-SKILL.md`(v0.2)覆盖:Fig. 1 schematic 6 种构图、配色(Wong/Okabe-Ito 8 色板)、字体字号(**panel letter 8pt bold lowercase + 其他 5–7pt**,已按 Nature Research Figure Guide 核实)、panel 布局、数据图选型、统计在图内的呈现、matplotlib/ggplot template、Illustrator 拼版流程、arXiv→Nature 反模式 19 条、文件格式与大小(≤50MB / RGB / Type 42 / lowercase a/b/c)。写 Results 与做图常需同时打开两本 skill。
  113. ### 1.4 与 extracts/ 的关系
  114. 所有 verbatim 引文(如 AlphaFold "Here we provide the first computational method…",FunSearch "easy to evaluate, hard to solve")都可在 `extracts/01-singlecell.md` … `extracts/07-ai-methods.md` 7 个文件 / 共 44 篇里通过 grep 查到上下文。当 SKILL 或某 reference 引用一句话且你想看出处全文时,到对应 extract 文件搜即可。
  115. ---
  116. ## 2. 提交前 checklist
  117. 提交前一次性扫一遍。条目按章节分组——任何一项落空,先回到对应 reference 修。
  118. ### 2.1 Story
  119. ```text
  120. [ ] 我能用一句话说出 story shape。
  121. [ ] antagonist 明确:bottleneck / data scarcity / black box / scale / compute / human bottleneck / synthetic constraint。
  122. [ ] Fig. 1 服务主 story,而不是零件堆。
  123. [ ] 每个主文实验支撑 abstract claim、处理强质疑、或推进 climax。
  124. [ ] 至少有一个实验被降到 Supplementary 或删掉。
  125. [ ] Results 顺序不是实验时间顺序,而是阅读顺序。
  126. ```
  127. ### 2.2 Title
  128. ```text
  129. [ ] 标题属于 A–F 定式之一。
  130. [ ] 没有空心化 "A novel method for…"。
  131. [ ] 如果用 "foundation model",下游任务 / transfer / scale 足够支撑。
  132. [ ] 如果用 "without / first / universal / clinical-grade",证据足够支撑。
  133. [ ] 标题能让 editor 在 5 秒内知道冲突和贡献。
  134. ```
  135. ### 2.3 Abstract
  136. ```text
  137. [ ] 5–8 句为默认;若更长,每句有独立功能。
  138. [ ] 有一个明确 pivot。
  139. [ ] METHOD-SPEC 句数字密度最高(默认);或已有意采用 pure-AI-methodology carve-out(数字在 KEY-RESULT / VALIDATION)。
  140. [ ] KEY-RESULT 有 named baseline / benchmark / human anchor。
  141. [ ] Outlook 动词与证据强度匹配。
  142. [ ] 中段用强动词;末段适度 hedge。
  143. [ ] 没有把 architecture details 写成 mini Methods。
  144. ```
  145. ### 2.4 Introduction
  146. ```text
  147. [ ] Hook 不是 "Recently, deep learning…"。
  148. [ ] 第一段有 stakes / old problem / analogy / paradox。
  149. [ ] GAP 说明 limited by what。
  150. [ ] Pivot 段落明显。
  151. [ ] Intro 末段给 roadmap 或 tight pivot。
  152. [ ] 每个 major claim 有适量 citation,不是 citation pile。
  153. ```
  154. ### 2.5 Results and figures
  155. ```text
  156. [ ] Results header 风格统一。
  157. [ ] 每个子节开句让读者知道:为什么做 / 做了什么 / 得到什么。
  158. [ ] Fig. call-out 把发现放主语位置。
  159. [ ] Main benchmark 有 named baseline。
  160. [ ] 主要比较有 uncertainty:CI / IQR / std / P / bootstrap / repeated splits。
  161. [ ] 至少有 robustness / ablation / control 处理 alternative explanation。
  162. [ ] Discovery paper 有 funnel。
  163. [ ] Foundation model paper 有 scaling / data-size / transfer 证据。
  164. [ ] Clinical paper 有 external validation 或明确说明没有。
  165. [ ] Caption 可独立复述 figure。
  166. ```
  167. ### 2.6 Methods and reproducibility
  168. ```text
  169. [ ] 数据来源、版本、split 原则清楚。
  170. [ ] leakage 检查说明。
  171. [ ] training compute 报告。
  172. [ ] random seeds 或替代 uncertainty 报告。
  173. [ ] baseline 训练公平性说明。
  174. [ ] hyperparameter search budget 说明。
  175. [ ] LLM/API 论文:prompt、version、date、decoding、tool schema 完整放在 SI;主文显式指向 SI("详见 SI")。
  176. [ ] Code / data / model availability 独立段。
  177. [ ] License / DOI / access restriction 说明。
  178. ```
  179. ### 2.7 Discussion
  180. ```text
  181. [ ] 开句不是 limitation-first,除非有意采用 frank concession。
  182. [ ] 第一段重新框定贡献。
  183. [ ] 与 prior work 比较具体,不泛泛。
  184. [ ] Limitation 具体命名。
  185. [ ] Limitation 后有 boundary / remedy / future direction。
  186. [ ] Outlook phrase 与证据强度匹配。
  187. [ ] Closing 不喊口号。
  188. ```
  189. ### 2.8 Sentence-level taste
  190. ```text
  191. [ ] 每段 read aloud 不拗口。
  192. [ ] 没有 noun phrase 过长。
  193. [ ] 删除多余 adjective。
  194. [ ] 强 verb 替换 nominalization。
  195. [ ] 数字顺序符合读者理解。
  196. [ ] 最强结果没有被 "remarkably/dramatically" 淹没。
  197. [ ] 每段有一个落点。
  198. ```
  199. ### 2.9 Reviewer modeling
  200. ```text
  201. [ ] 写了 top 5 reviewer objections。
  202. [ ] 每个 objection 已在 Results / Methods / Discussion 某处处理。
  203. [ ] 没有 reviewer 会认为 baseline unfair。
  204. [ ] 没有 reviewer 会认为 claim overreaches evidence。
  205. [ ] 没有 reviewer 需要猜测 key implementation detail。
  206. [ ] 如果你的方法依赖 evaluator / 监督目标 / human label / benchmark:评估这把 ruler 本身是否可信。reviewer 可能问 "Is the evaluator / supervision target itself valid?"
  207. ```
  208. ---
  209. ---
  210. ## 3. Quick field manual(屏幕边贴条)
  211. ### 3.1 Story
  212. ```text
  213. This paper is a <story shape> story:
  214. bottleneck-broken / two-gap synthesis / scale-emergent / discovery funnel /
  215. human-anchored benchmark / trust bridge / limit-redrawn.
  216. The antagonist is <X>.
  217. The climax is Fig. <Y>.
  218. The sentence readers must remember is:
  219. "<one sentence>"
  220. ```
  221. ### 3.2 Abstract
  222. ```text
  223. <Topic> is <critical> for <field>.
  224. However, <existing methods> are <limited by X>.
  225. [Yet, <second paradigm> <fails by Y>.]
  226. Here we <introduce/present/propose> <NAME>, a <category> that <mechanism>.
  227. <NAME> <does numerically dense thing>.
  228. We show that <NAME> <outperforms/solves/discovers> <baseline> on <benchmark>.
  229. [Furthermore, <generalization/validation>.]
  230. <NAME> <bounded outlook phrase> <broader vision>.
  231. ```
  232. ### 3.3 Intro
  233. ```text
  234. ¶1 Hook: concrete stakes / old problem / analogy / paradox.
  235. ¶2 Recent advances: grouped, not piled.
  236. ¶3 Gap: limited by what?
  237. ¶4 Pivot: Here we <verb> <NAME>.
  238. ¶5 Roadmap: Specifically, we show that …
  239. ```
  240. ### 3.4 Results
  241. ```text
  242. §1 Reader map: architecture / pipeline / benchmark design.
  243. §2 Main result with named baseline.
  244. §3 Mechanism / ablation.
  245. §4 Robustness / external validation.
  246. §5 Hard case / discovery / human anchor.
  247. §6 Boundary / failure / generalization.
  248. ```
  249. ### 3.5 Methods
  250. ```text
  251. data + split + leakage
  252. architecture + training + compute
  253. baselines + fairness
  254. statistics + seeds
  255. LLM prompts/API/tool schema if relevant
  256. code/data/model availability
  257. ```
  258. ### 3.6 Discussion
  259. ```text
  260. Opening: restate contribution or reframe field.
  261. Compare: unlike <prior>, <NAME> <specific difference>.
  262. Limit: one named boundary.
  263. Remedy: concrete next step or scope condition.
  264. Close: resource / vision / calibrated outlook.
  265. ```
  266. ### 3.7 Sentence
  267. ```text
  268. Can I replace adjective with number?
  269. Can I replace "this" with named noun?
  270. Can I replace nominalization with verb?
  271. Can I cut the first clause?
  272. Does the sentence land on the strongest word?
  273. ```
  274. ---
  275. ---
  276. # Appendix A — 44-paper corpus
  277. | # | 领域 | 论文 | 刊物 | 取样文件 |
  278. |---|---|---|---|---|
  279. | 1–6 | 单细胞 | Geneformer, SCimilarity, Tangram, scIB, CellOracle, CellFM | Nature × 3, Nat Methods × 2, NC × 1 | `extracts/01-singlecell.md` |
  280. | 7–12 | 蛋白 / 结构 AI | AlphaFold2, ESM-2/ESMFold, ProteinMPNN, RFdiffusion, AlphaMissense, Foldseek | Nature × 2, Science × 3, Nat Biotechnol × 1 | `extracts/02-protein.md` |
  281. | 13–18 | 物理 / 气候 / 材料 | GraphCast, GenCast, DIMON, M3GNet, HINTS, GNoME | Science, Nature × 2, NCS × 2, NMI | `extracts/03-physics.md` |
  282. | 19–24 | 药物发现 | DynamicBind, Wong-MRSA, Halicin, SyntheMol, RetroExplainer, DRAGONFLY | NC × 4, Nature, Cell | `extracts/04-drug.md` |
  283. | 25–30 | 临床 AI | MedSAM, UNI, CONCH, Virchow, MedPerf, Ferber-GPT4V | Nat Med × 3, NC × 2, NMI | `extracts/05-medical.md` |
  284. | 31–36 | ML 通用 / 基础模型 | ChemCrow, AlphaGeometry, MolE, SemanticLens, Cancer-Imaging-FM, FunSearch | NMI × 4, Nature × 2, NC | `extracts/06-ml.md` |
  285. | 37–44 | **纯 AI 方法(v5 新加)** | Webb-MAP, Xiao-Densing-law, Whitelam-Simmering, DeepSeek-R1, Oh-DiscoRL, Farquhar-semantic-entropy, Muttenthaler-AligNet, Zhou-ADeLe | Nature × 5, NMI × 1, NC × 2 | `extracts/07-ai-methods.md` |
  286. ---
  287. # Appendix B — Before / After 对照练习索引
  288. 每个 pair 给"无 taste 版"和"有 taste 版"对比,附 1 句解释。打磨自己的稿子时,先选一对照之相近的 pair 读。
  289. | # | 章节 | Lesson | 在哪里 |
  290. |---|---|---|---|
  291. | 1 | Title | constraint-as-contribution | `references/02-title.md` §2.3 |
  292. | 2 | Title | discovery before method | `references/02-title.md` §2.3 |
  293. | 3 | Title | hedged aspiration | `references/02-title.md` §2.3 |
  294. | 4 | Title | tool + description | `references/02-title.md` §2.3 |
  295. | 5 | Abstract | concrete stakes | `references/03-abstract.md` §3.6 |
  296. | 6 | Abstract | bottleneck-aligned pivot | `references/03-abstract.md` §3.6 |
  297. | 7 | Abstract | numerical noun phrase | `references/03-abstract.md` §3.6 |
  298. | 8 | Abstract | named benchmark anchor | `references/03-abstract.md` §3.6 |
  299. | 9 | Abstract | community value over hype | `references/03-abstract.md` §3.6 |
  300. | 10 | Intro | two-gap over AI hype | `references/04-intro.md` §4.7 |
  301. | 11 | Intro | historical anchor | `references/04-intro.md` §4.7 |
  302. | 12 | Intro | analogy as argument | `references/04-intro.md` §4.7 |
  303. | 13 | Intro | design argument | `references/04-intro.md` §4.7 |
  304. | 14 | Results | claim as subject | `references/05-results.md` §5.11 |
  305. | 15 | Results | hardware + task-size baseline | `references/05-results.md` §5.11 |
  306. | 16 | Results | control with teeth | `references/05-results.md` §5.11 |
  307. | 17 | Results | mechanism-driven ablation | `references/05-results.md` §5.11 |
  308. | 18 | Results | capability map | `references/05-results.md` §5.11 |
  309. | 19 | Discussion | limitation as boundary | `references/07-discussion.md` §7.6 |
  310. | 20 | Discussion | remedy over vague future work | `references/07-discussion.md` §7.6 |
  311. | 21 | Discussion | resource close | `references/07-discussion.md` §7.6 |
  312. | 22 | Discussion | calibrated modesty | `references/07-discussion.md` §7.6 |
  313. ---
  314. # Appendix C — One-page reviewer red-team sheet
  315. 打印一张贴桌上。提交前 30 分钟过一遍。
  316. ```text
  317. Title:
  318. What story does it promise?
  319. Is any word overclaiming?
  320. Abstract:
  321. s1 stakes:
  322. s2 gap:
  323. s3 gap-2:
  324. s4 pivot:
  325. s5 method-spec:
  326. s6 key-result:
  327. s7 validation:
  328. s8 outlook:
  329. Missing anchor?
  330. Intro:
  331. Hook type:
  332. True antagonist:
  333. Straw-man risk:
  334. Prior work reviewer will cite:
  335. Results:
  336. Fig. 1 function:
  337. Climax figure:
  338. Weakest main-text experiment:
  339. Experiment to move to supplement:
  340. Strongest alternative explanation:
  341. Control addressing it:
  342. Methods:
  343. Leakage risk:
  344. Baseline fairness risk:
  345. Seed / uncertainty:
  346. Compute:
  347. Reproducibility artifact:
  348. Discussion:
  349. Main contribution restated:
  350. Limitation named:
  351. Outlook phrase:
  352. Is it earned?
  353. Sentence-level:
  354. Loud adjectives to cut:
  355. Nominalizations to replace:
  356. Vague nouns to name:
  357. Long sentence to split:
  358. ```
README.md · README · 181 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # nature-writing-skill
  2. > Claude Code / Codex skill — 面向中国 AI / ML 研究者,主投 **Nature Machine Intelligence**、次投 **Nature Communications / Nature Computational Science**、必要时冲刺 **Nature** 的论文写作技能。
  3. 把"能过审的 arXiv 风格"打磨成"Nature 系审稿人读完会说 *well-written, clearly motivated, compelling, careful, and hard to put down* 的论文"——本 skill 是 **44 篇开放获取论文逐句抽取**出来的 craft + taste + story-craft 手册,覆盖 abstract / intro / results / methods / discussion / figure 全链路。
  4. ---
  5. ## 是什么
  6. | 部分 | 文件 | 内容 |
  7. |---|---|---|
  8. | 写作 skill | `SKILL.md` | 骨架公式、写作顺序、按任务加载的 routing table、提交前 checklist、屏幕边 quick card、44 篇语料附录 |
  9. | 写作细节 | `references/01-story.md` … `15-taste-development.md` | 15 个主题文件,按需 Read |
  10. | 配图 skill | `FIGURE-SKILL.md` | Fig. 1 schematic 6 种构图、Wong/Okabe-Ito 8 色、字体字号、matplotlib/ggplot 模板、Illustrator 拼版流程 |
  11. | 配图细节 | `figure-references/01..12-*.md` | 12 个主题文件,按需 Read |
  12. | 语料 | `extracts/01-singlecell.md` … `07-ai-methods.md` | 7 类领域 / 44 篇 OA 论文的 verbatim 抽取,所有引文可 grep 回原文 |
  13. | 抽取方法 | `_framework.md` | 重建 / 扩充时参考 |
  14. ### 为什么"瘦索引 + 按需加载"
  15. 写作不是线性的。`SKILL.md` 只保留全局看得见的部分(骨架、顺序、checklist、quick card),其余 4000+ 行细节拆到 `references/`,按 routing 表只 Read 1–2 个文件——避免把整本手册塞进 context window。
  16. | 你正在做什么 | Read |
  17. |---|---|
  18. | 写 abstract | `references/03-abstract.md` |
  19. | 写 Results 子节 | `references/05-results.md` + `FIGURE-SKILL.md` |
  20. | 自审稿 | `references/09-reviewer-protocol.md` + `references/13-antipatterns.md` |
  21. | 选投哪个刊 | `references/14-journals.md` |
  22. | 卡在一句话上 | `references/08-sentence-taste.md` |
  23. | 长期 taste 培养 | `references/15-taste-development.md` |
  24. 完整 routing 表见 [`SKILL.md`](./SKILL.md) §1。
  25. ---
  26. ## 安装
  27. ### Claude Code
  28. ```bash
  29. # 用户级(所有项目都能用)
  30. git clone https://github.com/SyntaxSmith/nature-writing-skill.git ~/.claude/skills/nature-writing
  31. # 或项目级(仅当前项目)
  32. git clone https://github.com/SyntaxSmith/nature-writing-skill.git .claude/skills/nature-writing
  33. ```
  34. Claude Code 启动后会自动读取 `SKILL.md` 的 frontmatter。在对话里输入 `/nature-writing` 触发,或直接自然语言:"用 nature-writing skill 帮我打磨这段 abstract"。
  35. ### Codex CLI
  36. Codex 没有 skill 概念,把仓库 clone 到任意位置,然后在项目 `AGENTS.md` 里加指针:
  37. ```bash
  38. git clone https://github.com/SyntaxSmith/nature-writing-skill.git ~/skills/nature-writing
  39. ```
  40. ```markdown
  41. <!-- AGENTS.md -->
  42. ## Writing for Nature-family journals
  43. When drafting or revising papers for NMI / NC / NCS / Nature, first read
  44. `~/skills/nature-writing/SKILL.md`, then load only the relevant
  45. `references/*.md` per the routing table in §1.1.
  46. ```
  47. 或临时把对应章节作为附件丢给 Codex:
  48. ```bash
  49. codex "@~/skills/nature-writing/references/03-abstract.md 用这一节检查我的 abstract"
  50. ```
  51. ### 其他 agent / chatbot
  52. `SKILL.md` 是纯 Markdown,没有专属语法。任何能读文件的 LLM 工具(Cursor、Continue、Aider、ChatGPT custom GPT、Gemini Code Assist……)都可以把它当 system prompt 或附件用。
  53. ---
  54. ## 用法示例
  55. **写 abstract**
  56. ```
  57. > 我有一段 ML 方法论文的 abstract,请用 nature-writing skill 检查 pivot、
  58. KEY-RESULT 是否有 named baseline、outlook 动词是否与证据强度匹配。
  59. [paste abstract]
  60. ```
  61. **自审稿(5-pass harsh referee)**
  62. ```
  63. > 用 references/09-reviewer-protocol.md 的 SNEER / NOD / ASK / CUT 协议
  64. 审一遍我的 Results 章节,每段给 invisible answer。
  65. ```
  66. **提交前总扫**
  67. ```
  68. > 跑一遍 SKILL.md §2 的 checklist,每条标 ✅ / ⚠️ / ❌,
  69. ⚠️ 和 ❌ 给具体修改建议。
  70. ```
  71. **子门类剧本**
  72. ```
  73. > 这是一篇 LLM-agent 论文,按 references/12-subgenres.md 的剧本检查:
  74. prompt 报告完整性、tool schema 在不在 SI、外部 API 版本和 date 有没有写。
  75. ```
  76. ---
  77. ## 目录结构
  78. ```
  79. .
  80. ├── SKILL.md # 写作 skill 瘦索引(必读)
  81. ├── FIGURE-SKILL.md # 配图 skill 瘦索引
  82. ├── _framework.md # 抽取方法论
  83. ├── references/ # 15 个写作细节文件
  84. │ ├── 01-story.md # 7 种 canonical story shapes、Fig. 1 四种功能
  85. │ ├── 02-title.md # Title 6 种定式
  86. │ ├── 03-abstract.md # 5–8 句句式图、Two-gap、carve-out
  87. │ ├── 04-intro.md # 漏斗 4–6 段、6 种 hook、GAP 词库
  88. │ ├── 05-results.md # 标题三风格、figure call-out、统计写法、ablation
  89. │ ├── 06-methods.md # 复现性三处呼应、LLM-agent 专用清单
  90. │ ├── 07-discussion.md # Outlook 动词等级、Limitation as boundary
  91. │ ├── 08-sentence-taste.md # rhythm、经济、restraint、negative space
  92. │ ├── 09-reviewer-protocol.md
  93. │ ├── 10-voice.md # DeepMind / NMI / NC / NCS / 临床 5 种 voice
  94. │ ├── 11-language-bank.md # 强动词 / hedge / 段间连接
  95. │ ├── 12-subgenres.md # 7 个子门类剧本
  96. │ ├── 13-antipatterns.md
  97. │ ├── 14-journals.md # 各刊 voice 与策略
  98. │ └── 15-taste-development.md
  99. ├── figure-references/ # 12 个配图细节文件
  100. ├── extracts/ # 7 个语料文件 / 44 篇 OA 论文 verbatim
  101. └── archive/SKILL.v3.md # 上一代 craft-only 版(保留供参考)
  102. ```
  103. ---
  104. ## 语料来源(44 篇 OA 论文)
  105. | # | 领域 | 论文 | 刊物 |
  106. |---|---|---|---|
  107. | 1–6 | 单细胞基因组 | Geneformer · SCimilarity · Tangram · scIB · CellOracle · CellFM | Nature × 3 / Nat Methods × 2 / NC |
  108. | 7–12 | 蛋白 / 结构 AI | AlphaFold2 · ESM-2 · ProteinMPNN · RFdiffusion · AlphaMissense · Foldseek | Nature × 2 / Science × 3 / Nat Biotechnol |
  109. | 13–18 | 物理 / 气候 / 材料 | GraphCast · GenCast · DIMON · M3GNet · HINTS · GNoME | Science / Nature × 2 / NCS × 2 / NMI |
  110. | 19–24 | 药物发现 | DynamicBind · Wong-MRSA · Halicin · SyntheMol · RetroExplainer · DRAGONFLY | NC × 4 / Nature / Cell |
  111. | 25–30 | 临床 AI | MedSAM · UNI · CONCH · Virchow · MedPerf · Ferber-GPT4V | Nat Med × 3 / NC × 2 / NMI |
  112. | 31–36 | ML 通用 / 基础模型 | ChemCrow · AlphaGeometry · MolE · SemanticLens · Cancer-Imaging-FM · FunSearch | NMI × 4 / Nature × 2 / NC |
  113. | 37–44 | 纯 AI 方法 (v5 新增) | DeepSeek-R1 · Densing-law · AligNet · ADeLe · Webb-MAP · DiscoRL · Farquhar-semantic-entropy · Whitelam-Simmering | Nature × 5 / NMI / NC × 2 |
  114. 所有引文均来自开放获取论文(CC-BY 等 license),用于学术评论 / 写作教学。原作者保留版权。
  115. ---
  116. ## 如何扩展
  117. 新增第 8 类领域 / 第 45 篇论文:
  118. 1. 用 [`_framework.md`](./_framework.md) 的抽取格式,在 `extracts/` 下加新文件。
  119. 2. 把新句式 / 新模板回灌到对应 `references/*.md`(不是 `SKILL.md`,后者保持瘦索引)。
  120. 3. 更新 `SKILL.md` 附录 A 的 corpus 表 + `references/README.md` 的目录。
  121. ---
  122. ## License
  123. - **代码 / Markdown 结构 / 抽取框架**:MIT
  124. - **verbatim 引文**:原作者保留版权,使用时遵守对应 OA license。本仓库属于学术评论 / 教学用途。
  125. ---
  126. ## Patron sentence
  127. > "Many problems in mathematical sciences are *easy to evaluate*, despite being typically *hard to solve*."
  128. > — FunSearch (Romera-Paredes et al., *Nature* 2024)
  129. 写论文这件事正相反:易写难精。这把 skill 的目标,是让写得"对"和写得"好"之间的 gap 缩短一些。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.