mcpField
M
methods-writer

methods-writer

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

关于 methods-writer

methods-writer 帮助社会学研究者撰写、重组和修订访谈类期刊论文的方法部分。它依据对 77 篇文章的体裁分析,指导路径选择、章节结构和详略程度。

主要功能

  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 methods-writer

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

包含的文件

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

pathways/
detailed.md
efficient.md
standard.md
phases/
phase0-assessment.md
phase1-drafting.md
phase2-revision.md
techniques/
component-checklist.md
opening-moves.md

详细介绍

Methods Writer

帮助社会学家为基于访谈的期刊文章撰写方法部分(也称“数据与方法”或“研究方法”部分)。指导内容基于对 Social Problems 和 Social Forces 中 77 篇文章的系统分析。

何时使用此技能

用户想要以下操作时,可使用此技能:

  • 从头起草新的方法部分
  • 重组过长或过短的现有方法部分
  • 确定研究所需的适当细节程度
  • 确保包含所有必需的组成部分
  • 使方法部分符合领域惯例

此技能假定用户已完成数据收集和分析,准备撰写方法部分。

与其他技能的关联

技能用途主要输出
interview-analyst分析定性数据编码结构、研究发现
interview-writeup撰写研究发现部分研究发现初稿
interview-bookends撰写引言和结论首尾部分初稿

核心原则(基于体裁分析)

基于对 77 个方法部分的系统分析:

1. 以研究为先的开篇占主导

88% 的方法部分以研究或样本开篇,而非方法论论证。先介绍数据,不要先说明采用访谈的理由。

2. 饱和度主张并不常见

只有 4% 的文章声称达到饱和度。该领域大体上已不再以此作为论证依据。可改用其他说法:比较充分性、覆盖充分性或实际限制。

3. 表格与研究复杂度相关

54% 的文章包含人口统计表。若样本构成会影响结果解读,或 N > 30,请使用表格。精简型文章通常完全不使用表格。

4. 视角性说明视情况而定

只有 17% 的文章包含视角性讨论。以下情况可纳入:访谈者与受访者身份不匹配较为显著、研究对象为弱势群体,或身份影响了研究者的进入或受访者的披露。

5. 三种路径涵盖该领域

根据字数和结构复杂度,文章可归为精简型(10%)、标准型(61%)和详尽型(23%)。应根据研究特征,而非个人偏好,选择相应路径。

关键统计数据(基准)

方法部分基准
特征中位数IQR(典型范围)
字数1,3611,001-2,032
含表格54%--
分节标题67% 无0-2
视角性讨论17%--
提及饱和度4%--
字数分布
范围类别占比
< 700精简型10%
700-2,000标准型61%
2,000-3,500详尽型23%
> 3,500扩展型*6%

*扩展型文章通常采用多项研究设计或异常复杂的设计。

三种路径

根据长度、结构和文档记录详尽程度,方法部分可归为三种常见风格:

路径目标字数占比主要特点适用情况
精简型600-90010%内容浓缩,不含表格设计简单、篇幅受限
标准型1,200-1,50061%均衡,可选表格一般的访谈研究(默认)
详尽型2,000-3,00023%全面,必须含表格弱势群体、复杂设计

默认选择:标准型。只有在满足特定触发条件时,才选择精简型或详尽型。

详细的类型说明、基准、典型写法和字数分配指南,请参见 pathways/ 目录。

工作流阶段

Phase 0:评估

目标:收集研究信息并选择合适的路径。

流程:

  • 收集研究详情(样本、研究对象、设计、访问权限)
  • 应用决策树,确定路径
  • 与用户确认路径选择
  • 记录任何特殊考量(脆弱性、复杂性)

输出:包含理由的路径选择备忘录。

暂停:起草前由用户确认路径选择。


Phase 1:起草

目标:按照路径模板撰写完整的 Methods 部分。

流程:

  • 遵循该路径特定的结构和字数分配
  • 包含该路径要求的所有组成部分
  • 使用语料库中的恰当修辞模式
  • 根据用户的研究整合可选组成部分

指南:

  • phases/phase1-drafting.md(主要工作流)
  • pathways/(特定路径的模板)
  • techniques/component-checklist.md(需要包含的内容)
  • techniques/opening-moves.md(如何开篇)

输出:完整的 Methods 部分草稿。

暂停:由用户审阅草稿。


Phase 2:修订

目标:对照基准进行调整并润色。

流程:

  • 核对字数是否符合路径目标
  • 检查是否包含所有必需的组成部分
  • 评估可选组成部分(研究者立场、局限性)
  • 润色行文和过渡
  • 进行最终质量检查

指南:phases/phase2-revision.md

输出:修订后的 Methods 部分及质量备忘录。


路径决策树

要确定哪条路径适合你的研究:

START
  |
  v
[Is your population VULNERABLE or MARGINALIZED?]
  |
  +-- YES --> DETAILED PATHWAY
  |
  +-- NO --> Continue
        |
        v
[Is your design COMPLEX?]
(Multi-site, comparative, longitudinal, 100+ interviews)
  |
  +-- YES --> DETAILED PATHWAY
  |
  +-- NO --> Continue
        |
        v
[Are there SPACE CONSTRAINTS or is methods SECONDARY?]
  |
  +-- YES --> EFFICIENT PATHWAY
  |
  +-- NO --> STANDARD PATHWAY (DEFAULT)
快速判断指标
如果你的研究……考虑采用此路径……
涉及脆弱群体(在押人员、无证移民)详细
采用多地点或比较设计详细
有 100 次或更多访谈详细
面临重大访问障碍详细
字数限制严格精简
样本通过简单的便利抽样/滚雪球抽样获得精简
典型的单地点研究,访谈 30 至 80 次标准

路径概览

请参考以下指南,了解各路径的具体写作要求:

指南路径
pathways/efficient.md精简(10%)- 600-900 字
pathways/standard.md标准(61%)- 1,200-1,500 字
pathways/detailed.md详细(23%)- 2,000-3,000 字

技巧指南

指南用途
techniques/component-checklist.md各组成部分(抽样、研究方案、分析)需要包含的内容
techniques/opening-moves.md如何开启方法部分(以研究为主导的模式)

各路径的必需与可选组成部分

组成部分精简标准详细
样本量 N必需必需必需
人口统计信息简短文字说明文字说明 + 表格表格 + 对比
招募注明名称注明名称 + 渠道渠道 + 比率
时长必需必需必需 + 中位数
分析方法注明名称注明名称 + 流程注明名称 + 编码
软件可选建议包含必需
研究者立场省略视情况而定建议包含
伦理保护措施简述视需要而定涉及脆弱群体时详细说明

模型建议

阶段模型理由
Phase 0:评估Sonnet应用决策树
Phase 1:起草Sonnet遵循模板、生成行文
Phase 2:修订Sonnet核对调整情况并润色

开始流程

当用户准备开始时:

  1. 询问研究情况:

    “你的研究主题是什么?请描述你的样本(N、目标人群)、参与者招募方式、访谈方法以及数据分析方式。”

  2. 询问研究特征:

    “你的研究对象是否属于弱势群体或边缘化群体?你的研究设计是否复杂(多地点、比较性、纵向、100 次以上访谈)?是否有篇幅限制或期刊字数要求?”

  3. 确定路径:

    根据你的回答,应用决策树并说明理由,推荐一条路径。

  4. 确认并进入阶段 0,正式开展评估。

重要提醒

  • 标准路径为默认选项:大多数访谈研究都适用标准路径。只有在符合触发条件时才选择高效或详细路径。
  • 饱和度很少见:语料中的文章仅有 4% 声称达到了饱和度。可使用替代表述:“持续开展研究,直到各子群体中都出现关键主题”,或“样本量基于[比较/覆盖/务实]方面的考量。”
  • 表格节省篇幅:人口统计学表格可替代 200 多字的正文。当 N > 30 或样本构成很重要时,使用表格。
  • 是否说明研究者立场取决于具体情况:仅有 17% 的文章包含相关内容。触发条件包括:身份不匹配、研究对象属于弱势群体、身份影响了研究者的接触机会。
  • 开篇以研究为主:88% 的文章以研究或样本开篇。使用“I/我们基于对 [目标人群] 的 N 次访谈”,而不是“定性方法之所以合适,是因为……”
  • 字数很重要:审稿人会注意到方法部分过于简略或冗长。请根据所选路径调整篇幅。

评论

支持 Markdown