| name | ta-research-AFP-auto |
| description | TA（主题分析）研究全流程全自动AFP工作流协调器。无需用户逐步确认，
系统自主完成全部12个检查点，遇到卡点自动处理或跳过，最终输出完稿清单
与决策日志。决策节点（理论定位/叙事结构/标题摘要关键词）依据上下文自动选择
最优方案，所有自动决策均记录在最终报告中供研究者审阅。
与 ta-research-AFP（逐步确认版）互补：偏好全程参与用 AFP，偏好一键完成用本 skill。
触发词："一键完成TA论文""全自动TA研究流程""启动TA自动化工作流"
"自动完成主题分析全流程""TA论文一键生成""不需要我确认，自动跑完"。
注意：不响应泛化触发词（如"启动AFP""自动写论文"），这些词留给其他工作流。
|
TA 研究全流程全自动 AFP 工作流协调器
00. 执行入口（Agent 模式）
当用户触发本 skill 时，立即执行以下 Bash 命令，不自行逐步执行检查点：
python3 ~/.claude/skills/ta-research-AFP-auto/scripts/ta_agent.py --project-dir "$(pwd)"
常用变体：
- 用户说"继续"或"断点续跑"：
python3 ~/.claude/skills/ta-research-AFP-auto/scripts/ta_agent.py --project-dir "$(pwd)" --resume
- 用户说"从第N步继续"（N为检查点编号）：
python3 ~/.claude/skills/ta-research-AFP-auto/scripts/ta_agent.py --project-dir "$(pwd)" --from-cp N
- 用户说"查看进度"：
python3 ~/.claude/skills/ta-research-AFP-auto/scripts/ta_agent.py --project-dir "$(pwd)" --status
脚本自动完成全部12个检查点，将进度输出到终端，产出文件写入项目目录。
所有检查点完成后输出 final_report.md。
注意：本 skill 已升级为 Python agent 模式。底层由 scripts/ta_agent.py 管理状态、
调用 Anthropic API、处理错误、支持断点续跑。以下各检查点说明保留作参考文档。
03. 卡点降级策略（全局）
遇到以下情况时，执行对应降级策略，不中断流程：
| 卡点类型 | 降级策略 |
|---|
| 文件缺失（如无访谈材料） | 跳过该检查点，日志记录"跳过原因：材料缺失" |
| 工具不可用（如 Chrome MCP 离线） | 降级为手动描述模式：输出操作步骤供研究者参考，标注"需手动执行" |
| 引用核查存疑 | 统一标注 ⚠️ 待核实，不删除，不阻断 |
| Skill 调用失败 | 记录错误，跳过该 skill，协调器直接生成简版产出 |
| 信息不足以执行 | 使用合理默认值（见各检查点说明），日志记录默认值选择理由 |
04. 检查点执行规范
每个检查点完成后自动输出：
- HUD 仪表盘
- 执行内容摘要
[🛡️ 自检日志]- 本步决策记录（如有自动决策）
- 自动触发下一检查点（无停止指令）
检查点 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 全文引用核查报告
📝 [研究主题]_初稿.docx 完整论文初稿（Word，各章节按顺序合并）
━━ 自动决策日志 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🤖 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 完成。
产出均为草稿，需研究者基于决策日志审阅修订后使用。
