scientific-writing-story

科学写作 — 阶段 1：寻找故事

概述

研究代码库中会积累并行实验和已放弃的实验。在编写任何大纲或正文之前，先确立一个连贯的故事：论点、支持论点的实验，以及明确记录哪些内容被舍弃。输出：使用该代码库中的 docs/writing/<story-slug>/story.md。

不要根据自己的假设撰写故事。先梳理代码库，再与用户达成一致。

方法主干 — 步骤 1–2

本阶段涵盖十五个步骤中的步骤 1–2（详情：scientific-writing/fifteen-steps.md）：

• 步骤 1 — 核心观点。 论点是一个简短的陈述句（主语 + 谓语），用于界定研究现象并明确重点。之后的每一段都必须阐明它。它不一定要成为最终标题。
• 步骤 2 — 叙事脉络。 叙事脉络回答我们想了解什么、为什么想了解、做了什么、现在知道了什么，并遵循关键转折（问题→答案、理论→证据、数据→解读）。优先采用双部分结构——这是最令人印象深刻、也最适合发表的形式。与用户达成一致时，确认哪种双部分结构最合适（例如：实验 1 + 实验 2；简单模型 + 复杂模型；实验 + 用于解释实验的模型；模型 + 用于检验模型的实验；观察到的模式 + 用于解释该模式的模型）。

流程

1. 梳理研究全貌。 派遣 Explore 子 Agent（只读）盘点： 实验/脚本、results/、figures/、笔记本、git 日志和 CLAUDE.md。 如果不同区域相互独立，使用 superpowers:dispatching-parallel-agents。 目标：列出每条实验/结果线索，并标记为 candidate-main 或 possibly-dropped。
2. 与用户逐一确认，每次只问一个问题。 确认：暂定标题、唯一论点、哪些线索纳入、哪些线索舍弃。优先采用选择题。在用户确认论点和纳入/排除划分前，不要开始撰写。
3. 撰写 story.md（使用下方模板）。

story.md 模板

# <Working title>
slug: <kebab-case-slug>

## Thesis
<one or two sentences — the single claim the paper makes>

## Narrative arc (linear)
Two-part scheme: <which Step-2 scheme, e.g. "experiment + model to explain it">
1. <beat> 2. <beat> 3. <beat> …  (the logical order the paper will argue in)

## Beat → artifacts
| Beat | Supporting artifacts (scripts / results / plots / notebooks) |
|------|------|
| <beat> | `path/to/script.py`, `results/x.csv`, `figures/y.svg` |

## Dropped / out of scope
- <thread> — why dropped (user-confirmed)

危险信号 — 停止

• 尚未梳理代码库就撰写 story.md → 先梳理。
• 断言用户尚未确认的论点 → 先询问。
• 某个叙事要点没有相应材料支持 → 要么找到材料，要么不将其作为要点。
• 悄悄纳入已放弃的实验 → 将其列入「舍弃」。

下一阶段

用户批准 story.md 后，调用 scientific-writing-outline。