跟唱·歌词单词大师

> 用音乐记住每一个单词 —— 听歌、点词、跟唱、掌握。

核心理念

科学研究表朋，音乐能显著提升记忆效率。本技能通过 听歌 → 标记生词 → 跟唱填空 的闭环流程，让英语单词学习变得愉悦且高效。

功能模块概览

用户指令速查

交互流程

用户说"开始唱"
  │
  ├─→ 打开播放器，播放歌曲
  │     ├─ 歌词逐行滚动高亮
  │     ├─ 用户点击任意单词 → 标记为生词（标红）
  │     └─ 点击红色生词 → 弹出释义+例句
  │
  ├─→ 歌曲播放结束
  │     └─ 自动进入跟唱模式
  │           ├─ 生词位置挖空（____）
  │           ├─ 用户输入/语音填词
  │           ├─ 唱对 ✅ → 标记"已学会"
  │           └─ 唱错 🔄 → 显示提示，再试一次
  │
  └─→ 生成每日总结卡片
        ├─ 今日新学单词数
        ├─ 连续学习天数
        └─ 待复习单词提醒

语音降级策略

当语音输入不可用时，自动降级为 打字填空模式：
- 在挖空处显示输入框
- 用户键入单词后回车提交
- 系统自动判定正误

技术架构

交互式 Web 应用

核心学习体验通过 assets/index.html 提供 —— 一个自包含的单页应用：

• 数据存储：localStorage 持久化所有学习数据（歌曲、词汇、进度）
• 播放模拟：基于时间线的歌词滚动模拟器（无需真实音频文件）
• 离线可用：纯前端，无网络依赖，打开即用

数据模型

详见 references/data-model.md，核心结构：

{
  "songs": [{ "id", "title", "artist", "lyrics", "source" }],
  "vocab": [{ "word", "meaning", "example", "songId", "status" }],
  "progress": { "streak", "totalLearned", "studyDates" }
}

每日提醒自动化

用户首次使用时，智能体应协助设置每日提醒：

1. 询问提醒时间（默认 20:00）
2. 使用 automation_update 工具创建 recurring 自动化任务
3. rrule 示例：FREQ=DAILY;BYHOUR=20;BYMINUTE=0

详见 references/automation-setup.md。

歌单导入方式

方式一：手动输入（默认）

1. 用户提供歌曲标题、歌手名
2. 用户粘贴完整歌词
3. 系统自动分词并提取候选词汇

方式二：Spotify 集成

详见 references/spotify-integration.md
1. 用户提供 Spotify 歌单链接或 ID
2. 通过 Spotify API 获取曲目列表
3. 通过歌词 API（如 Musixmatch）获取歌词

方式三：Apple Music 集成

详见 references/spotify-integration.md
1. 用户提供 Apple Music 歌单链接
2. 通过 Apple Music API 获取曲目
3. 获取歌词并导入

智能体行为指南

当触发本技能时，智能体应：

1. 首次使用：打开 assets/index.html 交互式应用，简要介绍功能
2. 导入歌单：引导用户输入歌曲信息，将数据写入应用的 localStorage
3. 开始唱：确保应用已打开，切换到播放学习界面
4. 进度查询：从应用读取进度数据，生成文字报告
5. 复习：在应用中启动复习模式
6. 每日提醒：首次提及"提醒"时，协助设置自动化任务

打开应用的方式

# 在浏览器中打开交互式应用
start assets/index.html

或通过 WorkBuddy 的 present_files 功能在内置浏览器中预览。

预装示例歌曲

应用内置 3 首示例歌曲，包含完整歌词和预设生词，用户打开即可体验完整流程：

1. The Journey — 关于旅行，词汇：wander, horizon, beneath, breeze, farewell
2. City Lights — 关于城市梦想，词汇：ambition, neon, skyline, rhythm, pavement
3. Ocean Waves — 关于自然，词汇：tide, whisper, ancient, vast, serenity

文件结构

sing-along-lyrics-master/
├── SKILL.md                          # 本文件 - 技能定义
├── assets/
│   └── index.html                    # 交互式学习应用（自包含）
├── references/
│   ├── workflow.md                   # 详细工作流文档
│   ├── data-model.md                 # 数据模型文档
│   ├── automation-setup.md           # 每日提醒设置指南
│   └── spotify-integration.md        # 歌单集成指南
└── scripts/
    └── export-progress.py            # 进度数据导出脚本

版本历史

• v1.0.0 — 初始版本：歌单导入、播放学习、跟唱填空、进度追踪、每日提醒