TA(主题分析)研究全流程全自动AFP工作流协调器。无需用户逐步确认, 系统自主完成全部12个检查点,遇到卡点自动处理或跳过,最终输出完稿清单 与决策日志。决策节点(理论定位/叙事结构/标题摘要关键词)依据上下文自动选择 最优方案,所有自动决策均记录在最终报告中供研究者审阅。 与 ta-research-AFP(逐步确认版)互补:偏好全程参与用 AFP,偏好一键完成用本 skill。 触发词:"一键完成TA论文""全自动TA研究流程""启动TA自动化工作流" "自动完成主题分析全流程""TA论文一键生成""不需要我确认,自动跑完"。 注意:不响应泛化触发词(如"启动AFP""自动写论文"),这些词留给其他工作流。
当用户触发本 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
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、处理错误、支持断点续跑。以下各检查点说明保留作参考文档。
遇到以下情况时,执行对应降级策略,不中断流程:
| 卡点类型 | 降级策略 |
|---|---|
| 文件缺失(如无访谈材料) | 跳过该检查点,日志记录"跳过原因:材料缺失" |
| 工具不可用(如 Chrome MCP 离线) | 降级为手动描述模式:输出操作步骤供研究者参考,标注"需手动执行" |
| 引用核查存疑 | 统一标注 ⚠️ 待核实,不删除,不阻断 |
| Skill 调用失败 | 记录错误,跳过该 skill,协调器直接生成简版产出 |
| 信息不足以执行 | 使用合理默认值(见各检查点说明),日志记录默认值选择理由 |
每个检查点完成后自动输出:
[🛡️ 自检日志]调用:cnki-advanced-search + foreign-literature-search(双轨并行)
自动执行:
卡点处理:
产出:
知网检索结果_{关键词}_{日期}.xlsx外文文献检索_{关键词}_{日期}.xlsx[🛡️ 自检日志]
□ 中文检索已完成(或标注"需手动执行")
□ 外文检索已完成,WoS检索式已生成
□ 文献池已建立,自动进入检查点 2
调用:ta-framework-builder
自动决策——理论定位(A/B/C):
系统根据以下规则自动判断,无需用户选择:
| 判断依据 | 自动选择 |
|---|---|
| CLAUDE.md 或研究问题中明确提及特定理论 | A(理论驱动) |
| 研究问题以"如何""为什么"等机制性问题为主,且无明确理论 | C(敏感性概念) |
| 研究问题以"是什么""有哪些"等描述性问题为主 | B(经验驱动) |
| 无法判断 | 默认 C(敏感性概念)——最灵活,允许涌现 |
自动决策后记录:
🤖 自动决策:理论定位 = [A/B/C]
依据:[判断理由]
影响:[对后续章节的影响简述]
产出:framework_[研究主题].md
[🛡️ 自检日志]
□ 理论定位已自动确定并锁定
□ 框架文档已生成
□ 自动进入检查点 3
调用:thematic-analysis
自动执行:
卡点处理:
产出:coding_[被访者].md × N + themes_[研究主题].md
[🛡️ 自检日志]
□ 编码文件已全部保存
□ 主题汇总表已保存至 themes_[研究主题].md
□ 自动进入检查点 4
调用:literature-review-writer → literature-verifier(全量核查)
自动执行:
产出:literature_review.md + 引用核查报告
[🛡️ 自检日志]
□ 全量引用核查已完成,存疑项已标注
□ 综述已生成,研究空白已导出
□ 自动进入检查点 5
调用:ta-methods-writer
自动执行:
coding_*.md 和 framework_*.md产出:methods.md
[🛡️ 自检日志]
□ 已从项目文件自动提取已知信息
□ 无法推断项已使用默认值并标注
□ 自动进入检查点 6
调用:introduction-writer → literature-verifier(增量)
自动执行:
产出:introduction.md
[🛡️ 自检日志]
□ 引言已生成,开头无套话
□ 本章新引用已增量核查
□ 自动进入检查点 7
调用:ta-framework-writer → literature-verifier(增量)
自动执行:
framework_[主题].md,按锁定的理论定位(A/B/C)生成对应章节产出:framework_section_[A/B/C].md
[🛡️ 自检日志]
□ 章节形态与理论定位一致
□ 本章新引用已增量核查
□ 自动进入检查点 8
调用:ta-findings-writer
自动决策——叙事结构:
系统读取 themes_[研究主题].md,分析主题关系后自动判断:
| 主题关系 | 自动选择 |
|---|---|
| 各主题相互独立,无明显逻辑先后 | 并列型 |
| 主题间存在因果链、递进逻辑或对立张力 | 串联型 |
| 无法判断 | 默认并列型——结构清晰,风险最低 |
自动决策后记录:
🤖 自动决策:叙事结构 = [并列型/串联型]
依据:[主题关系分析]
产出:findings.md
[🛡️ 自检日志]
□ 叙事结构已自动确定并贯穿全章
□ 每条引语后有实质性分析
□ 自动进入检查点 9
调用:ta-discussion-writer → literature-verifier(增量)
自动执行:
产出:discussion.md
[🛡️ 自检日志]
□ 理论对话指向具体概念
□ 本章新引用已增量核查
□ 自动进入检查点 10
调用:paper-title-abstract-keywords
自动决策规则:
| 项目 | 自动选择 | 依据 |
|---|---|---|
| 标题 | 现象聚焦型(A型) | 适配性最广,C刊/SSCI均可 |
| 摘要 | 标准顺序结构(版本A) | C刊首选;SSCI也适用 |
| 关键词 | 议题检索型(方案甲) | 提升被同领域研究者引用的概率 |
若目标期刊为 SSCI,调整为:
自动决策后记录:
🤖 自动决策:标题=[A/B型] 摘要=[版本A/B] 关键词=[甲/乙]
依据:目标期刊=[C刊/SSCI]
产出:title_abstract_keywords.md
[🛡️ 自检日志]
□ 标题/摘要/关键词已按期刊类型自动选定
□ 三者内容一致,无矛盾
□ 自动进入检查点 11
调用:literature-verifier(最终综合)
自动执行:
产出:引用核查报告_final.md
[🛡️ 自检日志]
□ 全文引用已扫描
□ 核查报告已生成,存疑项已标注
□ 自动进入检查点 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 重新执行该步骤。
本 skill 与 ta-research-AFP 的核心区别:
| ta-research-AFP | ta-research-AFP-auto | |
|---|---|---|
| 用户介入 | 每步确认 | 仅 CP12 审阅 |
| 决策节点 | 用户选择 | 系统自动判断 |
| 卡点处理 | 等待用户 | 降级后继续 |
| 适合场景 | 研究者全程参与 | 快速生成草稿 |
本 skill 是协调器,不做分析和写作工作。 所有实际工作由对应的专项 skill 完成。 产出均为草稿,需研究者基于决策日志审阅修订后使用。