name: analytic-memo description: | 分析备忘录(Analytical Memo)生成工具。研究者在编码过程中或编码后,直接 说出脑子里的想法——一个编码、一段资料、一个困惑、一个"这里有什么"的感觉—— skill 自动生成结构化的分析备忘录并保存为 Markdown 文件到本地。 适用于主题分析(TA)、扎根理论(GT)及一切质性研究方法。 与 memo-coach 的区别:analytic-memo 由 AI 代写分析内容; memo-coach 由研究者自己写,AI 只负责追问(专用于程序化扎根理论)。 当用户提到"写备忘录""记录分析思路""写 memo""分析笔记""帮我记下这个想法" "这个编码有点意思""这里好像有什么""这个值得记录" "这个受访者说的很奇怪",或在编码/主题分析过程中表达任何需要捕捉的分析直觉时触发。
分析备忘录(Analytical Memo)
分析备忘录是质性研究中捕捉分析动能的核心工具。Charmaz(2014)将备忘录定义为 研究者与数据之间持续进行的智识对话,而非填写分类表格的形式操作。 此 skill 的设计原则:研究者只管说出想法,工具负责追问和结构化。
启动:获取必要信息
触发后,只需收集两项信息(其余由 skill 自动判断):
触发内容:用户输入的编码片段、类属名称、原始资料段落、初步想法或困惑 (直接使用用户的原始表述,不要要求用户重新整理或分类)
保存路径(可选):若未提供,默认保存到
~/Documents/research-memos/
若用户在之前对话中已提供研究背景(研究主题、研究问题),直接沿用,不重复询问。
内部识别逻辑(对用户不可见)
根据用户输入,自动判断分析方向,不向用户暴露这个判断过程:
→ 概念深化(输入是单个编码或类属,附带描述或疑问) 追问:这个概念的核心含义和边界是什么?在哪些条件下更显著或消退? 与已有理论概念有何联系或张力?它暗示了什么理论主张?
→ 关系假设(输入涉及两个或以上概念,且包含关系词:关系、影响、导致、联系、之间) 追问:这个关系的性质是什么(因果、条件、并行、对立)? 数据中有哪些直接证据?在什么情境下成立或不成立(边界条件)?
→ 负面案例(输入包含反差信号:但是、例外、不符合、反而、奇怪、矛盾、和别人不一样) 追问:这是真正的反例,还是揭示了边界条件? 是否需要修订现有类属或理论假设?修订方向是什么?
→ 反身性(输入包含研究者自我指涉:我觉得、我担心、我是否、我的立场、我注意到自己) 追问:研究者的哪种预设或情绪可能影响了这段分析? 这个反思对理论抽样或研究设计有什么启示?
→ 综合展开(输入混合多种信号,或信号不明确) 先用一句话锚定这段想法的核心,再沿最主要的分析方向展开。
发展阶段判断(参考 Birks, Chapman & Francis, 2008)
根据用户描述的研究进展,在文件 frontmatter 中自动标注阶段:
preliminary:研究者处于开放编码早期,想法贴近数据、印象式interim:开始跨类属思考,建立概念间联系advanced:涉及核心类属、理论命题或整体理论框架
判断依据:
- "刚开始编码"/"第一份访谈" → preliminary
- 提到多个类属的关系/"开始看到模式" → interim
- 提到核心类属/"理论框架"/"饱和" → advanced
- 无法判断 → 留空,不强行填写
备忘录生成
按以下结构生成分析内容(对话中展示,同时写入文件):
文件 frontmatter
---
date: YYYY-MM-DD HH:MM
stage: <preliminary | interim | advanced>
tags: [<研究主题关键词>, <核心概念名>]
status: draft
---
正文结构
## 触发材料
用户原始输入,完整引用,一字不改。
## 核心追问
根据内部识别的分析框架展开,400–600字。 语气是研究者自己在思考,不是"建议你思考"——用第一人称或直接陈述。 追问应该推进分析,而不是复述输入内容。
## 暂定命题
一句话。陈述式,可被证伪。格式:"[条件/情境]下,[现象/机制],因为[初步解释]。" 这是备忘录的核心产出,逼迫研究者从模糊感觉走向可检验的命题。
## 待检验
- 具体的、可操作的检验行动(回到哪份数据?找什么?问什么?)
- 如需理论抽样,明确说明"去找什么类型的受访者/情境"
保存文件
文件名格式:YYYY-MM-DD_<核心概念词(2-4字)>.md
保存步骤:
- 使用 Bash 工具确认目录存在,若不存在则创建:
mkdir -p <路径> - 使用 Write 工具写入文件
保存完成后,在对话中只输出三项:
- 文件完整路径
- 暂定命题(重复一次,让研究者看清楚这句话)
- 待检验清单
不要总结备忘录全文,不要复述追问过程。
连续记录模式
一次对话中多次触发时,每条生成独立文件,自动累积。 对话结束时若生成了 2 条以上,汇总告知:本次共生成 N 条备忘录,列出路径和各自的暂定命题。
参考文献(供课程引用)
- Charmaz, K. (2014). Constructing Grounded Theory (2nd ed.). SAGE. (备忘录即对话)
- Birks, M., Chapman, Y., & Francis, K. (2008). Memoing in qualitative research: Probing data and processes. Journal of Research in Nursing, 13(1), 68–75. (发展阶段框架)
- Strauss, A., & Corbin, J. (1998). Basics of Qualitative Research. SAGE. (早期三类型框架,本 skill 已超越此框架)
语言
- 默认中文
- 若用户用英文输入,备忘录正文用英文,frontmatter 字段名保持英文