Research Writing

---
name: research-writing
description: Write and revise empirical research papers from an outline, study design, analysis outputs, figures, and an existing BibTeX library. Use for IMRaD manuscripts and evidence reports; do not use for literature-only reviews or rebuttal letters.
outputs: [manuscript/]
provides: [research-writing]
---

# 实证科研论文写作

## 适用范围

用于有研究问题、方法、结果和讨论的实证论文或分析报告。先读任务书、研究设计、结果表和现有文献笔记，再写作；不要把综述写作方式套到实验结果上。

## 核心约束

- 只使用项目已有的研究问题、方法、结果和 `references.bib`。不得编造数据、样本、显著性、实验条件或文献。
- 若有 `manuscript/outline.md` 和 `manuscript/section-status.md`，按大纲和允许集写。结论只用「## 结论条目」里状态为已认可的编号。
- 审查报告里没有被写成接受或修改的条目，不得据此改数字、因果、样本或结论范围。
- 数字、方向和结论必须能回溯到分析表、结果章节或图表；证据不足写 `[待核实]` 或 `[待补实验]`，不要用流畅措辞掩盖缺口。
- 按 IMRaD 组织：Introduction 说明问题、研究空白和贡献；Methods 对应设计；Results 只报告观察结果；Discussion 区分解释、局限和后续工作。
- 从已有成稿转 LaTeX 时只改排版与引用命令，不改学术观点、数字与结论。
- 负结果、失败实验、离群值和与假设不一致的结果必须保留并说明处理规则，不因结果不理想而事后换分析口径。
- 引用只使用 `references.bib` 已存在的键（源稿 `[@bib键]`）；缺条目先补齐可核验元数据并标注待核，不凭记忆生成。docx/PDF 的引用样式按 quarto-render：先看项目 PDF 再由人选定，不设默认。

## 写作流程

1. 读取 `TASK.md`、项目全局设定、研究设计、`analysis/results-table.md`、`analysis/findings.md`、图表说明和文献笔记，建立“论点—证据—来源”表。
2. 先列出每节要回答的问题与证据，再成文。每个主要结论至少绑定一个数字、表/图或可定位的文献来源。
3. 生成 `manuscript/draft.md` 或任务书指定的稿件文件；图表只引用已有文件或用明确占位，不复制或虚构图片。
4. 做一致性检查：术语、样本量、分组、指标、方向、有效数字、图表编号和引用键前后一致。
5. 另列局限、未决事项和需要人工确认的作者信息/投稿信息，不能把这些内容悄悄填成事实。

## 交付自查

- IMRaD 四部分齐全，研究问题与贡献在引言和讨论中一致。
- Results 没有混入未经分析支持的因果表述；Discussion 明确哪些是结果、哪些是解释或推测。
- 每个表/图在正文中被引用，图注说明样本、指标和条件；没有数据的图表保留占位并标注待绘制。
- 文中引用键均能在 `references.bib` 找到；不确定的事实带 `[待核实]`。

## 验证与写作边界

- 读取已批准的设计版本、偏离记录、数据/代码/环境版本和复算证据；没有时只做带状态的草稿，不把统计报告存在当通过。
- 主要论断表同时记录支持范围、替代解释/反证和未决事项；事实、假设、推测、结论分开。同数据探索后补检验不自动确证，不显著不自动证明无效。
- 核心引用回原文做支持性核验，和 bib 键检查分开；摘要-only 不支撑无法从摘要核实的定量/方法/因果主张。
- 数据/清洗/指标或原文版本改变，标出失效的表图与段落，重算重验后才复用；补实验先回设计→执行→分析→复算，再同步摘要、讨论与回复信。
- 投稿前人确认结论范围、共同作者/贡献、利益/资助/AI 使用披露、数据代码可用性；核心阻塞问题未关闭不得称可投稿。按证据决定篇幅与发现数，允许负结果和证据不足。**词数不够不是缺陷**：禁止为凑篇幅加背景铺陈或同义复述。某节薄，只回设计/结果表/笔记/原文补可定位证据；没有更多证据就保持短并标 `[待核实]` 或 `[待补实验]`。论断直接说，必要局限写一次；真实不确定写清来源，不要叠三层 hedging。

## 验收入口

有 TASK.md 时沿用其中的验收摘要/质量状态合同，不重复建表；独立使用时，在本报告开头写：回答、关键证据入口、未验证、影响结论的问题、待人决定。状态为待审/有条件接受/证据通过（限定范围）/阻塞；推荐不等于人工批准。