kaoyan-english-vocab

name	kaoyan-english-vocab
description	This skill handles vocabulary organization and word lookup for 考研英语 (Chinese graduate entrance English exam). Use it when users want to extract vocabulary from PDF exports (墨墨/百词斩), generate real exam context articles, detect polysemy (rare word meanings), look up word information, or organize vocabulary cards.
version	1.0.0

考研英语词汇整理技能 (Kaoyan English Vocab)

📁 详细代码实现见 code.md

技能概述

本技能专注于考研英语词汇的整理和查询，帮助用户：

1. PDF词汇提取：从单词APP（墨墨/百词斩等）导出的PDF中提取词汇
2. 词汇分类：自动识别重点词汇、僻义词、一般词汇
3. 熟词僻义检测：识别考研中的僻义陷阱并预警
4. 快速查词：查询单词信息（含僻义预警）
5. 真题语境文章生成：将目标词汇串联成真题风格的语境文章

核心特色：

• ⚠️ 僻义预警系统（Critical/Warning级别）
• 优先使用真题语境，非AI生成文章
• 自动生成结构化词汇卡片

---

触发条件

触发此技能当：

词汇整理相关：

• "整理考研英语单词" + 提供PDF/单词表
• "生成考研英语复习文章"
• "从PDF提取单词"
• "墨墨背单词导出"
• "百词斩导出"
• "真题语境文章"
• "外刊风格"
• "生成词汇表"
• "处理单词表" + 提供单词表文件
• "格式化单词"
• "分类单词"

查词相关：

• "查单词"（在考研语境下）
• "查询单词"
• "word lookup" + 单词
• 单词 + "什么意思"（考研语境）

僻义相关：

• "熟词僻义"
• "僻义词"
• "陷阱词"
• "考研陷阱"
• "一词多义"

不触发此技能当：

• 生成复习计划 → 使用 kaoyan-english-review
• 单词测试 → 使用 kaoyan-english-quiz
• 写作训练 → 使用 kaoyan-english-writing

---

核心功能

⚠️ 执行顺序（重要！）

当用户提供单词表时，必须按以下顺序执行：

[用户提供单词表]
      ↓
[步骤0: 整理和格式化原始单词表] ← 必须首先执行！
      ↓
[步骤1: 检测熟词僻义]
      ↓
[步骤2: 生成四类学习笔记]

功能0: 整理和格式化单词表（必须步骤）⚠️

输入: 用户提供的原始单词表（可能是从PDF/图片转换，格式混乱）

处理流程:

1. 格式统一化：

   • 统一标题格式：#### 单词名 ⭐⭐⭐（含考研频率标记）
   • 清理多余符号：省略号统一为 ...，去除多余空格
   • 修复截断的释义
   • 统一分隔符为 ---

2. 添加记忆方法（必须！）：

   • 🧠 词根词缀法：如 conscience = con-(加强) + sci(知道) + -ence
   • 联想记忆法：如 bleak → break → 破碎的希望
   • 谐音记忆法：如 consult = "看搜" → 看了再搜
   • 使用 > 🧠 **记忆方法** callout 格式

3. 补充词组搭配：

   • 每个单词至少提供2-3个常用搭配
   • 使用表格格式：| 词组搭配 | 释义 |

4. 按词族分类：

   • 将同源词归类（如 general 族：general, generalize, gene）
   • 每个词族使用独立的标题块

5. 按考研重点分类：

   • ⭐⭐⭐ 高频词（必考词汇）
   • ⭐⭐ 中频词（常考词汇）
   • ⭐ 低频词（生僻词汇）

6. 僻义预警标记：

   • 🔴 Critical：考研高频僻义陷阱
   • 🟡 Warning：中等频率僻义
   • 使用 > ⚠️ **僻义预警** 标注

7. 写作词汇标注：

   • 标注可替代的简单词汇（如 conspicuous → 替代 obvious）

8. 更新原始文件：直接覆盖用户的原始单词表文件

输出格式示例:

#### conscience ⭐⭐⭐
**n.** 良心，良知；愧疚

| 词组搭配 | 释义 |
|---------|------|
| a clear conscience | 问心无愧 |
| a guilty conscience | 内疚 |

> 🧠 **记忆方法**
> - **词根**：con-(加强) + sci(知道) + -ence → 内心知道对错 → 良心
> - **同根词**：conscious（有意识的）、science（科学）
> - **写作词汇**：ethical issue 讨论时常用

输出格式:

# 单词表 - Day {N}

**日期**：{date}
**词汇量**：{count}词
**来源**：墨墨导出

---

## ⭐⭐⭐ 高频词（必考词汇）

### 词族1: {word}（{count}词）
#### {word}
{音标} {词性} {释义}
- 🔴 僻义预警：{rare_meaning}（考研{frequency}%考此义）
- 搭配：{collocations}

---

## ⭐⭐ 中频词（常考词汇）
...

---

## ⭐ 低频词（生僻词汇）
...

---

## 📊 统计信息
| 分类 | 数量 |
|------|------|
| 高频词 | {n} |
| 中频词 | {n} |
| 低频词 | {n} |
| 僻义预警 | {n} |

**下次复习日期**：{date + 2days}

功能1: PDF词汇提取 + 语境文章

输入: 用户从单词APP（墨墨/百词斩等）导出的PDF

处理流程:

1. 读取PDF内容，提取单词列表
2. 整理和格式化单词表（执行功能0）
3. 为每个单词获取：音标、词性、释义、词频
4. 检测熟词僻义：识别考研中的僻义陷阱
5. 优先检索真题语境：真题语境池 → 外刊同源 → AI生成
6. 将单词串联成真题风格的语境文章
7. 在文章中高亮目标词汇

输出:

• 整理后的单词表：覆盖原始文件
• Obsidian笔记：每日词汇记录（含僻义预警）
• 真题语境文章：包含目标词汇的连贯文章

功能2: 快速查词 + 僻义预警

输入: 单个单词或短语

处理流程:

1. 查询单词基本信息（音标、词性、释义）
2. 检测熟词僻义：显示僻义预警级别
3. 提供真题例句（含僻义用法）
4. 显示常用搭配
5. 展示同义词/反义词/词族

输出: 紧凑的单词卡片（含⚠️僻义预警）

---

熟词僻义库

Critical级别（高频陷阱）

单词	常见义	考研僻义	出现频率
address	地址	vt. 处理，解决	80%
school	学校	n. 流派，学派	70%
novel	新颖的	n. 长篇小说	65%
fine	好的	n./v. 罚款	60%
reason	原因	v. 推理，推论	55%
discipline	纪律	n. 学科	50%
consume	消费	vt. 毁灭，烧毁	40%
draft	草稿	n. 征兵	35%
compound	复合的	v. 加剧，恶化	30%

Warning级别（中等陷阱）

单词	常见义	考研僻义	出现频率
spring	春天	v. 突然出现，涌现	40%
table	桌子	v. 搁置，暂缓讨论	35%
book	书	v. 预订	30%

---

真题语境检索策略

📁 详细实现见 code.md 的 generate_context_article 函数

检索优先级

1. 真题语境池 → 优先使用近5年真题
2. 外刊同源库 → The Economist, The Guardian
3. AI生成 → 模拟真题风格（最后选项）

文章要求

• ✅ 必须包含用户提供的所有目标单词
• ✅ 译文位置：紧接在原文之后，词汇解析表之前（便于对照阅读）
• ✅ 风格模拟考研真题阅读理解

文章结构顺序（重要！）

# 标题

> 元信息

## 📖 原文
{英文原文}

## 📖 参考译文  ← 译文紧接原文，方便对照
{中文译文}

## 📊 词汇解析表
{词汇解析}

## 📖 阅读理解练习
{练习题}

⚠️ 禁止将译文放在文件末尾（用户难以找到）

---

词汇卡片格式

完整版格式

---
# 基础信息
word: "address"
pronunciation: "/əˈdres/"
part_of_speech: "verb/noun"
difficulty: "important"
frequency: 5
first_seen: "2025-01-15"

# 僻义预警
polysemy_alert: true
warning_level: "critical"
exam_frequency: "80%"
rare_meanings:
  - meaning: "处理；解决；着手处理"
    part_of_speech: "vt."
    common_collocations: ["address the problem", "address an issue", "address concerns"]
common_meanings:
  - meaning: "地址；称呼"
    part_of_speech: "n./vt."

# 真题语境
real_exam_contexts:
  - year: 2022
    paper: "英语一"
    section: "完形填空"
    sentence: "The committee failed to **address** the concerns raised by the public."
    sentence_translation: "委员会未能处理公众提出的关切。"
    other_core_words: ["committee", "concern", "raise"]

# 标签与分类
tags: ["动词", "高频", "僻义critical", "写作必备"]
exam_years: [2018, 2020, 2022]
---

# address

## 基本信息
**音标**: /əˈdres/
**词性**: vt./n.
**难度**: ⭐⭐⭐⭐⭐

## ⚠️ 僻义预警 [critical]

> [!danger] 陷阱提示
> 此词在考研中 **80%** 考查僻义"处理"，而非常见义"地址"

**考研常考僻义**: vt. 处理；解决；着手处理

### 真题例句
> [!example] 2022年真题 完形填空
> The committee failed to **address** the concerns raised by the public.

> [!example] 2020年真题 阅读理解
> We must **address** the root causes of inequality.

### 常用搭配
- address the problem - 解决问题
- address an issue - 处理议题
- address concerns - 处理关切

## 常见义（对比）
n. 地址； vt. 称呼

⚠️ 易错点：在阅读中遇到此词时，首先考虑"处理"义

## 写作应用

### 高级替换
- **初级**: solve/deal with the problem
- **高级**: **address** the problem

### 写作例句
> The government must **address** the problem of inequality.
> (政府必须处理不平等问题。)

## 词族
- addressee (n.) - 收件人
- addresser (n.) - 发言人

---

文件组织结构

考研英语/
├── 📚 重点词汇库/                # 单独文件
│   ├── exemplify.md
│   ├── address.md               # 带僻义预警
│   └── ...
│
├── 📖 一般词汇库/                # 汇总存储
│   ├── A组词汇.md
│   └── ...
│
├── 📝 每日词汇/
│   ├── Day-001-2025-01-15.md
│   └── ...
│
├── 📚 真题语境池/                # 真题例句库
│   ├── 英语一/
│   │   ├── 阅读理解/
│   │   ├── 完形填空/
│   │   └── 翻译/
│   └── 英语二/
│       └── ...
│
├── 📰 外刊同源库/                # 外刊例句库
│   ├── The Economist/
│   └── The Guardian/
│
└── ⚠️ 熟词僻义库/                # 僻义词索引
    ├── critical级别.md
    ├── warning级别.md
    └── 完整列表.md

---

Day编号计算规则 ⚠️

生成新文件前必须计算正确的Day编号！

计算步骤

1. 检查现有文件：

   find 考研英语/📰 真题语境文章 -name "*.md" | sort | tail -5
   

2. 提取最大Day编号：

   • 从文件名格式 Day-XXX-YYYY-MM-DD.md 提取 XXX
   • 例如：Day-015-2026-03-14.md → Day编号 = 15

3. 计算新Day编号：

   • 新Day编号 = 最大Day编号 + 1
   • 例如：最大是 Day-015 → 新文件使用 Day-016

4. 文件命名格式：

   • 真题文章：Context-Day-{XXX}-{YYYY-MM-DD}.md
   • 测试记录：Quiz-Day-{XXX}-{YYYY-MM-DD}.md
   • 词汇统计：Statistics-Day-{XXX}-{YYYY-MM-DD}.md
   • 写作输出：Writing-Day-{XXX}-{YYYY-MM-DD}.md

注意事项

• ❌ 禁止硬编码 "Day-001"
• ✅ 必须先检查现有文件再生成新编号
• ✅ 所有4类文件使用相同的Day编号

---

模板

模板1: 每日词汇

# 每日词汇 - Day {day_number}

**日期**: {date}
**来源**: 墨墨背单词导出
**当前阶段**: {基础期/强化期/冲刺期/极限冲刺期}
**距离考试**: {days}天

---

## 重点词汇

| 单词 | 音标 | 词性 | 释义 | ⚠️僻义 | 💡记忆提示 | 📝常见搭配 |
|------|------|------|------|--------|----------|------------|
| exemplify | /ɪɡˈzemplɪfaɪ/ | v. | 举例说明 | | 词根: exempl(例子)+ify动词化 | exemplify the point |
| address | /əˈdres/ | vt./n. | 处理；地址 | [critical] | 搭配记忆: address the problem | address the issue, address concerns |

---

## ⚠️ 僻义预警

### address [critical]
- 常见义：地址
- **考研僻义（80%）**: 处理、解决
- 搭配：address the problem, address an issue

---

## 真题语境文章

{article_including_all_target_words}

> ⚠️ **词汇覆盖检查**: 本文已包含所有 {total_count} 个目标单词

---

## 📖 文章译文

{chinese_translation}

---

## 📖 阅读理解练习

### 模板2: 真题语境卡片

```markdown
---
context_source: "真题"
source_year: 2023
source_paper: "英语一"
source_type: "阅读理解"
source_section: "Text 3"
source_topic: "社会政策"
difficulty_level: "hard"
cefr_level: "C1"
word_count: 22
core_word_density: "5/22 (23%)"
---

## 真题语境: exemplify

> [!quote] 2023年英语一 阅读理解 Text 3
> The case of California's energy policy **exemplifies** how well-intentioned regulations can have unintended consequences when market dynamics are overlooked.

### 句式分析
- **结构**: 让步状语从句 + how引导宾语从句
- **外刊风格**: 经济学人式论证逻辑（例子→观点→深层分析）
- **词汇密度**: 5个考研核心词 / 22词 (23%)

### 同句其他核心词
- well-intentioned: 善意的
- regulation: 规章制度
- unintended: 意外的
- consequence: 后果
- overlook: 忽视

> ⚠️ **时效提醒**：此语境来自2023年真题，保证时效性和权威性

---

工作流程

[用户提供PDF]
      ↓
[提取单词列表]
      ↓
[检测熟词僻义]
      ↓
[识别重点词汇]
      ↓
┌─────┴─────┐
│           │
[检索真题语境] [生成词汇卡片]
│           │
└─────┬─────┘
      ↓
[生成语境文章]
      ↓
[保存到Obsidian]

---

熟词僻义检测

📁 详细实现见 code.md 的 detect_polysemy 函数

检测逻辑

1. 检索考研大纲词表
2. 对比大纲释义与常见释义
3. 计算语义重叠度
4. 重叠度 < 50% → 触发僻义预警

预警级别

级别	重叠度	说明
⚠️ Critical	< 30%	高频陷阱词，必须重点记忆
⚡ Warning	30-50%	中等陷阱词，需要留意

---

验证标准

1. ✅ 能够从PDF中提取单词列表
2. ✅ 能够识别并分类重点词汇、僻义词和一般词汇
3. ✅ 能够优先使用真题语境而非AI生成文章
4. ✅ 能够正确检测和预警熟词僻义
5. ✅ 能够快速查询单词信息（含僻义预警）
6. ✅ 能够生成结构化词汇卡片
7. ✅ 警告格式使用⚠️图标
8. ✅ 例题格式使用[!example] callout

---

限制条件

• 需要用户提供PDF文件或单词列表
• 查词功能依赖本地词汇库或在线词典
• 真题语境依赖于预建的真题例句库

---

技能集成

依赖技能

技能	用途
kaoyan-english-core	保存词汇卡片到MemOS
obsidian-markdown	创建词汇卡片笔记
pdf	读取PDF内容
docx	导出Word文档

被调用场景

调用者	场景
kaoyan-english-review	获取单词信息生成复习计划
kaoyan-english-quiz	获取单词信息生成测试题
kaoyan-english-writing	获取单词信息用于写作训练

---

Day编号计算规则 ⚠️ (更新于2026-03-16)

重要：本技能使用 kaoyan-english-core 提供的共享Day编号计算函数。

推荐做法

# 使用共享函数获取验证后的Day编号
from kaoyan_english_core import get_validated_day_number, generate_day_filenames

# 获取Day编号（双重验证）
day_number = get_validated_day_number("2026-03-16")  # 返回：17

# 生成文件名
filenames = generate_day_filenames("2026-03-16", day_number)
# {
#     "context_article": "Context-Day-017-2026-03-16.md",
#     "statistics": "Statistics-Day-017-2026-03-16.md"
# }

核心函数位置

详细实现请参考：.claude/skills/kaoyan-english-core/code.md 第8节

Day编号对应关系

日期	Day编号
2026-02-28	Day 001
2026-03-01	Day 002
2026-03-15	Day 016
2026-03-16	Day 017
2026-03-17	Day 018

---

Markdown 表格规范 ⚠️

重要：生成词汇统计、语境文章等包含表格的文件时，必须遵守以下规范！

规范1: 表格前必须有空行

Markdown 表格必须与前面的内容之间有空行，否则表格不会被正确渲染。

# ❌ 错误 - 表格不会渲染
**重点单词**：
| 单词 | 核心含义 |
|------|---------|
| test | 测试 |

# ✅ 正确 - 表格会正确渲染
**重点单词**：

| 单词 | 核心含义 |
|------|---------|
| test | 测试 |

规范2: 表格内禁止使用粗体标记

表格内的 **粗体** 标记会干扰管道符 | 的解析，导致表格结构错乱。

# ❌ 错误 - 粗体标记会破坏表格
| 单词 | 常见义 | **僻义（考研重点）** |
|------|--------|---------------------|
| **spectrum** | 光谱 | 范围 |

# ✅ 正确 - 使用纯文本
| 单词 | 常见义 | 僻义（考研重点） |
|------|--------|------------------|
| spectrum | 光谱 | 范围 |

规范3: 表格内需要强调时的替代方案

如果需要在表格中强调某些内容，使用以下替代方案：

替代方案	示例	说明
前缀符号	⚠️ 僻义：xxx	使用 emoji 或符号标记
括号标注	(重点)	使用括号添加说明
列后注释	在表格后用文字说明	表格外使用粗体强调

规范4: 完整表格示例

**重点单词**：

| 单词 | 核心含义 | 考研考点 |
|------|---------|---------|
| resolution | 决心/解决/分辨率 | 分辨率（科技类）；conflict resolution |
| resign | 辞职/顺从 | 僻义：resign oneself to 顺从 |
| resident | 居民/住院医生 | 僻义：住院医生 |
| represent | 代表 | represent sb's interests |
| reproduce | 复制/繁殖 | reproduce results 复现结果 |

**记忆口诀**：re-开头多表示"回"或"再"

验证清单

生成包含表格的文件后，检查：

• 每个表格前都有空行
• 表格内没有 ** 粗体标记
• 表头分隔行格式正确（|---|---|）
• 所有行的列数一致

---

创建日期: 2026-03-10 版本: 1.3.0 最后更新: 2026-03-24（统一文件命名规范：Context-Day）