review-draft git:20261024.42c7031A

Immutable. This exact content never changes and is served at /api/v1/blob/d01b313de7aaf776.

---
name: review-draft
description: 综述文章初稿扩写（乔淼PhD · AI学术训练营 · AI学术工作流 · 综述文章工作台 · 管线终点）。把一篇**综述文章**（review 本身即整篇论文，贡献是综合/框架/议程）按其报告规范（系统→PRISMA / 半系统→RAMESES / 整合→Torraco 2005）扩写成综述初稿：读 综述选题.md 机器锚块定型定规范 + 证据综合.md 写综合/结果节（缺则占位，绝不编造数据/引语）+ 语料库 PRISMA 筛选记录写方法节 + 逐条引用核验出独立报告 + 参考文献表 + 反 AI 味 + 初稿纯净 + 转 docx。区别于 `review-draft-assembly`（那是给**实证论文**写文献综述**节**）。方法锚 Snyder (2019)。Trigger on："写综述文章初稿"、"把综述扩写成初稿"、"按 PRISMA/RAMESES/Torraco 成文"、"draft my review article"、"write up my literature review paper"。
---

# Review Draft · 综述文章初稿扩写（综述文章工作台 · 管线终点）

把一篇**综述文章**扩写成可打磨的全文段落初稿。综述文章的 review 本身就是整篇论文——不是实证论文里的文献综述节（那用 `review-draft-assembly`）。成文结构由**报告规范**决定：系统综述→PRISMA、半系统/叙事→RAMESES、整合式→Torraco (2005)。

方法锚：Snyder, H. (2019). Literature review as a research methodology: An overview and guidelines. *Journal of Business Research*, 104, 333-339.

## 调用约定（独立运行）

- 输入按"用户直给 > 项目文件 > 降级"解析：
  1. **综述选题.md（必需）**：读**文件最顶部的机器锚块**，取 `review_type`（systematic / semi-systematic / integrative）与 `report_standard`（PRISMA / RAMESES / Torraco (2005)）**定成文结构**；读锚块下方【综述规格块】（RQ / 纳入排除 / 组织框架 / 预期贡献）+【PXYV 派生投影】+ 近邻综述表作为写作依据。缺 → 指路先去「综述文章工作台」阶段① 用 `topic-review-*` 产出综述选题.md。
  2. **证据综合.md（③ 综合结果）**：存在 → **综合 / 结果节**据其逐子问题结论 + 证据整合撰写（meta-analysis 报效应量与 CI、定性报主题与脉络、整合式报新框架）；不存在 → 退回逐轮原始产出（`综合-*` / 分析日志.md）归并；两者皆无 → 综合/结果节只留骨架（一行"此节占位 · 待③综合落地后撰写"），**不凭空编造效应量、主题或引语**。
  3. **语料库 + 筛选记录（`文献/检索筛选/`：检索记录.md / 纳入排除标准.md / 选择流程.md（旧项目为 PRISMA流量.md）/ 筛选决定.csv）**：存在 → **方法节**的检索策略 / 纳入排除 / 数量流（识别→去重→**未进入筛选**→摘要筛→纳入）+ 流程图据其撰写；缺 → 方法节按综述选题.md 的检索协议种子写，并在交付说明标注"检索执行记录待补"。
     ⚠️ **上游是摘要层定稿模式**（`sr-search-record`）：筛选只在题名/摘要层完成，**没有全文合格性评估层**。方法节的数量流因此**没有"全文筛"这一段**，不得凭骨架补一个。这条与「未进入筛选（相关性排序预算外）」一起，都是必须如实写出的流程事实。
  4. 近邻综述表 / 已有综述：用于 Introduction 定位"本综述与既有综述的差异"。
- 参数：报告规范（默认跟随综述选题.md 锚块 `report_standard`，用户显式给则覆盖）、总字数目标（可选）、引用格式（默认 APA 7th）、输出语言（项目 CLAUDE.md 或用户指定）。
- 输入路径小结（按项目 AGENTS.md「文件放哪」表）：综述选题.md = `选题/综述选题.md`；证据综合.md = `数据/证据综合.md`（中间产物 `数据/综合-*`）；PRISMA 记录 = `文献/检索筛选/`。**别去 `数据/研究发现.md` 取材**——那是实证论文那条线的研究发现，内容完全是另一回事。项目说明里约定了 `RV_综述/` 子树的老项目，以项目约定为准（`RV_综述/01_选题/选题.md`、`RV_综述/03_综合成文/研究发现.md`、`RV_综述/02_检索筛选/`，初稿落 `RV_综述/03_综合成文/`）。
- 落盘（默认项目的 `写作/`；没有项目结构时落当前工作目录）：`综述文章初稿.md`（+ 双语 `-zh.md`）+ 同名 .docx + `引用核验报告.md`。**注意与 `review-draft-assembly` 的 `文献/综述初稿.md`（实证论文综述节）区分——本 skill 产出的是整篇综述文章。**
- **文件名固定叫 `综述文章初稿.md`**（+ `综述文章初稿-zh.md` / 同名 .docx），不管项目用哪套文件夹约定都**不许改名**——尤其不得写成 `综述初稿.md`，那是实证论文综述节的文件名，会覆盖别人的文件。文件夹按项目约定：新表放 `写作/`；老的 `01_选题 / 02_文献 …` 命名表项目放它的全文初稿文件夹（如 `05_全文初稿/`），**不放文献文件夹**；`RV_综述/` 老项目放 `RV_综述/03_综合成文/`。落盘前目标路径已有同名文件就加日期后缀（如 `综述文章初稿-20261015.md`），不覆盖。
- **调用方覆盖约定**：调用方（工作台 prompt / 用户）显式给出的参数、输入路径、落盘路径与工具选择，一律覆盖本 skill 的默认；但本 skill 的方法步骤、硬约束与停点不可被省略或稀释——调用方若要求跳过某硬约束，以本 skill 为准并提示冲突。

## 【报告规范决定结构】——先读综述选题.md 锚块 `report_standard`，按对应骨架成文

### systematic · PRISMA（系统综述）
1. **Introduction**：背景 + rationale + 明确的综述问题 / objectives（PICO 式若适用）+ 与既有系统综述的差异。
2. **Methods**：纳入 / 排除标准 · 信息源与检索式 · 筛选流程 · 数据抽取 · 综合方法（是否 meta-analysis）；给**数量流**（识别 n → 去重 → 未进入筛选 n → 题名摘要筛 → 纳入 n，各步排除数与理由）+ 流程图（文字描述或 mermaid）。
   ⚠️ 摘要层定稿模式下**没有"全文筛"这一段**。流程图可用 PRISMA 式样，但**图注与正文都必须写明"未进行全文合格性评估（eligibility assessed at title/abstract level only）"**——这是相对 PRISMA 的实质偏离，藏起来就是学术不端。Discussion 的局限节要再写一次。
3. **Results**：纳入研究特征表 + 综合结果——有可比 effect size → meta-analysis（森林图逻辑、合并效应量 + 95% CI + 异质性 I²，据证据综合.md）；否则定性系统综述（按结局 / 主题归并证据）。
4. **Discussion**：证据总括 · 与既有结论对话 · 局限（发表偏倚 / 检索边界）· 结论。

### semi-systematic · RAMESES（半系统 / 叙事 / meta-narrative）
1. **Introduction**：主题背景 + 为何需要跨学科梳理 + 综述目的。
2. **Approach & Scope**：透明但非穷尽的检索与取样逻辑（哪些传统 / 时间窗 / 代表性取样），透明到读者能判断合理性。
3. **Synthesis**：按综述选题.md 的组织框架展开——按**主题 / 历时发展 / 研究传统 / meta-narrative** 组织，讲清领域如何演进、有哪些主题与张力（据证据综合.md 的主题综合）。
4. **Research Agenda**：从综合中提炼**研究议程**（真有洞见，非罗列）。
5. **Conclusion**。

### integrative · Torraco (2005)（整合式）
1. **Introduction**：主题重要性 + 为何现有理论不够用（成熟需重构 / 新兴需初步概念化）。
2. **Method**：语料选择与"创造性取样"逻辑（可含书、跨传统、非穷尽，但透明）+ 批判角度。
3. **Critical Analysis & Synthesis**：**批判性**评估现有文献（挑假设 / 盲点，problematization），按概念而非按文献逐篇组织——是重构，不是汇总。
4. **New Framework / Typology**（核心贡献）：据证据综合.md 呈现浮现出的**新框架 / 类型学 / 重定义概念**，一句话说清"新在哪"。
5. **Implications & Future Research**。

> 三型都以目标期刊的实际惯例微调节名与编排；报告规范给的是骨架与必备要素，不是死模板。

## 强制要求

- 🌐【正文语言 · 最高优先级】正文严格用指定输出语言撰写，不得默认或回退到中文：英文项目 → 全英文；中英双语 → 指定语种正文 + 必要处中文对照；中文项目才用中文。"字数/词数"只是长度参考，不决定语言。
- 【综合 / 结果节据实】按证据综合.md 的逐子问题结论 + 证据整合撰写，引用**真实**效应量 / 主题 / 引语；证据综合.md 缺失就占位，**绝不编造数据、效应量、主题或原文引语**。
- 【方法节据实】检索式 / 纳入排除 / 数量流据 `文献/检索筛选/` 的筛选记录；无记录则据综述选题.md 检索协议种子写并标"待补执行记录"。
- 【局限节必写四条 · 摘要层定稿模式】① **筛选仅在题名/摘要层完成，未做全文合格性评估**；② **截断**——共识别 N 条，按相关性排序取前 M 条进入筛选，其余未评估（不是排除）；③ **证据级别构成**——纳入 k 篇中全文 X 篇、仅摘要 Y 篇，以及这对结论强度的影响；④ 检索源为 OpenAlex（+ 补充源），未用受控词表与商业库，未检索中文数据库。**这四条数字都从 `选择流程.md` 与 `筛选决定.csv` 反算，不许估**。
- 【摘要级证据的表述纪律】`证据综合.md` 里标了摘要级的结论，正文表述要跟着降级（"初步迹象"而非"研究表明"），**不得因为读起来更有力就上调**。
- 【每段成段落散文】不写成提纲；每段紧扣该节功能，就地标 inline citation [Author Year]（或 (Author Year, p.X)）；引用只用语料库里真实纳入的文献，不确定用 `[TBD-citation]` 占位。
- 各节起始加一句"本节功能（一行）"，便于打磨时对齐。
- 【纳入研究全引 · 硬约束】综述文章的**每一篇纳入研究都必须在正文里被引用至少一次**（纳入集 = `证据综合.md` 列出的纳入研究 / `筛选决定.csv` 的纳入记录）。综合 / 主题节按作者-年份**成组引用**（如 (Author A, 2021; Author B, 2022; Author C, 2023)），不能只举例引几篇。
- 【纳入研究一览表 · 硬约束】正文附「纳入研究一览表」，一篇一行：作者（年份）/ 国家·情境 / 设计 / 样本 / 归入主题 / 证据级别（`evidence_level`：全文 / 仅摘要），内容全部取自 `数据/综合-抽取表.csv` 与 `证据综合.md`，缺的写「未报告」，不推断。

## 【引用核验（对照 Zotero 库 / 语料库清单）】

初稿写完后逐条核对 inline citation：用 `zotero_search_items` / `zotero_get_item_metadata` 确认每条引用的 Author/Year 真实存在于集合、拼写与年份无误（Zotero 不可用时对照语料库清单 / 本地 PDF 文件名核对）。要回原文核对引语、页码时，**读全文先找转好的文字稿**：项目里有 `文献/全文/<和 PDF 同名>.md`（POPPER 的 MinerU 工具把 PDF 转成的文字稿，第一行是 `<!-- POPPER · MinerU：源文件 … -->`）就读它、不再读 PDF：每页开头有一行 `<!-- 第 N 页 -->`，那一页的内容引用时页码就写 N（和直接读 PDF 第 N 页一样算）；表格按文字稿里的表格读。没有这个文件，照旧读 PDF。产出独立的 `引用核验报告.md`（**不进初稿**）：每条引用 → 是否在库 → 有无出入。未能核实的引用，在初稿顶部"交付说明"里点名。

## 【参考文献表】

按指定引用格式（默认 APA 7th）在正文末尾生成"参考文献"表：**参考文献表 = 正文引用的全部文献 + 全部纳入研究**，仅列真实存在、可核对的文献。纳入研究条目前加 `*`，表头注明「标 * 的为本综述纳入研究」（APA 惯例）。

**成文后自检**：数一遍「纳入研究数 k」和「参考文献表里带 * 的条数」，两者必须一致，且这 k 篇都在正文里出现过；不一致就回去补引用 / 补条目，补不齐的逐篇点名原因。两个数写进顶部「⚠️ 交付说明」。

## 【写作要求 · 反 AI 味（内联，不调用外部 skill）】

- 去掉空洞过渡词，禁用"值得注意的是 / 综上所述 / 不仅……而且"这类套话。
- 句长有变化，不要每句同一节奏。
- 具体优于抽象：能给机制 / 数字 / 效应量 / 对象就不泛泛而谈。
- 陈述性学术语气，不堆形容词。

## 【交付要求 · 初稿纯净】

- 正文零备注：不出现内部编号、Zotero key、生成过程说明。
- 风险提示集中放文档最顶部一个"⚠️ 交付说明"区块，仅限：纳入研究数 k 与参考文献表带 * 条数（必须写）、③综合是否缺失 / 哪节证据偏薄、PRISMA 记录是否待补、未能核实的引用、缺页码的引用。除此之外正文是干净综述文章。
- inline citation 格式 (Author Year, p.X)。
- 输出语言按约定（中英双语 = 先英文 draft `综述文章初稿.md`，再中文译稿 `综述文章初稿-zh.md`，两稿都要 inline citation）。

## 【另存 Word】

md 初稿完成后，再转一份 .docx，与 md 同目录（中英双语项目：两份 md → 各转一份 docx）。**只用 pandoc 命令行转**（`pandoc 综述文章初稿.md -o 综述文章初稿.docx`，保留参考文献表与引用格式）；**不要调用任何文档 / Word 类技能或 Word 文档会话**。本机没有 pandoc（`command -v pandoc` 为空）就跳过 docx，md 照常交付，在结尾说一句「没装 pandoc，docx 没转；装好后让我补转」——这不算失败，不要停下来等。

## 流程

Step 0 读取（综述选题.md 锚块定型定规范 → 证据综合.md → `文献/检索筛选/` PRISMA 记录，缺的明说不假设）→ 按 `report_standard` 选对应骨架 → 逐节扩写成段落散文（综合/结果节据实、不编造）→ 纳入研究一览表 → 引用逐条核验出 `引用核验报告.md` → 参考文献表（纳入研究加 *）→ 自检纳入数 = 带 * 条数、k 篇都在正文被引 → 反 AI 味通读一遍 → 初稿纯净化（顶部⚠️交付说明）→ 转 docx。