| 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"
功能描述
将任意研究课题（事件、理论、故事、人物、现象等）转化为：
- 12周本科课程大纲 + 多语言关键词（Step 1）
- 50个关键词的深度阐述文档（Step 2，用户确认后执行）
所有输出以 .md 格式存入用户 Vault Inbox 的项目文件夹。
Vault Inbox 路径
/Users/pixies/Library/Mobile Documents/iCloud~md~obsidian/Documents/Mydoc/Inbox
项目文件夹命名：研究_XXXX（XXXX 为课题名称）
Step 1：课程大纲与关键词
执行流程
- 接收课题：用户输入研究课题
- ⛔ 强制询问关键词语言：必须向用户确认需要哪些语言，不得根据上下文或已有文件自行推断。不收到用户明确回答，不得开始生成。默认不存在，每次都必须问。
- 生成内容：
- 12周本科课程大纲（每周主题、核心问题、学习目标）
- 按大纲章节归类的关键词，每种语言50个
- 每个关键词自动标注类型（见类型系统）
- 存储：创建
研究_XXXX/ 文件夹，存入 00_大纲与关键词.md
- ⛔ 强制确认 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：学科/领域
判断：如"认知科学"、"行为经济学"、"量子力学"
阐述角度：
- 学科定义与研究边界
- 发展简史（起源、重要节点、当前状态）
- 核心研究方向（3-5个子领域）
- 代表性理论与模型
- 必读书籍与论文（5-8部，含作者、年份、简介）
- 与本研究课题的具体关系
类型2：理论/模型
判断：如"进化博弈论"、"依恋理论"、"相对论"
阐述角度：
- 理论核心主张（用最简洁的语言表述）
- 提出背景（时代背景、问题缘起）与提出者
- 关键概念拆解（理论内部的核心术语）
- 支持证据与反驳质疑
- 实际应用领域
- 与本研究课题的具体关系
类型3：概念/术语
判断：如"认知失调"、"涌现"、"范式转移"
阐述角度：
- 精确定义（学术定义 + 通俗解释）
- 概念来源与演变历史
- 易混淆概念辨析（至少列出2个相关概念对比）
- 典型案例或应用实例
- 在本研究课题中的具体作用
类型4：历史事件
判断：如"图灵测试"、"大萧条"、"文化大革命"
阐述角度：
- 事件背景（时代、地点、相关方）
- 事件经过（关键时间线）
- 直接影响与后果
- 历史评价与争议
- 与本研究课题的具体关系
类型5：人物
判断：如"弗洛伊德"、"香农"、"卡尔·马克思"
阐述角度：
- 基本背景（出生地、时代、教育经历）
- 核心学术/职业贡献（按重要性排列）
- 代表作品（含简介）
- 与本研究课题直接相关的故事、成就或影响
- 争议与再评价（后世如何看待此人）
类型6：机构/组织
判断：如"兰德公司"、"WHO"、"联合国"
阐述角度：
- 性质与成立背景
- 核心职能与运作方式
- 重要历史时刻或决策
- 在本研究课题中的角色与影响
类型7：方法/工具
判断：如"元分析"、"随机对照实验"、"田野调查"
阐述角度：
- 方法原理（如何操作）
- 适用场景与使用条件
- 优势与局限性
- 代表性研究案例
- 在本研究课题中的应用方式
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 所有文件生成完毕后，必须执行以下质检流程，不可跳过。
质检步骤
- 统计关键词数量：从
00_大纲与关键词.md 中读取中文关键词表，统计实际数量（目标：50个）
- 统计已阐述词条数量：统计
01_ 至 07_ 7个文件中实际包含的 ## 级标题总数
- 比对差异：
已阐述数量 是否等于 中文关键词数量？
- 识别缺失词条：逐一核对中文关键词列表，找出在7个文件中没有对应
## 标题的词条
- 补全缺失词条：按对应类型的阐述模板，将缺失词条追加写入对应文件（使用
edit 工具 append）
- 输出质检报告：向用户汇报：
- 关键词总数
- 初次生成覆盖数
- 补全数量
- 最终覆盖数（应等于关键词总数）
质检报告格式
✅ Step 2 质检完成
关键词总数：50
初次生成覆盖：XX 个
本次补全：XX 个
最终覆盖：50/50 ✅
若最终覆盖仍不足50，列出仍缺失的词条，并再次补全，直到覆盖数 = 关键词数量为止。
执行规则
- ⛔ Step 1 开始前：必须向用户询问并获得明确回复，确认所需关键词语言。不得以任何理由（上下文推断、参照已有文件、默认值）跳过此步骤。
- ⛔ Step 1 结束时：必须向用户发出明确询问，等待用户回复"继续"或等效确认后，才可开始 Step 2。
- Step 2 触发条件：用户明确确认"继续"或"开始第二步"
- 批量生成：Step 2 的7个文件一次性全部生成，不逐词交互
- ⛔ Step 2 Review 强制执行：7个文件写入完毕后，必须立即执行质检（见 Step 2 Review 章节），不等待用户指令，不可跳过，不可推迟。
- 文件写入：使用
write 工具写入 Vault Inbox，路径见上方
- 关键词不足某类型：若某类型关键词为0，跳过对应文件
- 语言：生成内容的语言跟随用户界面语言（默认中文），关键词本身保留原语言
示例调用
用户说：用12课研究法研究"博弈论"
执行流程：
- 确认语言（中文 + 英文？）
- 生成12周大纲 + 关键词 → 存入
研究_博弈论/00_大纲与关键词.md
- 询问："Step 1 完成，是否继续深度阐述？"
- 用户确认后 → 批量生成7类文件 → 全部存入
研究_博弈论/
