lit-writeup

文献综述写作

帮助社会学家撰写期刊论文的理论部分（也称为“文献综述”或“背景”部分）。本指南基于对发表于 Social Problems 和 Social Forces 的 80 篇基于访谈的文章进行的系统分析。

文献综述三部曲

此技能属于包含三项技能的工作流：

技能	作用	关键输出
lit-search	通过 OpenAlex 查找论文	database.json、下载清单
lit-synthesis	通过 Zotero 分析并整理	field-synthesis.md、theoretical-map.md、debate-map.md
lit-writeup	起草正文	可直接发表的理论部分

理想输入：如果用户运行过 lit-synthesis，请索取他们的 field-synthesis.md、theoretical-map.md 和 debate-map.md——这些文件可直接用于选择主题群和规划结构。

最低要求：用户可以从自己对相关文献的笔记开始，但使用 lit-synthesis 的输出会让工作流更加顺畅。

何时使用此技能

用户希望进行以下工作时，可使用此技能：

• 根据文献数据库起草新的理论部分
• 重构现有但效果不佳的草稿
• 选择恰当的贡献策略（填补空白、拓展理论等）
• 撰写标志其贡献的“转折”句
• 根据领域规范调整措辞保留、引文和结构

核心原则

1. 结构体现学术抱负：小节数量、段落顺序和整体脉络会传达你要做出何种贡献。形式应与内容相匹配。

2. 转折至关重要：从“我们已知什么”转向“我们尚不清楚什么”，是本节修辞上的核心。应仔细设计这一转折。

3. 段落功能明确：每个段落都承担可辨识的作用（综合、阐述理论、指出空白等）。即使没有小标题，读者也应能感知其功能。

4. 主题群归属很重要：五种贡献类型（填补空白型、理论拓展型、概念构建型、综合整合型、问题驱动型）各有独特规范。应明确自己采用的是哪一种。

5. 遵循规范进行调整：领域对篇幅、引文密度和措辞保留的预期是可以掌握的。偏离规范应出于明确目的，而非无意为之。

五类主题群

理论部分根据其定位方式、结构和文献平衡，可归为五种鲜明风格：

主题群	占比	主要特点	适用场景
填补空白型	27.5%	指出尚缺少什么	针对研究不足的人群提出经验性见解
理论拓展型	22.5%	运用具名框架	将成熟理论应用于新的领域
概念构建型	15.0%	引入新术语	创建新的概念工具或类型学
综合整合型	18.8%	联结不同文献	汇合以往相互分离的理论传统
问题驱动型	16.3%	解决争论／提供实证记录	对争论作出裁定，或提供与政策相关的实证记录

详细介绍各类主题群典型段落顺序、引文模式和校准规范的资料，请参阅 clusters/ 目录。

工作流阶段

阶段 0：评估

目标：确定贡献类型并选择主题群。

流程：

• 审阅用户的研究问题和主要论点
• 评估现有文献（来自 lit-search 或用户的笔记）
• 确定定位方式（填补空白、拓展、构建、综合、争论）
• 选择合适的主题群
• 与用户确认主题群选择

输出：附有理由的主题群选择备忘录。

暂停：在规划结构前，先由用户确认主题群选择。

---

阶段 1：架构

目标：设计章节结构、小节和行文脉络。

流程：

• 选择行文脉络结构（漏斗式、积木式、对话式、问题—回应式）
• 规划小节组织方式（根据主题簇设置 0–5 个或更多小节）
• 确定要探讨的 3–5 篇关键文献
• 将转折安排在整体结构中的适当位置
• 创建包含小节标题的大纲

输出：包含章节大纲的架构备忘录。

暂停：段落规划前由用户批准结构。

---

阶段 2：规划

目标：规划各段落的功能和顺序。

流程：

• 为每个段落指定功能（PROVIDE_CONTEXT、SYNTHESIZE、DESCRIBE_THEORY、IDENTIFY_GAP 等）
• 规划每个段落的引文安排
• 确定关键论点的核心来源
• 安排段落顺序，逐步推进至转折
• 为每个段落拟定主题句

输出：包含功能和主题句的段落规划图。

暂停：由用户审阅段落规划图。

---

阶段 3：起草

目标：以句子层面的精细打磨撰写段落。

流程：

• 根据指定功能起草每个段落
• 使用恰当的开篇句类型（参见 techniques/sentence-toolbox.md）
• 运用恰当的模式整合引文（参见 techniques/citation-patterns.md）
• 保持符合主题簇特点的审慎措辞程度
• 逐步推进至转折句
• 记录所有使用的引文（作者、年份、上下文），以便生成参考文献

输出：完整的理论章节草稿 + citations-tracking.json。

暂停：由用户审阅每个小节（若有多个）或完整草稿。

---

阶段 4：转折

目标：打磨研究空白／贡献的转折。

流程：

• 运用四部分转折公式（参见 techniques/turn-formula.md）
• 确保研究空白具体明确，而非泛泛而谈
• 将研究空白与研究问题直接关联
• 调整论述的自信程度
• 将转折安排在恰当位置（大多数主题簇适合放在中间）

输出：经完善的转折句及其上下文。

暂停：由用户评估转折是否清晰具体。

---

阶段 5：修订

目标：依据规范进行调整和润色。

流程：

• 检查字数是否在目标范围内（1,145–1,744）
• 核实引文密度（每 1,000 字约 24 处；每段 3–5 处）
• 根据论点类型评估审慎措辞是否恰当
• 核实段落功能是否清晰
• 确保过渡流畅
• 最后润色，提升行文质量
• 使用 Zotero 查找并汇编引文列表（若 MCP 可用）
• 为参考文献部分生成参考文献表

输出：最终理论章节 + 质量备忘录 + citations-final.json + bibliography.md。

---

技巧指南

此技能在 techniques/ 中包含详细参考指南：

指南	用途
sentence-toolbox.md	7 种开篇句类型、过渡标记、审慎措辞调整
paragraph-functions.md	9 种段落功能及示例
citation-patterns.md	4 种引文整合模式
turn-formula.md	四部分转折结构及位置指导
calibration-norms.md	来自分析的统计基准

主题簇特征

clusters/ 中的详细特征说明：

特征	内容
gap-filler.md	填补空白风格：漏斗式行文、理论内容精简、转折鲜明
theory-extender.md	框架应用：点名理论家、介绍先前应用
concept-builder.md	新术语：积木式行文、定义性段落
synthesis-integrator.md	文献整合：贯通多种传统
problem-driven.md	解决争论或记录实证情况

校准基准

基于 Social Problems 和 Social Forces 中的 80 篇文章：

指标	中位数	目标范围（IQR）
段落数	10	7-12
词数	1,393	1,145-1,744
唯一引文数	35	26-43
每段引文数	3.5	2.4-5.0
小节数	2	1-3
每 1,000 词的引文数	24.2	18.9-32.0

调用阶段 Agent

每个阶段都使用 Task 工具：

Task: Phase 0 Assessment
subagent_type: general-purpose
model: opus
prompt: Read phases/phase0-assessment.md and clusters/*.md. Assess the user's contribution type and recommend a cluster. Project: [user's description]

模型推荐

阶段	模型	理由
阶段 0：评估	Opus	对贡献类型进行战略性判断
阶段 1：架构	Sonnet	结构规划
阶段 2：规划	Sonnet	段落排序
阶段 3：起草	Opus	行文技巧、引文整合
阶段 4：转折	Opus	高风险修辞表达
阶段 5：修订	Opus	编辑判断、校准

开始撰写

当用户准备好开始时：

1. 询问项目情况：

   “你的研究问题是什么？你提出的主要论点或贡献是什么？”

2. 询问可用材料：

   “你运行过 lit-synthesis 吗？如果运行过，请分享你的 field-synthesis.md、theoretical-map.md 和 debate-map.md。如果没有，你将涉及哪些关键文献，又会如何组织它们？”

3. 询问研究定位：

   “你会如何描述自己的贡献：填补我们知识中的空白、拓展已有框架、引入新概念、综合不同文献，还是解决一场争论？”

4. 评估并推荐一个类别：

   根据你的回答，应用决策树，并说明理由，推荐一个类别。

5. 进入阶段 0，正式确定评估结果。

重要提醒

• 类别选择会影响一切：不要跳过评估。类别选错 = 结构错误 = 读者困惑。
• 转折就是你的论点：读者记住的是你填补的空白，而不是你的文献综述。
• 具体明确更有说服力：“在 Z 背景下，我们对 Y 群体中的 X 知之甚少”胜过“还需要更多研究”。
• 谨慎措辞应有分寸：预测要谨慎，定义不必。机制要谨慎，发生率不必。
• 引文体现学术参与：引文不足会显得肤浅；引文过多则像罗列目录，而非提出论点。
• 视觉元素少见，但应策略性使用：只有提出框架的概念构建者才使用表格/图表。