english-learner by learnwy/skills
npx skills add https://github.com/learnwy/skills --skill english-learner个人词汇学习助手,具备持久化存储和掌握度追踪功能。
| 关键词 | 操作 |
|---|---|
学习 / review / quiz | 开始交互式学习会话 |
stats / 统计 | 显示学习统计信息 |
所有其他输入 均视为待翻译/学习的内容(英文、中文或混合)。
1. 检查关键词 → 如果是"学习"/"review"/"quiz" → 学习模式
2. 解析输入 → 理解用户意图(若模糊则澄清)
3. 识别内容 → 提取单词/短语/句子到列表中
4. 如果模糊 → 在处理前通过 AskUserQuestion 确认
5. 批量查询 → python vocab_manager.py batch_get '["word1", "word2", ...]'
6. AI 生成 → 对于每个"未找到"的单词,AI 提供定义/音标/例句
7. 批量保存 → python vocab_manager.py batch_save '[{...}, {...}]'
8. 记录查询 → python vocab_manager.py log_query <query> <type>
9. 响应 → 统一格式输出
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
关键: 第 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` 查询短语
- 输入一句英文或中文来翻译和学习
在响应用户之前,请验证:
batch_get 执行批量查询batch_save 保存新单词(非可选!)log_query 记录查询常见错误: 仅记录查询而不保存单词。修复: 始终为新单词运行 batch_save。
每周安装次数
144
代码仓库
GitHub 星标数
1
首次出现
2026年2月25日
安全审计
安装于
opencode143
kimi-cli142
gemini-cli142
codex142
cursor142
amp142
Python PDF处理教程:合并拆分、提取文本表格、创建PDF文件
65,000 周安装
AI SDK Core:Vercel AI SDK v5/v6 后端AI开发工具包 - 支持OpenAI、Anthropic、Google模型
479 周安装
App Store市场脉搏分析工具:ASO专家必备的榜单、关键词、推荐应用监控技能
493 周安装
LinkedIn URL查找配方 - 集成GTM元技能,自动化处理社交网络数据
518 周安装
Mapbox制图技能:专业地图设计原则、色彩理论与图层优化指南
502 周安装
Meta Ads广告投放指南:Facebook/Instagram广告设置、受众定位与创意优化全攻略
514 周安装
TanStack Table 无头数据表格 | Cloudflare Workers + D1 服务器端分页排序
493 周安装