# Ta Findings Writer

> TA（主题分析）研究发现章节写作工具。将主题分析的主题汇总表转化为发现叙事， 根据理论定位（A/B/C）和叙事结构（并列/串联）生成每个主题的完整分析段落， 引语服务于分析，不堆砌。 当用户需要撰写研究发现章节，或在 ta-research-workflow 中到达"研究发现写作"检查点时触发。

- Skill: `yipng05-max/ta-findings-writer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yipng05-max/ta-findings-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yipng05-max/ta-findings-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: yipng05-max (https://skillmd.com/u/yipng05-max)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yipng05-max/ta-findings-writer

---


# TA 研究发现章节写作

将主题分析的主题汇总表转化为论文发现章节。核心原则：
**每条引语都必须有研究者声音的解释，引语是证据，不是结论本身。**

## 启动：收集必要信息

启动时收集（在 ta-research-workflow 中已有的信息自动复用）：

1. **主题汇总表**：主题名称、核心含义、代表性引语（来自 `thematic-analysis` 输出，或研究者提供）
2. **研究问题**
3. **理论定位**（A/B/C）——若在工作流中已确认，自动沿用
4. **主题关系**（可选）：主题间是并列/递进/因果/对立关系？
5. **可选**：理论框架摘要（A 或 C 定位时需要）

---

## 第一步：确认理论定位对发现章节的影响

根据理论定位，明确告知研究者发现章节的写作取向：

**A（理论驱动）**
- 每个主题的阐释段落需明确呼应理论概念
- 主题命名本身可以使用理论术语
- 发现章节承担一部分理论诠释工作

**B（经验驱动）**
- 发现章节保持资料近端语言，尽量用被访者的语言世界
- 理论对话全部留给讨论章节
- 此处的任务是"让资料说话"，而非"让理论说话"

**C（敏感性概念）**
- 主题命名可借用理论术语，但阐释以现象描述为主
- 适度渗透理论语言，但不过度解释
- 理论在发现章节隐而不显，在讨论章节深化

---

## 第二步：确认叙事结构

skill 根据主题关系自动判断推荐结构，并提供选项让研究者确认：

**主题并列型**（推荐条件：各主题相互独立，没有明显的逻辑先后）
- 每个主题独立成一个小节
- 小节结构相同：主题阐释 → 引语证据 → 分析解释
- 小节间用简短过渡句衔接

**主题串联型**（推荐条件：主题间有因果链、递进逻辑、或对立张力）
- 沿逻辑线展开：条件 → 过程 → 结果，或张力 → 应对 → 后果
- 每个主题是叙事链条的一个节点
- 节点之间有明确的承接关系（"在X的背景下，行动者进一步……"）

---

## 第三步：逐主题写作

对每个主题，按以下单元依次写作：

### 单元 1：主题阐释（1段，必须有）

说明这个主题捕捉了什么现象或机制，为什么值得单独成为一个主题。

写作要求：
- 不是对主题名称的翻译（"'适应性策略'这个主题是指……"）
- 而是对现象的诠释（"在数据中，受访者反复呈现出一种……的模式，这一模式的核心在于……"）
- A 定位：在阐释中点明与哪个理论概念的关联
- B 定位：以现象描述为主，不过度理论化
- C 定位：可以用理论透镜"照亮"现象，但以现象描述为基础

### 单元 2：引语证据（2–3条，必须有）

选取最能说明主题含义的代表性引语，每条引语配一段分析性解释。

**引语呈现格式**：
> "受访者原话" （受访者编号/匿名代码，如：访谈A，2023年）

**引语后的分析解释**（必须有，不可跳过）：
- 这段话说明了什么？它如何支持主题的核心含义？
- 注意这段话中哪个词、哪个表述最有分析价值？为什么？
- A 定位：这段话如何与理论概念对话？
- B/C 定位：这段话揭示了什么行动逻辑或意义系统？

**禁止行为**：
- 连续放置多条引语，没有分析解释（"引语堆砌"）
- 引语之后只写一句泛泛的总结（"以上说明了……"）
- 用引语作为主题阐释的替代（引语只能是证据，不能是论点本身）

### 单元 3：主题内部张力或变体（可选，有则写）

如果数据中存在同一主题内的分歧、例外或类型差异：
- 呈现差异，说明它属于同一主题的不同表现（而非反例）
- 简短处理，1–2段，不展开为独立主题

### 单元 4：承接句（串联型叙事时使用）

末尾写一句将本主题与下一主题连接的过渡句，说明两者的逻辑关系。

---

## 第四步：发现章节整体检查

所有主题写完后，进行整体检查：

1. **引语/分析比例**：每条引语后是否都有实质性分析？（禁止1:0，即只有引语没有分析）
2. **主题命名一致性**：主题名称在全文是否使用同一术语，没有随意替换？
3. **理论定位一致性**：各主题的阐释深度和语言风格是否符合选定的 A/B/C 定位？
4. **结构清晰性**：读者能否从小节标题和主题阐释段落清楚理解每个主题的含义？

---

## 输出与保存

写作完成后，调用 Write 工具保存：

文件命名：`findings.md`
保存路径：当前项目目录

告知研究者：
> "研究发现章节已保存至 `findings.md`（[字数]字，共[N]个主题）。
> 如在 ta-research-workflow 中，请继续下一检查点（讨论写作）。"

## 语言

- 默认中文
- 引语原文保持原样，不翻译、不改写
- 学术写作风格：书面化、精确、避免口语化