# Write Introduction

> 按 motivation / literature / contribution / roadmap 四段法写论文 Introduction。遵守 academic-writing-style 规则（无实现泄露、正式语态、引用规范）。当用户说"写 introduction"、"draft intro"、"动机 + 文献 + 贡献"时调用。

- Skill: `allblueuk/write-introduction` (Agent Skill)
- Install (CLI): `npx skillmds@latest add allblueuk/write-introduction`
- Raw SKILL.md: https://api.skillmd.com/api/skills/allblueuk/write-introduction/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: allblueuk (https://skillmd.com/u/allblueuk)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/allblueuk/write-introduction

---


# write-introduction — 学术论文 Introduction 四段法

## 触发场景

- "写 introduction"
- "draft the intro"
- "把动机/文献/贡献写一下"

## 输入契约

| 字段 | 类型 | 说明 |
|---|---|---|
| `paper_dir` | path | 默认 `<project_root>/paper/` |
| `research_question` | str | 1–2 句话的研究问题 |
| `key_findings` | str | 已有结果的核心 2–3 个数字或定性结论 |
| `lit_anchors` | list[str] | 已经在 `references.bib` 中的 3–5 个最近文献 key |

## 前置条件

- `paper/sections/01_introduction.tex` 占位存在（由 `paper-structure` 创建）
- 模型与结果已经存在（`code/<model>/spec.md` 通过评审，`results/` 有数字）
- **已阅读** `rules/academic-writing-style.md`

## 步骤清单

### Step 1. 准备四段素材

为下面四段分别准备一句话总纲：

1. **Motivation**（≈ 200 词）：研究问题为什么重要？现实背景是什么？数字大不大？涉及的人群多不多？
2. **Literature**（≈ 250 词）：最近 5–10 年与本研究最近的文献，按"theme A — theme B — theme C"组织（不要按时间）。每篇明确点名作者+年份。突出本研究**与文献最近的工作的差别**。
3. **Contribution**（≈ 200 词）：本文有什么新增？给 1–3 条**具体**贡献（"我们 quantify ..."、"我们 extend ... to allow for ..."），不要写空话（"contribute to the literature"）。
4. **Roadmap**（≈ 80 词）：" The remainder of the paper is organised as follows. Section 2 ...; Section 3 ...; Section 4 ...; Section 5 ...; Section 6 ...; Section 7 ..."

### Step 2. 起草段落

按 step 1 的总纲，写出每段。**严格遵守 academic-writing-style 规则**：
- 不出现机器路径、流水线术语、bash 命令
- 全部用正式被动 / 主动语态
- 引用用 `\citet{}` / `\citep{}`
- 数字必须有出处（数据来源或本研究 Section X 引用）

### Step 3. 写入 sections/01_introduction.tex

覆盖占位文件，包含：

```latex
\section{Introduction}
\label{sec:introduction}

% --- Motivation ---
<段 1>

% --- Literature ---
<段 2>

% --- Contribution ---
<段 3>

% --- Roadmap ---
<段 4>
```

每段之间空一行；不要写小节标题（一级 section 内不分小节）。

### Step 4. 检查引用

用 `Grep` 在本段中找出所有 `\citet{}` / `\citep{}`，确认每个引用 key 都已在 `paper/references.bib` 中。若缺，调用 `manage-bibliography` skill 补 entry。

### Step 5. 提交 paper-reviewer

把生成的段落和引用清单交给 `paper-reviewer` 子 agent。等评审：
- 通过 → 进入下一 section
- 修改后通过 → 必改项 tick 后重提交
- 不通过 → 回到 Step 1 重新整理素材

### Step 6. 写入会话日志

## 输出契约

| 文件 | 必产 | 说明 |
|---|---|---|
| `paper/sections/01_introduction.tex` | ✅ | 4 段，约 700–900 词 |
| `paper/references.bib` | 更新 | 新增的引用 entry |
| `quality_reports/<project>_intro_review_<ts>.md` | ✅ | paper-reviewer 评议 |

## 不允许的操作

- 写"This paper is generated by ..."、"AI-assisted"
- 写"see code/<...>"、"as shown in `output/...`"
- 用 "we will show"（→ "we show"）；用 "let's"（→ "consider"）
- 写 5–6 段而不是 4 段（坚持四段法，结构清晰）
- 在 Introduction 里塞方程（除非是 *最最* 关键的一两个，否则全留到 Section 2）

## 失败回退

| 症状 | 处理 |
|---|---|
| 研究问题不清晰 | 调 `interview-me` 反向访谈 |
| `lit_anchors` 为空 | 调 `lit-review` 先做文献调研 |
| paper-reviewer 反复打回 | 不强写；告知用户哪一段有结构性问题，请他补素材 |