# Twelve Week Study

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

- Skill: `pixiesgeosun/twelve-week-study` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pixiesgeosun/twelve-week-study`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pixiesgeosun/twelve-week-study/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: pixiesgeosun (https://skillmd.com/u/pixiesgeosun)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/pixiesgeosun/twelve-week-study

---


# 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`）

```markdown
# 研究课题：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
```

每个文件格式：
```markdown
# [课题] - [类型] 关键词阐述

---

## [关键词名称]
**类型**：学科/领域
**所属章节**：第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 触发条件**：用户明确确认"继续"或"开始第二步"
3. **批量生成**：Step 2 的7个文件一次性全部生成，不逐词交互
4. **⛔ Step 2 Review 强制执行**：7个文件写入完毕后，必须立即执行质检（见 Step 2 Review 章节），不等待用户指令，不可跳过，不可推迟。
5. **文件写入**：使用 `write` 工具写入 Vault Inbox，路径见上方
6. **关键词不足某类型**：若某类型关键词为0，跳过对应文件
7. **语言**：生成内容的语言跟随用户界面语言（默认中文），关键词本身保留原语言

---

## 示例调用

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

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