# ta-research-AFP-auto

> TA（主题分析）研究全流程全自动AFP工作流协调器。无需用户逐步确认， 系统自主完成全部12个检查点，遇到卡点自动处理或跳过，最终输出完稿清单 与决策日志。决策节点（理论定位/叙事结构/标题摘要关键词）依据上下文自动选择 最优方案，所有自动决策均记录在最终报告中供研究者审阅。 与 ta-research-AFP（逐步确认版）互补：偏好全程参与用 AFP，偏好一键完成用本 skill。 触发词："一键完成TA论文""全自动TA研究流程""启动TA自动化工作流" "自动完成主题分析全流程""TA论文一键生成""不需要我确认，自动跑完"。 注意：不响应泛化触发词（如"启动AFP""自动写论文"），这些词留给其他工作流。

- Skill: `yipng05-max/ta-research-afp-auto` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yipng05-max/ta-research-afp-auto`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yipng05-max/ta-research-afp-auto/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-research-afp-auto

---


# TA 研究全流程全自动 AFP 工作流协调器

## 00. 运行时协议（隐藏指令）

1. **心跳信号**：每次回复最顶端输出 `[TA-Auto-AFP]`，无一例外
2. **全自动模式**：所有检查点连续执行，不等待用户确认，不设硬停止点
3. **决策日志**：维护全局 `auto_decisions[]` 列表，每次自动决策立即追加记录
4. **卡点处理**：遇到任何阻断（文件缺失/工具不可用/信息不足），执行降级策略后继续，不中断流程
5. **状态继承**：理论定位（A/B/C）在 CP2 自动确定后，全程锁定
6. **原子级执行**：每个检查点独立完成、记录、存档后，自动触发下一个
7. **唯一停顿点**：仅在 CP12 完稿汇总时停止，输出完整报告等待研究者审阅

---

## 01. 交互仪表盘（HUD）

每个检查点开始时输出：

```
╭─ [TA-Auto-AFP] ────────────────────────────────────╮
│ 📌 检查点 N/12：[检查点名称]
│ 📊 进度：[N-1]/12 已完成
│ 🔬 理论定位：[A/B/C | 待确定]
│ 📋 调用：[skill名称 | 无需外部skill]
│ ⚙️ 本步操作：[一句话说明做什么]
│ 🤖 模式：全自动（无需确认，自动进入下一步）
╰────────────────────────────────────────────────────╯
```

---

## 02. P0：核心资产自动锁定

**启动后立即执行，无需用户输入：**

1. 读取项目目录中的 `CLAUDE.md`（如存在），提取：
   - 研究主题与研究问题
   - 访谈材料路径
   - 目标期刊类型（C刊 / SSCI）
   - 已完成的工作
   - 被访者特征、访谈背景等

2. 输出自动识别结果后，**直接进入检查点 1**，不等待确认：

```
[TA-Auto-AFP] 已启动 · 全自动模式

从 CLAUDE.md 自动识别：
  研究主题：[内容]
  研究问题：[内容]
  访谈材料：[路径 或 未找到→将在CP3询问]
  目标期刊：[C刊/SSCI 或 未找到→默认C刊]
  已完成工作：[内容 或 无]

自动进入检查点 1...
```

若无 `CLAUDE.md`，输出提示后**仍直接启动**，将缺失信息标记为"待补充"，在对应检查点执行时再处理。

---

## 03. 卡点降级策略（全局）

遇到以下情况时，执行对应降级策略，**不中断流程**：

| 卡点类型 | 降级策略 |
|---------|---------|
| 文件缺失（如无访谈材料） | 跳过该检查点，日志记录"跳过原因：材料缺失" |
| 工具不可用（如 Chrome MCP 离线） | 降级为手动描述模式：输出操作步骤供研究者参考，标注"需手动执行" |
| 引用核查存疑 | 统一标注 ⚠️ 待核实，不删除，不阻断 |
| Skill 调用失败 | 记录错误，跳过该 skill，协调器直接生成简版产出 |
| 信息不足以执行 | 使用合理默认值（见各检查点说明），日志记录默认值选择理由 |

---

## 04. 检查点执行规范

每个检查点完成后自动输出：

1. HUD 仪表盘
2. 执行内容摘要
3. `[🛡️ 自检日志]`
4. 本步决策记录（如有自动决策）
5. **自动触发下一检查点**（无停止指令）

---

## 检查点 1：文献检索

**调用**：`cnki-advanced-search` + `foreign-literature-search`（双轨并行）

**自动执行**：
- 基于研究主题自动构建检索词（含同义词扩展）
- 执行中文检索（CSSCI）+ 外文检索（SSCI）
- 生成 WoS/Scopus 布尔检索式

**卡点处理**：
- Chrome MCP 不可用 → 输出知网检索步骤说明（标注"需手动执行"），外文检索照常执行
- 关键词无法确定 → 使用研究问题中的核心名词作为检索词

**产出**：
- `知网检索结果_{关键词}_{日期}.xlsx`
- `外文文献检索_{关键词}_{日期}.xlsx`

```
[🛡️ 自检日志]
□ 中文检索已完成（或标注"需手动执行"）
□ 外文检索已完成，WoS检索式已生成
□ 文献池已建立，自动进入检查点 2
```

---

## 检查点 2：理论框架建构【自动决策节点】

**调用**：`ta-framework-builder`

**自动决策——理论定位（A/B/C）**：

系统根据以下规则自动判断，无需用户选择：

| 判断依据 | 自动选择 |
|---------|---------|
| CLAUDE.md 或研究问题中明确提及特定理论 | **A（理论驱动）** |
| 研究问题以"如何""为什么"等机制性问题为主，且无明确理论 | **C（敏感性概念）** |
| 研究问题以"是什么""有哪些"等描述性问题为主 | **B（经验驱动）** |
| 无法判断 | **默认 C（敏感性概念）**——最灵活，允许涌现 |

自动决策后记录：
```
🤖 自动决策：理论定位 = [A/B/C]
   依据：[判断理由]
   影响：[对后续章节的影响简述]
```

**产出**：`framework_[研究主题].md`

```
[🛡️ 自检日志]
□ 理论定位已自动确定并锁定
□ 框架文档已生成
□ 自动进入检查点 3
```

---

## 检查点 3：主题分析编码

**调用**：`thematic-analysis`

**自动执行**：
- 读取项目目录中的访谈文件，逐份编码
- 编码完成后自动进入主题识别与命名
- 主题命名由系统提出，**自动采用描述性命名**（贴近数据语言，不强行理论化）

**卡点处理**：
- 无访谈文件 → 跳过本检查点，日志记录，在 CP12 报告中提示研究者补充后重跑
- 访谈文件格式无法读取 → 提示文件路径，请研究者在 CP12 后手动执行

**产出**：`coding_[被访者].md` × N + `themes_[研究主题].md`

```
[🛡️ 自检日志]
□ 编码文件已全部保存
□ 主题汇总表已保存至 themes_[研究主题].md
□ 自动进入检查点 4
```

---

## 检查点 4：文献综述写作 + 引用核查

**调用**：`literature-review-writer` → `literature-verifier`（全量核查）

**自动执行**：
- 先执行全量引用核查（建立基线）
- 存疑引用统一标注 ⚠️，不删除，不阻断
- 基于核实文献池生成综述全文

**产出**：`literature_review.md` + 引用核查报告

```
[🛡️ 自检日志]
□ 全量引用核查已完成，存疑项已标注
□ 综述已生成，研究空白已导出
□ 自动进入检查点 5
```

---

## 检查点 5：研究方法章节写作

**调用**：`ta-methods-writer`

**自动执行**：
- 自动读取 `coding_*.md` 和 `framework_*.md`
- 无法推断的信息使用以下默认值：
  - 访谈形式：半结构化深度访谈
  - 抽样策略：目的性抽样
  - 数据收集时间：根据文件创建时间推断，无法推断则填"[待补充]"

**产出**：`methods.md`

```
[🛡️ 自检日志]
□ 已从项目文件自动提取已知信息
□ 无法推断项已使用默认值并标注
□ 自动进入检查点 6
```

---

## 检查点 6：引言写作

**调用**：`introduction-writer` → `literature-verifier`（增量）

**自动执行**：
- 自动导入研究问题、研究背景、综述研究空白
- 增量核查本章新引入引用

**产出**：`introduction.md`

```
[🛡️ 自检日志]
□ 引言已生成，开头无套话
□ 本章新引用已增量核查
□ 自动进入检查点 7
```

---

## 检查点 7：理论框架章节写作

**调用**：`ta-framework-writer` → `literature-verifier`（增量）

**自动执行**：
- 导入 `framework_[主题].md`，按锁定的理论定位（A/B/C）生成对应章节
- 增量核查本章新引入理论文献

**产出**：`framework_section_[A/B/C].md`

```
[🛡️ 自检日志]
□ 章节形态与理论定位一致
□ 本章新引用已增量核查
□ 自动进入检查点 8
```

---

## 检查点 8：研究发现写作【自动决策节点】

**调用**：`ta-findings-writer`

**自动决策——叙事结构**：

系统读取 `themes_[研究主题].md`，分析主题关系后自动判断：

| 主题关系 | 自动选择 |
|---------|---------|
| 各主题相互独立，无明显逻辑先后 | **并列型** |
| 主题间存在因果链、递进逻辑或对立张力 | **串联型** |
| 无法判断 | **默认并列型**——结构清晰，风险最低 |

自动决策后记录：
```
🤖 自动决策：叙事结构 = [并列型/串联型]
   依据：[主题关系分析]
```

**产出**：`findings.md`

```
[🛡️ 自检日志]
□ 叙事结构已自动确定并贯穿全章
□ 每条引语后有实质性分析
□ 自动进入检查点 9
```

---

## 检查点 9：讨论与结论写作

**调用**：`ta-discussion-writer` → `literature-verifier`（增量）

**自动执行**：
- 按锁定的理论定位（A/B/C）分配讨论章节理论工作
- 增量核查本章新引入引用（讨论章节为高风险区）

**产出**：`discussion.md`

```
[🛡️ 自检日志]
□ 理论对话指向具体概念
□ 本章新引用已增量核查
□ 自动进入检查点 10
```

---

## 检查点 10：标题 / 摘要 / 关键词【自动决策节点】

**调用**：`paper-title-abstract-keywords`

**自动决策规则**：

| 项目 | 自动选择 | 依据 |
|------|---------|------|
| 标题 | **现象聚焦型**（A型） | 适配性最广，C刊/SSCI均可 |
| 摘要 | **标准顺序结构**（版本A） | C刊首选；SSCI也适用 |
| 关键词 | **议题检索型**（方案甲） | 提升被同领域研究者引用的概率 |

若目标期刊为 SSCI，调整为：
- 标题：**理论对话型**（B型）
- 摘要：**贡献前置结构**（版本B）
- 关键词：**理论+方法型**（方案乙）

自动决策后记录：
```
🤖 自动决策：标题=[A/B型] 摘要=[版本A/B] 关键词=[甲/乙]
   依据：目标期刊=[C刊/SSCI]
```

**产出**：`title_abstract_keywords.md`

```
[🛡️ 自检日志]
□ 标题/摘要/关键词已按期刊类型自动选定
□ 三者内容一致，无矛盾
□ 自动进入检查点 11
```

---

## 检查点 11：全文引用核查

**调用**：`literature-verifier`（最终综合）

**自动执行**：
- 扫描全部已生成文件，进行最终综合核查
- 存疑引用统一标注，生成核查报告
- **不等待处理**，直接进入 CP12

**产出**：`引用核查报告_final.md`

```
[🛡️ 自检日志]
□ 全文引用已扫描
□ 核查报告已生成，存疑项已标注
□ 自动进入检查点 12
```

---

## 检查点 12：完稿汇总与决策报告

**协调器直接执行，唯一停止点**

输出完整报告：

```
╭────────────────────────────────────────────────────────╮
│ [TA-Auto-AFP] 全自动流程已完成 ✅
╰────────────────────────────────────────────────────────╯

━━ 已生成文件 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📄 literature_review.md          文献综述
📄 framework_[主题].md           理论框架建构文档
📄 framework_section_[A/B/C].md  理论框架章节
📄 introduction.md               引言
📄 methods.md                    研究方法
📄 coding_[被访者].md × N        编码文件
📄 themes_[研究主题].md          主题汇总表
📄 findings.md                   研究发现
📄 discussion.md                 讨论与结论
📄 title_abstract_keywords.md    标题/摘要/关键词
📄 引用核查报告_final.md         全文引用核查报告

━━ 自动决策日志 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🤖 CP2 理论定位：[A/B/C] — [判断依据]
🤖 CP8 叙事结构：[并列/串联] — [判断依据]
🤖 CP10 标题型：[类型] — 依据目标期刊 [C刊/SSCI]
🤖 CP10 摘要结构：[版本] — 依据目标期刊 [C刊/SSCI]
🤖 CP10 关键词方案：[甲/乙] — 依据目标期刊 [C刊/SSCI]

━━ 跳过 / 降级记录 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[如有跳过或降级，列出原因；无则显示"无"]

━━ 建议研究者重点审阅 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ 引用核查报告中的存疑项（见引用核查报告_final.md）
⚠️ 主题命名（见 themes_[研究主题].md）——命名权归研究者
⚠️ 自动决策的理论定位是否符合你的研究意图
⚠️ methods.md 中标注"[待补充]"的信息

━━ 论文章节装配清单 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
一、引言 → introduction.md
二、文献综述 → literature_review.md
三、理论框架 → framework_section_[A/B/C].md
    ↳ A定位：独立章节，放在方法论之前
    ↳ B/C定位：嵌入研究方法章节
四、研究方法 → methods.md
五、研究发现 → findings.md
六、讨论与结论 → discussion.md
论文信息 → title_abstract_keywords.md
```

**如需修改任何检查点的产出，可调用对应的专项 skill 重新执行该步骤。**

---

## 05. 流程说明

**本 skill 与 `ta-research-AFP` 的核心区别**：

| | ta-research-AFP | ta-research-AFP-auto |
|--|--|--|
| 用户介入 | 每步确认 | 仅 CP12 审阅 |
| 决策节点 | 用户选择 | 系统自动判断 |
| 卡点处理 | 等待用户 | 降级后继续 |
| 适合场景 | 研究者全程参与 | 快速生成草稿 |

**本 skill 是协调器，不做分析和写作工作。**
所有实际工作由对应的专项 skill 完成。
产出均为**草稿**，需研究者基于决策日志审阅修订后使用。