关键： 第 7 步是强制性的。每个单词/短语在响应前必须被保存。

输入澄清

如果输入不明确或包含多个项目：

AskUserQuestion:
- question: "我理解你想查询以下内容，请确认："
- header: "确认"
- options:
  - label: "单词: apple, banana", description: "分别查询这两个单词"
  - label: "短语: break the ice", description: "查询这个短语"
  - label: "全部", description: "查询所有内容"

脚本

所有脚本位于 {skill_root}/scripts/。数据位于 ~/.english-learner/。

# vocab_manager.py - 单次操作
python vocab_manager.py get_word <word>
python vocab_manager.py save_word <word> <definition> [phonetic] [examples_json]
python vocab_manager.py get_phrase "<phrase>"
python vocab_manager.py save_phrase "<phrase>" <definition> [phonetic] [examples_json]
python vocab_manager.py log_query <query> <type>
python vocab_manager.py stats
python vocab_manager.py update_mastery <item> <is_word:true/false> <correct:true/false>

# vocab_manager.py - 批量操作（多单词时推荐使用）
python vocab_manager.py batch_get '["word1", "word2", ...]'
python vocab_manager.py batch_save '[{"word": "...", "definition": "...", "phonetic": "...", "examples": [...]}]'

# sentence_parser.py
python sentence_parser.py classify <text>
python sentence_parser.py parse <sentence>
python sentence_parser.py batch_check <words>

# quiz_manager.py
python quiz_manager.py generate [count] [type] [focus]
python quiz_manager.py review [limit]
python quiz_manager.py summary

统一响应格式

单词

必填字段： 英文、音标、定义（所有含义）、例句

📖 **{english}** {phonetic}

**词义 Definitions:**

1. **{pos1}** {chinese1}
   - {example1_en}
   - {example1_cn}

2. **{pos2}** {chinese2}
   - {example2_en}
   - {example2_cn}

**同义词:** {synonyms}
**反义词:** {antonyms}

---
📊 查询次数: {lookup_count} | 掌握度: {mastery}%

示例：

📖 **run** /rʌn/

**词义 Definitions:**

1. **v.** 跑，奔跑
   - I run every morning.
   - 我每天早上跑步。

2. **v.** 运行，运转
   - The program runs smoothly.
   - 程序运行顺畅。

3. **v.** 经营，管理
   - She runs a small business.
   - 她经营一家小公司。

4. **n.** 跑步；一段路程
   - I went for a run.
   - 我去跑了一圈。

**同义词:** sprint, jog, operate
**反义词:** walk, stop

---
📊 查询次数: 5 | 掌握度: 40%

短语

必填字段： 英文、音标、含义、字面意思、例句

📖 **{english_phrase}** {phonetic}

**释义:** {chinese_meaning}
**字面意思:** {literal_meaning}

**例句:**
- {example1_en}
  {example1_cn}
- {example2_en}
  {example2_cn}

---
📊 查询次数: {lookup_count} | 掌握度: {mastery}%

示例：

📖 **break the ice** /breɪk ðə aɪs/

**释义:** 打破僵局；打破沉默
**字面意思:** 打破冰块

**例句:**
- He told a joke to break the ice at the meeting.
  他在会上讲了个笑话来打破僵局。
- A good question can help break the ice.
  一个好问题可以帮助打破沉默。

---
📊 查询次数: 2 | 掌握度: 60%

句子

必填字段： 原文、译文、发音指导、单词/短语分解

📝 **句子分析**

**原文:** {original}
**译文:** {translation}
**朗读:** {phonetic_guide}

---

**词汇拆解:**

{对于每个关键词/短语，使用上面的单词/短语格式}

示例：

📝 **句子分析**

**原文:** The early bird catches the worm.
**译文:** 早起的鸟儿有虫吃。（比喻：勤奋的人有收获）
**朗读:** /ðə ˈɜːli bɜːd ˈkætʃɪz ðə wɜːm/

---

**词汇拆解:**

📖 **early** /ˈɜːli/

**词义 Definitions:**
1. **adj.** 早的，提前的
   - I'm an early riser.
   - 我是个早起的人。

---

📖 **catch** /kætʃ/

**词义 Definitions:**
1. **v.** 抓住，捕获
   - The cat caught a mouse.
   - 猫抓住了一只老鼠。
2. **v.** 赶上（车、飞机等）
   - I need to catch the 8am train.
   - 我需要赶上早上8点的火车。

---

📖 **worm** /wɜːm/

**词义 Definitions:**
1. **n.** 虫，蠕虫
   - Birds eat worms.
   - 鸟吃虫子。

---
📊 新增词汇: early, catch, worm

学习模式

当用户输入 学习 / review / quiz 时：

1. python quiz_manager.py generate 5 all low_mastery

2. 对于每一项：
   
   AskUserQuestion #1:
   - question: "📖 **{word}** 的意思是什么？"
   - header: "Quiz"
   - options:
     - label: "认识", description: "我知道这个词的意思"
     - label: "模糊", description: "有点印象但不确定"
     - label: "不认识", description: "完全不知道"
   
3. 显示答案（统一单词/短语格式）

4. AskUserQuestion #2:
   - question: "掌握程度如何？"
   - header: "Mastery"
   - options:
     - label: "完全掌握", description: "+10 mastery"
     - label: "基本掌握", description: "+5 mastery"
     - label: "需要加强", description: "-5 mastery"

5. python vocab_manager.py update_mastery <item> true <result>

6. 继续或显示总结

数据结构

~/.english-learner/
├── words/{prefix}.json     # 按前两个字母分组的单词
├── phrases/{first_word}.json
├── history/{date}.json     # 每日查询日志
└── memory/
    ├── SOUL.md
    └── USER.md

单词数据模式

{
  "word": "run",
  "definitions": [
    {"pos": "v.", "meaning": "跑，奔跑", "examples": ["I run every morning."]},
    {"pos": "v.", "meaning": "运行，运转", "examples": ["The program runs."]},
    {"pos": "n.", "meaning": "跑步", "examples": ["I went for a run."]}
  ],
  "phonetic": "/rʌn/",
  "synonyms": ["sprint", "jog"],
  "antonyms": ["walk", "stop"],
  "created_at": "2024-01-15T10:00:00",
  "lookup_count": 5,
  "mastery": 40
}

统计信息响应格式

当用户输入 stats / 统计 时：

📊 **学习统计**

| 类别 | 数量 |
|------|------|
| 总词汇 | {total_words} |
| 总短语 | {total_phrases} |
| 已掌握 (≥80%) | {mastered_words} |
| 学习中 (30-79%) | {learning_words} |
| 新词汇 (<30%) | {new_words} |
| 总查询次数 | {total_lookups} |

学习模式 - 空词库

如果 quiz_manager.py 返回空列表（没有可复习的单词）：

📚 **词库为空**

还没有添加任何词汇。试试查询一些单词或句子吧！

**示例:**
- 输入 `apple` 查询单词
- 输入 `break the ice` 查询短语
- 输入一句英文或中文来翻译和学习

执行检查清单（AI 必须遵守）

在响应用户之前，请验证：

• 所有单词已从输入中提取（英文或中文）
• 已通过 batch_get 执行批量查询
• 已通过 batch_save 保存新单词（非可选！）
• 已通过 log_query 记录查询
• 响应使用统一格式

常见错误： 仅记录查询而不保存单词。修复： 始终为新单词运行 batch_save。

每周安装次数

144

代码仓库

learnwy/skills

GitHub 星标数

1

首次出现

2026年2月25日

安全审计

Gen Agent Trust HubPassSocketPassSnykPass

安装于

opencode143

kimi-cli142

gemini-cli142

codex142

cursor142

amp142