基于 Braun & Clarke 反思性主题分析框架的质性研究辅助工具。 支持两种输入模式： （1）直接提供原始访谈文本 → skill 逐份完成 TA 初始编码，汇总后进入主题识别； （2）提供已有初始编码池 → 直接进入聚类、审查、命名建议流程。 输出结构化候选主题表，明确标注边界模糊编码与待研究者裁定的命名建议。 当用户提到"主题分析"“主题编码”"帮我聚类编码""从编码提炼主题""Braun Clarke""候选主题" "这些编码怎么归主题""帮我看看主题结构""对访谈做主题分析"时触发此 skill。 注意与 grounded-coding 的区别：grounded-coding 面向程序化扎根理论的类属建构与理论关系； thematic-analysis 面向 Braun & Clarke 路线的语义主题识别，输出主题结构而非理论命题。
本 skill 基于 Braun & Clarke（2006, 2019）的反思性主题分析框架，支持从原始访谈文本 到候选主题结构的完整分析流程。
重要定位：主题命名是分析行为，体现研究者的理论判断，最终命名必须由研究者作出。 本 skill 在命名阶段只提供备选，不做裁定。
方法论前提：Braun & Clarke 的反思性 TA 要求研究者对所有访谈逐份独立完成初始编码， 再将全部编码汇总为统一的编码池，然后才进入主题搜寻阶段。
触发后，第一步必须确认输入类型：
"你现在准备做主题分析——你手上有的是： A. 原始访谈文本（尚未编码） B. 已完成的初始编码（一份或多份） 哪种情况？"
情况 A：提供原始访谈文本 → 进入初始编码阶段
情况 B：提供已有初始编码 → 询问是否已汇总，进入编码池处理
确认为情况 A 后，在正式开始编码前，询问研究者是否希望提供示范编码：
"在正式编码前，你可以选择： ：你先对文本中任意一小段（3–5 句）做示范编码，AI 会识别你的编码风格，然后按你的风格完成后续编码 ：跳过示范，AI 按照标准原则直接开始
哪种方式？（选 B 或不回应则直接开始）"
若研究者选择 A（研究者示范）：
"原文" → [编码标签]）"我理解你的编码风格是：[描述]。我将按照此风格完成后续编码。如有偏差，请随时纠正。"
若研究者选择 B 或未回应：
直接进入步骤 1，按标准原则编码。
TA 的初始编码与扎根理论的开放编码有本质差异：
| TA 初始编码 | GT 开放编码 | |
|---|---|---|
| 目标 | 捕捉意义单元，贴近数据语言 | 为类属建构准备，需要概念抽象 |
| 粒度 | 短语级，尽量用受访者原话 | 可更高度概括 |
| 后续 | 汇总后搜寻主题（并列结构） | 归并类属、属性维度分析（层级结构） |
研究者提供原始访谈文本后，执行以下步骤：
步骤 1：通读全文，识别意义单元
逐句扫描全文。只有以下两类才可跳过，且必须在编码结果中标注"已跳过"：
其余所有语句，无论看起来信息量多少，都作为意义单元处理并给出编码。某句话是否重要，是研究者的判断权，不是 AI 的判断权。当不确定时，给出一个描述性编码（如"重复前述观点""表达不确定"），而不是跳过。
步骤 2：逐单元生成初始编码
编码原则：
输出格式：
【访谈 N】初始编码
（被访者简称 / 编号）
原文片段 → 编码
"......" → [编码标签]
"......" → [编码标签]
...
本份编码总数：N 条
步骤 2.5：自动保存编码结果到文件（强制执行，不可跳过）
编码输出完成后，必须立即调用 Write 工具将编码写入文件。不得仅在对话中输出而不写文件。
文件命名规则：coding_[被访者编号或简称].md
（如 coding_A.md、coding_P1.md）
保存路径：当前工作目录（即项目目录根目录）
文件内容格式：
# 【访谈 X】初始编码
被访者：[编号/简称]
编码日期：[日期]
## 编码列表
"原文片段" → [编码标签]
"原文片段" → [编码标签]
...
## 统计
本份编码总数：N 条
Write 工具调用完成后，告知研究者：
"本份编码已通过 Write 工具保存至
coding_[被访者编号].md。"
步骤 3：询问是否继续下一份
"【访谈 N】初始编码完成，共 N 条。 还有下一份访谈文本吗？如有，请提供； 如果这是最后一份，我们进入编码汇总。"
所有访谈编码完成后，自动进入辅助汇总流程。
研究者已有初始编码时，询问汇总状态：
"你已有的初始编码来自几份访谈？是否已经汇总到一份列表里？"
已汇总 → 直接进入后续信息收集
未汇总 → 执行辅助汇总
研究者依次提供各份访谈的编码：
【访谈 N】（被访者简称或编号）
编码1
编码2
...
无论来自情况 A 还是情况 B，所有编码汇总后输出：
汇总编码池
总编码数：N 条
来源访谈：P1, P2, ... PN
跨访谈重复出现的编码（出现 ≥2 次）：
- [编码名]：出现于 P1, P3
- ...
单份访谈独有的编码：
- [编码名] [P2]
- ...
汇总完成后，收集后续必要信息：
必填：研究问题——用一句话说明研究在问什么，是判断主题相关性的基本参照。
选填：理论视角——若有，在主题审查阶段提示主题与理论的对话关系。
选填：当前困惑——若对某些编码归属已有疑虑，先行标注，优先处理。
确认编码池完整后，自动连续执行以下四个阶段，无需每步等待用户确认。
在进入聚类之前，先对全部编码做一次整体扫描，输出：
这一步的目的是让研究者在进入正式聚类前，先看到编码的整体地形。
将编码归入候选主题，输出 5–8 个候选主题（若编码数量极少可减少）。
聚类原则：
每个候选主题的输出格式：
候选主题 [序号]：[暂定名称（描述性，非最终）]
核心含义：用1-2句话说明这个主题在捕捉什么经验或意义
包含编码：
- [编码1]
- [编码2]
- ...
边界模糊编码（归属不确定，需研究者判断）：
- [编码X]：模糊原因
- [编码Y]：模糊原因
对每个候选主题从以下三个维度进行审查，输出审查意见：
这个主题内部的编码，是否都在描述同一种经验或意义？ 还是有些编码其实属于不同的现象被勉强归在一起？
这个主题与其他候选主题之间的边界是否清晰？ 如果有两个主题高度重叠，指出它们的差异在哪里，以及是否应该合并或拆分。
这个主题是否真正在回应研究问题？ 还是它只是材料中的一个高频现象，但与研究问题关系较弱？
审查结果中，对每个候选主题给出明确判断：
备忘录提示（可选）： 主题审查过程中，如果某个主题让你产生了理论联想——觉得"这个主题和某个理论概念很像"或"这两个主题之间的张力说明了什么"——现在就可以切到
analytic-memo，把这个想法写成分析备忘录。TA 的备忘录不需要遵循扎根理论的结构，直接说出你的想法即可。
这是 skill 移交给研究者的关键节点。
对每个通过审查的主题，提供：
每个备选名称附说明：
格式：
备选名称 A：[名称]
- 优点：...
- 局限：...
- 理论暗示：...
备选名称 B：[名称]
- 优点：...
- 局限：...
- 理论暗示：...
在呈现完所有主题的备选名称后，输出以下追问：
命名背后的理论立场值得多停一步。 不同的备选名称往往暗示不同的理论对话方向—— 对于让你犹豫的主题，可以问自己：
- 这个名称是在描述现象，还是在解释机制？
- 它更靠近哪个已有的理论概念？这种靠近是你想要的吗？
- 如果换一个名称，你的研究会加入一场不同的理论对话——你想去哪场？
在所有命名建议之后，输出以下固定文字：
命名判断移交研究者。 主题命名体现研究者的理论立场，以上备选名称仅供参考。 以下问题请研究者自行判断后告知，以便进入后续工作：
- 哪些主题的名称已确定？
- 哪些主题的名称需要修改？
- 是否需要对某些主题进行合并、拆分或删除？
研究者确认主题命名后，必须立即执行以下保存步骤（不可跳过）：
调用 Write 工具，将最终主题结构保存至项目目录：
文件命名：themes_[研究主题].md（如 themes_快车司机.md、themes_平台工人.md）
保存路径：当前工作目录（项目根目录）
文件内容：
Write 完成后告知研究者：
"
themes_[研究主题].md已保存至项目目录，供后续ta-methods-writer、ta-findings-writer等 skill 自动读取。"
研究者确认主题命名后，还可继续请求以下任意操作：
输出一份完整的主题结构表，格式如下：
| 主题编号 | 主题名称 | 核心含义 | 包含编码数 | 代表性语句（若有原文） |
|---|
对研究者指定的某个主题，做更深入的分析：
分析候选主题之间是否存在：
输出主题关系图谱（文字版）。
将最终确认的主题结构保存为 Markdown 文件。
文件名格式：YYYY-MM-DD_themes_<研究主题关键词>.md
默认保存路径：~/Documents/research-memos/themes/
文件内容包含：研究问题、主题结构表、各主题含义说明、边界模糊编码处理记录。
| Skill | 定位 | 何时使用 |
|---|---|---|
thematic-analysis | 初始编码 + 主题识别与结构化 | 从原始访谈文本到候选主题的完整 TA 流程 |
grounded-coding | 开放编码与类属建构（GT专用） | 需要程序化扎根理论的系统编码与持续比较 |
negative-case-finder | 反例与边界条件识别 | 主题确定后，挑战主题的普遍性 |
analytic-memo | 分析备忘录（AI代写） | 主题审查中产生分析直觉，需要快速记录 |
推荐流程：
thematic-analysis（逐份初始编码 → 汇总编码池 → 候选主题）
↓
negative-case-finder（挑战主题的边界）
↓
analytic-memo（深化核心主题的理论思考）
说明：