Yipng05 Max Skills Skills

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. 卡点降级策略（全局）

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

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）：

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

自动决策后记录：

🤖 自动决策：理论定位 = [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

自动决策规则：

若目标期刊为 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 的核心区别：

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

Source: yipng05-max/-skills — distributed by TomeVault.