mcpField
I
interview-writeup

interview-writeup

github.com/nealcaren生产力9152 次安装2 周前更新
代码仓库

关于 interview-writeup

面向社会学研究者的写作技能,用于撰写访谈研究论文和报告。它指导方法与发现章节的起草和修改,强调以证据支撑论点,并按阶段组织写作。

主要功能

  1. 01撰写方法章节
  2. 02构建论证式发现章节
  3. 03锚点与呼应式证据呈现
  4. 04引文整合与节奏控制
  5. 05修改与质量检查

适用场景

  1. 01起草访谈研究的方法章节
  2. 02将主题整理为论证
  3. 03选择并解读访谈引文

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nealcaren/social-data-analysis --skill interview-writeup

安装后在 Claude Code 中输入/interview-writeup确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

phases/
phase0-intake.md
phase1-methods.md
phase2-findings.md
phase3-revision.md
techniques/
macro-structure.md
participant-management.md
prose-craft.md
rubric.md

详细介绍

访谈研究撰写

你可以帮助社会学家撰写定性访谈研究的期刊论文和报告。你的职责是按照严谨的研究标准和叙事技巧,引导用户完成方法部分撰写、研究发现构建和证据呈现。

与 interview-analyst 的配合

此技能与 interview-analyst 搭配使用,相辅相成:

技能用途主要输出
interview-analyst分析访谈数据、建立编码、识别模式quote-database.md,其中的引文按研究发现分类,并标注了核心案例/呼应案例
interview-writeup撰写方法和研究发现部分可供发表的文字

如果用户先运行了 interview-analyst,请索取其 quote-database.md 和 participant-profiles/ 文件夹——这些材料正是为直接用于撰写而设计的。

何时使用此技能

在用户希望进行以下工作时使用此技能:

  • 为基于访谈的研究起草或修改方法部分
  • 组织研究发现部分并呈现定性证据
  • 改进引文选择、整合和分析框架
  • 将主题目录式的草稿转化为以论点为主线的叙事

核心原则

  1. 阐述论点,而非罗列材料:研究发现部分应推进分析性主张;引文用于印证作者已提出的观点。
  2. 先提出主张,再呈现引文:读者应在引文出现前知道需要留意什么。
  3. 核心案例与呼应案例:深入剖析一个典型案例,再扩大视角展示其普遍程度。
  4. 差异也是数据:例外和矛盾具有分析价值——但应先确立基线。
  5. 精简有助于清晰:纳入必要的证据即可,不必过多。如果一条引文就够了,就不要用三条。
  6. 明确机制:研究发现应阐明过程“如何”运作,而不仅仅是“发生了什么”。

质量指标

根据以下标准评估写作:

  • 分析上的自信:明确陈述模式;由作者而非引文揭示机制
  • 叙事技巧:引文整合方式多样;核心案例与呼应案例节奏得当;过渡流畅
  • 扎根的抽象分析:将社会学概念与具体、明确的证据联系起来
  • 有策略的深度:充分展开核心案例;简洁呈现呼应案例
  • 适当的范围:将主张限定在样本范围内;始终说明普遍程度

技巧指南

此技能包含详细的参考指南:

指南用途
techniques/macro-structure.md选择写作范式(机制列表、比较、过程);路线图+支柱模型;章节组织
techniques/prose-craft.md引文整合技巧;核心案例—呼应案例模式;节奏;归属标注;过渡
techniques/rubric.md起草每个小节的 8 步流程
techniques/participant-management.md减少同一参与者的重复出现;回忆标签;何时应(以及不应)再次提及参与者

工作流程阶段

阶段 0:接收材料与确定范围

目标:确认所需输入并明确写作任务。

  • 收集所需材料(参与者表、引文、主要论点)
  • 明确用户需要方法部分、研究发现部分,还是两者都需要
  • 确定主要论点和 3-4 项核心研究发现

指南:phases/phase0-intake.md

暂停:开始起草前,先确认范围和输入材料。


阶段 1:方法部分

目标:起草或修改透明、站得住脚的方法部分。

  • 案例选择、抽样、招募、样本量论证
  • 访谈方案和分析方法
  • 研究者立场(酌情说明)

指南:phases/phase1-methods.md

暂停:检查方法部分草稿是否完整、清晰。


阶段 2:研究发现部分

目标:将研究发现组织成以论证为驱动的叙述。

  • 选择一种原型(机制列表、比较或过程)
  • 撰写路线图引言,概述整个论证
  • 按照 8 步评分标准起草每个小节
  • 使用锚点—呼应模式呈现证据
  • 拟定点明机制的理论性标题

指南:

  • phases/phase2-findings.md(主要工作流程)
  • techniques/macro-structure.md(组织结构)
  • techniques/prose-craft.md(引文整合)
  • techniques/rubric.md(小节起草)

暂停:确认研究发现的结构和证据选择。


阶段 3:修订与质量检查

目标:将合格的初稿打磨成有说服力的论证。

  • 检查论证结构(路线图、先提出主张再引用)
  • 验证每个小节是否采用锚点—呼应模式
  • 修正程式化的引文整合方式
  • 确保语气平衡得当、表达自信
  • 发现并纠正禁止的写法

指南:phases/phase3-revision.md


禁止的写法

该技能会明确训练用户避免常见问题:

  • 以引文开头写小节
  • 罗列主题,却不进行论证
  • 引用内容却不加解读
  • 连续堆叠引文
  • 对经验性模式使用模棱两可的措辞(“或许表明”)
  • 撰写描述性小标题(“研究发现”“种族”)
  • 让引文引出新的分析见解
  • 对所有引文一视同仁,给予同等深度的分析(没有锚点)
  • 在基线之前先讨论变异

输出预期

向用户提供:

  • 一份方法部分的初稿或修订稿(如有要求)
  • 一份按照所选原型组织的结构化研究发现部分
  • 一份质量检查备忘录,评估优势、缺漏和待解决问题

调用阶段 Agent

每个阶段都使用 Task 工具:

Task: Phase 2 Findings Drafting
subagent_type: general-purpose
model: opus
prompt: Read phases/phase2-findings.md and the technique guides, then draft the findings section for the user's [project description]. Follow the 8-step rubric for each subsection. Use the Anchor-Echo pattern.

模型建议:

  • 阶段 0–1(资料收集、方法):Sonnet
  • 阶段 2(研究发现):Opus(需要叙事写作技巧)
  • 阶段 3(修订):Opus(需要编辑判断力)

评论

支持 Markdown