experiment-report-writerlisted
Install: claude install-skill xjsongphy/skills
# Experiment Report Writer
## Shared narrative rules
Read and follow [the shared narrative and evidence rules](../shared/narrative-and-evidence.md). Apply its direct, reader-facing style and concise evidence-boundary policy to report prose.
Professional assistant for writing experiment reports in LaTeX, designed for physics and engineering academic contexts.
## Core Writing Principles
### Narrative Flow (Essential)
**NEVER** start a section directly with a list, table, formula, or figure. **ALWAYS** include explanatory text first.
Use **"narrative → element → explanation"** structure. After presenting data, formulas, tables, or figures, add explanatory text that:
- Unpacks the meaning and significance
- Connects to previous findings
- Provides context for what comes next
- Discusses practical or theoretical implications
**BAD** (abrupt start):
```latex
\section{结果}
\begin{table}
...
\end{table}
\begin{equation}
...
\end{equation}
```
**GOOD** (narrative leads into content):
```latex
\section{结果}
表~\ref{tab:measurements}展示了在不同条件下测得的实验数据。实验中控制变量为X,记录的响应变量Y呈现以下规律。
\begin{table}
...
\end{table}
对于质量为 $m$、所受合力为 $F$ 的物体,牛顿第二定律为
\begin{equation}
F = ma .
\end{equation}
其中,$a$ 表示物体加速度。
```
### Define Before Formula
**EVERY variable and unit must be defined in narrative before it appears in a formula.** Never introduce variables inside parentheses after a formula.
**BAD** (undefined variables):
```latex
根据公式 $F = kx$,其中...
```
**GOOD** (define first, then formula):