twelve-week-study

name	twelve-week-study
description	12课研究法。将任意研究课题、事件、理论、故事、人物或现象转化为12周本科课程大纲和多语言关键词，并在用户确认后生成关键词深度阐述文档。适用于用户要求“12课研究”“twelve-week-study”“课程研究法”“用12课方法研究XXX”或“用课程法研究XXX”的场景。

Skill: twelve-week-study（12课研究法）

触发词

• 12课研究
• twelve-week-study
• 课程研究法
• 用户说"帮我用12课方法研究XXX"或"用课程法研究XXX"

功能描述

将任意研究课题（事件、理论、故事、人物、现象等）转化为：

1. 12周本科课程大纲 + 多语言关键词（Step 1）
2. 50个关键词的深度阐述文档（Step 2，用户确认后执行）

所有输出以 .md 格式存入用户 Vault Inbox 的项目文件夹。

Vault Inbox 路径

/Users/pixies/Library/Mobile Documents/iCloud~md~obsidian/Documents/Mydoc/Inbox

项目文件夹命名：研究_XXXX（XXXX 为课题名称）

---

Step 1：课程大纲与关键词

执行流程

1. 接收课题：用户输入研究课题
2. ⛔ 强制询问关键词语言：必须向用户确认需要哪些语言，不得根据上下文或已有文件自行推断。不收到用户明确回答，不得开始生成。默认不存在，每次都必须问。
3. 生成内容：
   • 12周本科课程大纲（每周主题、核心问题、学习目标）
   • 按大纲章节归类的关键词，每种语言50个
   • 每个关键词自动标注类型（见类型系统）
4. 存储：创建 研究_XXXX/ 文件夹，存入 00_大纲与关键词.md
5. ⛔ 强制确认 Step 2：Step 1 存档后，必须向用户明确询问"是否进入 Step 2 深度阐述"，等待用户回复，不得自动继续。

输出格式（00_大纲与关键词.md）

# 研究课题：XXXX

## 课程概述
[一段简介，说明本课程的研究视角和目标]

## 12周课程大纲

### 第1周：[主题]
**核心问题**：...
**学习目标**：...

### 第2周：[主题]
...（共12周）

---

## 关键词表

### 中文关键词（50个）

| # | 关键词 | 类型 | 所属章节 |
|---|--------|------|---------|
| 1 | ... | 学科/领域 | 第1周 |
...

### English Keywords（50个）

| # | Keyword | Type | Week |
|---|---------|------|------|
| 1 | ... | Theory/Model | Week 1 |
...

---

Step 2：关键词深度阐述

关键词类型系统与阐述模板

Step 2 按关键词类型分7个文件批量生成，每词约1000字。

类型1：学科/领域

判断：如"认知科学"、"行为经济学"、"量子力学" 阐述角度：

1. 学科定义与研究边界
2. 发展简史（起源、重要节点、当前状态）
3. 核心研究方向（3-5个子领域）
4. 代表性理论与模型
5. 必读书籍与论文（5-8部，含作者、年份、简介）
6. 与本研究课题的具体关系

类型2：理论/模型

判断：如"进化博弈论"、"依恋理论"、"相对论" 阐述角度：

1. 理论核心主张（用最简洁的语言表述）
2. 提出背景（时代背景、问题缘起）与提出者
3. 关键概念拆解（理论内部的核心术语）
4. 支持证据与反驳质疑
5. 实际应用领域
6. 与本研究课题的具体关系

类型3：概念/术语

判断：如"认知失调"、"涌现"、"范式转移" 阐述角度：

1. 精确定义（学术定义 + 通俗解释）
2. 概念来源与演变历史
3. 易混淆概念辨析（至少列出2个相关概念对比）
4. 典型案例或应用实例
5. 在本研究课题中的具体作用

类型4：历史事件

判断：如"图灵测试"、"大萧条"、"文化大革命" 阐述角度：

1. 事件背景（时代、地点、相关方）
2. 事件经过（关键时间线）
3. 直接影响与后果
4. 历史评价与争议
5. 与本研究课题的具体关系

类型5：人物

判断：如"弗洛伊德"、"香农"、"卡尔·马克思" 阐述角度：

1. 基本背景（出生地、时代、教育经历）
2. 核心学术/职业贡献（按重要性排列）
3. 代表作品（含简介）
4. 与本研究课题直接相关的故事、成就或影响
5. 争议与再评价（后世如何看待此人）

类型6：机构/组织

判断：如"兰德公司"、"WHO"、"联合国" 阐述角度：

1. 性质与成立背景
2. 核心职能与运作方式
3. 重要历史时刻或决策
4. 在本研究课题中的角色与影响

类型7：方法/工具

判断：如"元分析"、"随机对照实验"、"田野调查" 阐述角度：

1. 方法原理（如何操作）
2. 适用场景与使用条件
3. 优势与局限性
4. 代表性研究案例
5. 在本研究课题中的应用方式

---

Step 2 输出文件结构

研究_XXXX/
├── 00_大纲与关键词.md
├── 01_学科领域.md
├── 02_理论模型.md
├── 03_概念术语.md
├── 04_历史事件.md
├── 05_人物.md
├── 06_机构组织.md
└── 07_方法工具.md

每个文件格式：

# [课题] - [类型] 关键词阐述

---

## [关键词名称]
**类型**：学科/领域
**所属章节**：第X周

[约1000字阐述，按对应类型模板展开]

---

## [下一个关键词]
...

---

Step 2 Review（质检环节）

Step 2 所有文件生成完毕后，必须执行以下质检流程，不可跳过。

质检步骤

1. 统计关键词数量：从 00_大纲与关键词.md 中读取中文关键词表，统计实际数量（目标：50个）
2. 统计已阐述词条数量：统计 01_ 至 07_ 7个文件中实际包含的 ## 级标题总数
3. 比对差异：已阐述数量 是否等于 中文关键词数量？
4. 识别缺失词条：逐一核对中文关键词列表，找出在7个文件中没有对应 ## 标题的词条
5. 补全缺失词条：按对应类型的阐述模板，将缺失词条追加写入对应文件（使用 edit 工具 append）
6. 输出质检报告：向用户汇报：
   • 关键词总数
   • 初次生成覆盖数
   • 补全数量
   • 最终覆盖数（应等于关键词总数）

质检报告格式

✅ Step 2 质检完成

关键词总数：50
初次生成覆盖：XX 个
本次补全：XX 个
最终覆盖：50/50 ✅

若最终覆盖仍不足50，列出仍缺失的词条，并再次补全，直到覆盖数 = 关键词数量为止。

---

执行规则

1. ⛔ Step 1 开始前：必须向用户询问并获得明确回复，确认所需关键词语言。不得以任何理由（上下文推断、参照已有文件、默认值）跳过此步骤。
2. ⛔ Step 1 结束时：必须向用户发出明确询问，等待用户回复"继续"或等效确认后，才可开始 Step 2。
3. Step 2 触发条件：用户明确确认"继续"或"开始第二步"
4. 批量生成：Step 2 的7个文件一次性全部生成，不逐词交互
5. ⛔ Step 2 Review 强制执行：7个文件写入完毕后，必须立即执行质检（见 Step 2 Review 章节），不等待用户指令，不可跳过，不可推迟。
6. 文件写入：使用 write 工具写入 Vault Inbox，路径见上方
7. 关键词不足某类型：若某类型关键词为0，跳过对应文件
8. 语言：生成内容的语言跟随用户界面语言（默认中文），关键词本身保留原语言

---

示例调用

用户说：用12课研究法研究"博弈论"

执行流程：

1. 确认语言（中文 + 英文？）
2. 生成12周大纲 + 关键词 → 存入 研究_博弈论/00_大纲与关键词.md
3. 询问："Step 1 完成，是否继续深度阐述？"
4. 用户确认后 → 批量生成7类文件 → 全部存入 研究_博弈论/