write-introduction

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

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

覆盖占位文件，包含：

\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 反复打回	不强写；告知用户哪一段有结构性问题，请他补素材