@rookiestar/eng-lang-tutor 1.0.0

package/CLAUDE.md

@@ -0,0 +1,259 @@
+# SKILL: eng-lang-tutor
+
+## 1. 项目目标
+
+本项目主要为Agent添加「地道美式英语导师」的Skill，配合Agent所在环境的cron job实现定期的知识推送与测验。
+
+### 1.1. 学习目标
+
+- 以提升地道的美式英语常用口语表达为主，兼顾听力与书面表达（正式场合）。
+- 避免传统的Chinglish的硬翻式尴尬表达。
+- 融入轻量游戏化教学，覆盖影视、新闻、游戏、体育、职场、社交、生活等用户感兴趣的场景来提升用户的粘性。
+
+### 1.2. 语言范围
+
+- 以美式英语为主，包含俚语、口头语、缩写（gonna, gotta, kinda 等），能帮助用户区分「正式 vs 口语」。
+
+### 1.3. 技能维度
+
+- 涉及词汇/短语、固定搭配、场景句型等口语与书面语中的表达方式。
+
+## 2. 项目范围
+
+### 2.1. MVP版本功能清单
+
+#### 2.1.1 导师模式
+
+Agent结合难度与偏好的设置，以及用户的历史学习进度动态生成并调整个性化的教学大纲与教学内容：
+
+| 功能 | 描述 | 频次 | 对应脚本 |
+|-----|------|-----|---------|
+| **知识点** | 地道美式英语日常沟通素材，包含场景、可替换说法、Chinglish陷阱+修正 | 每天 | state_manager.py |
+| **Quiz** | 3道轻量测验：1多选+1Chinglish修正+1随机（填空/对话）| 每天 | scorer.py |
+| **错题本** | 记录错误答案，支持手动添加，便于针对性复习 | 实时 | state_manager.py |
+
+**Quiz 结构：**
+
+| 题型 | 描述 | XP值 | 每日Quiz |
+|-----|------|-----|---------|
+| multiple_choice | 四选一，测试表达识别 | 10 | 1 (必选) |
+| chinglish_fix | 识别并修正Chinglish表达 | 15 | 1 (必选) |
+| fill_blank | 填空，完成对话 | 12 | 0-1 (随机) |
+| dialogue_completion | 选择合适的对话回应 | 15 | 0-1 (随机) |
+
+- **每日Quiz**: 3题，约37 XP，答对2题即过关
+
+#### 2.1.2 状态管理
+
+保障整个教学过程可备份、可追溯、可回滚：
+
+| 组件 | 文件 | 用途 |
+|-----|------|-----|
+| 核心状态 | state.json | streak/xp/偏好/近期主题/错题本 |
+| 事件日志 | logs/events_YYYY-MM.jsonl | 追加式事件流水账 |
+| 每日内容 | daily/YYYY-MM-DD/*.json | 知识点/Quiz/用户答案 |
+
+#### 2.1.3 成就体系（Duolingo风格）
+
+**双等级体系说明：**
+- **能力等级 (CEFR)**：A1-C2，决定内容难度，与 App 无关的绝对语言能力
+- **活跃等级 (Level)**：1-20，衡量 App 使用深度，通过 XP 累积升级
+
+| 活跃等级 | 阶段 | XP 需求 |
+|---------|------|---------|
+| 1-5 | 启程者 (Starter) | 0-350 |
+| 6-10 | 行路人 (Traveler) | 550-2000 |
+| 11-15 | 探索者 (Explorer) | 2600-6000 |
+| 16-20 | 开拓者 (Pioneer) | 7200-15000 |
+
+| 组件 | 描述 |
+|-----|------|
+| **XP & 等级** | 1-20级，XP累积升级（启程者 → 行路人 → 探索者 → 开拓者） |
+| **连胜系统** | 连续学习天数，支持连胜冻结（50宝石） |
+| **联赛系统** | Bronze → Silver → Gold → Platinum → Diamond（周结算） |
+| **徽章系统** | First Steps、Week Warrior、Month Master、Perfect 10、Vocab Hunter、Error Slayer |
+| **宝石系统** | 用于购买连胜冻结、提示等 |
+
+**徽章详情：**
+
+| 徽章 | 触发条件 | 宝石奖励 |
+|-----|---------|---------|
+| First Steps | 完成首次Quiz | 10 |
+| Week Warrior | 7天连胜 | 25 |
+| Month Master | 30天连胜 | 100 |
+| Perfect 10 | 10次完美Quiz | 50 |
+| Vocab Hunter | 学习100个表达 | 75 |
+| Error Slayer | 清除30个错题 | 30 |
+
+#### 2.1.4 系统配置
+
+| 配置项 | 描述 | 默认值 |
+|-------|------|-------|
+| CEFR等级 | A1-C2语言级别 | B1 |
+| 口语/书面比例 | 口语表达占比 | 70% |
+| 主题配比 | movies/news/gaming/sports/workplace/social/daily_life | 各主题权重 |
+| 导师风格 | humorous/rigorous/casual/professional | humorous |
+| 去重天数 | 避免重复内容的时间窗口 | 14天 |
+
+### 2.2. MVP版本不做 / 延后
+
+- **周周练**：5道综合性场景练习，覆盖本周知识点，约62 XP，答对3题即过关。计划周日推送。
+- **语音模式**：支持tts便于用户跟读，支持asr便于导师对口语表达进行打分。
+
+### 2.3. 项目约束
+
+**核心原则：别问"怎么翻译"，先问"这个场景美国人会怎么说"，会让你立刻更像美国人。**
+
+#### 2.3.1 输出格式约束
+
+- **必须输出合法 JSON**（不要 markdown，不要代码块，不要多余文本）
+- 所有输出必须符合 `templates/` 目录下的 JSON Schema
+
+#### 2.3.2 内容质量约束
+
+- 语言风格：**地道美式**、轻松、可用、短句为主
+- 每条知识点必须包含：**场景、可替换说法、Chinglish 陷阱 + 修正**
+- 包含发音提示（gonna, gotta, wanna 等自然发音）
+- 提供文化背景和使用场景说明
+
+#### 2.3.3 去重策略（14天窗口）
+
+使用 `scripts/dedup.py` 实现三层去重：
+
+| 层级 | 方法 | 描述 |
+|-----|------|-----|
+| 1 | topic_fingerprint | 主题指纹匹配 |
+| 2 | 表达重叠 | 相同短语超过50%视为重复 |
+| 3 | 词根匹配 | 核心词汇结构相似 |
+
+#### 2.3.4 反直译原则
+
+- 优先给"美国人会怎么说"，而不是"中文怎么翻英文"
+- 参考 `references/resources.md` 中的主题资源库
+- 使用 `references/prompt_templates.md` 中的LLM提示模板
+
+## 3. 技术栈与SKILL结构
+
+### 3.1. 技术栈与输出格式
+
+- 技术栈：Python 3.x
+- 触发方式：cron 触发 Agent 调用 Skill
+
+### 3.2. 目录结构
+
+```
+eng-lang-tutor/
+├── SKILL.md                    # 核心技能文档
+├── CLAUDE.md                   # 项目说明（本文件）
+├── scripts/
+│   ├── state_manager.py        # 状态持久化与事件日志
+│   ├── scorer.py               # 答案评估与XP计算
+│   ├── gamification.py         # 连胜/等级/徽章/联赛
+│   └── dedup.py                # 14天去重逻辑
+├── templates/
+│   ├── state_schema.json       # 状态 JSON Schema
+│   ├── keypoint_schema.json    # 知识点 JSON Schema
+│   └── quiz_schema.json        # Quiz JSON Schema
+├── references/
+│   ├── resources.md            # 主题化英语学习资源库
+│   └── prompt_templates.md     # LLM Prompt 模板
+├── examples/
+│   ├── sample_keypoint.json    # 示例知识点
+│   └── sample_quiz.json        # 示例Quiz
+└── data/
+    ├── state.json              # 运行时状态
+    ├── logs/
+    │   └── events_YYYY-MM.jsonl
+    └── daily/
+        └── YYYY-MM-DD/
+            ├── keypoint.json
+            ├── quiz.json
+            └── user_answers.json
+```
+
+## 4. 功能切片实现
+
+### 4.1 功能切片与脚本对应
+
+| 切片 | 对应脚本 | 输入 | 输出 |
+|-----|---------|------|-----|
+| 状态加载/保存 | state_manager.py | - | state.json |
+| 事件日志 | state_manager.py | event_type, data | events_YYYY-MM.jsonl |
+| 每日内容保存 | state_manager.py | content_type, content | daily/YYYY-MM-DD/*.json |
+| 答案评估 | scorer.py | quiz.json + user_answers | results + updated state |
+| XP计算 | scorer.py | correct_count, streak | XP with multiplier |
+| 连胜更新 | gamification.py | study_date | new_streak |
+| 等级更新 | gamification.py | XP | level |
+| 徽章检查 | gamification.py | progress | new_badges |
+| 联赛更新 | gamification.py | weekly_xp | league |
+| 去重检查 | dedup.py | new_content, recent_content | is_duplicate |
+
+### 4.2 核心工作流
+
+#### 4.2.1 每日知识点生成
+
+```
+1. state_manager.load_state()
+2. dedup.get_excluded_topics(state)
+3. LLM生成知识点（使用prompt_templates.md）
+4. dedup.check_duplicate(new_content, recent_content)
+5. 验证JSON Schema
+6. state_manager.save_daily_content('keypoint', content)
+7. state_manager.append_event('keypoint_generated', {...})
+```
+
+#### 4.2.2 Quiz评估流程
+
+```
+1. state_manager.load_daily_content('quiz')
+2. 读取 user_answers.json
+3. scorer.evaluate_quiz(quiz, answers, state)
+4. gamification.update_streak(state, today)
+5. gamification.update_level(state)
+6. gamification.check_badges(state)
+7. state_manager.save_state(state)
+8. state_manager.append_event('quiz_completed', results)
+```
+
+## 5. 开发准则
+
+### 5.1 Skill文档规范
+
+- SKILL.md文档要详细但不能过长，聚焦核心步骤，细节可以放在代码示例里。建议**800-1500 tokens**。
+- Skills 必须包含可执行的步骤、代码示例、验证检查点。
+- 设计 Skills 时考虑复用性（模块化）。一个 Skill 解决一类问题，不是一次性的硬编码。
+
+### 5.2 确定性验证器
+
+每个任务都有**确定性验证器**（deterministic verifier）：这不是用 LLM 评判，而是程序化断言。
+
+| 验证项 | 验证方法 | 对应工具 |
+|-------|---------|---------|
+| JSON格式 | json.loads() | Python标准库 |
+| JSON Schema | schema validation | templates/*.json |
+| XP计算 | 公式验证 | scorer.py |
+| 连胜更新 | 日期比较 | gamification.py |
+| 去重检查 | 指纹/表达匹配 | dedup.py |
+
+### 5.3 聚焦核心路径
+
+不要过度工程化：比如应该聚焦 80% 场景的核心路径，而非覆盖尽可能多的edge cases。
+
+### 5.4 可复用资源
+
+| 资源 | 位置 | 用途 |
+|-----|------|-----|
+| skill-creator | github.com/anthropics/skills | 自动生成skill骨架 |
+| awesome-language-learning | github.com/Vuizur/awesome-language-learning | 语言学习工具集合 |
+| 主题资源库 | references/resources.md | 美剧/新闻/游戏/体育/职场/生活 |
+| LLM提示模板 | references/prompt_templates.md | 知识点/Quiz生成模板 |
+
+### 5.5 安装与使用
+
+```bash
+# 1. 添加官方Skills市场
+/plugin marketplace add anthropics/skills
+
+# 2. 安装skill-creator（可选，用于生成新skill）
+/plugin install skill-creator@anthropic-agent-skills
+```

package/README.md

@@ -0,0 +1,224 @@
+# eng-lang-tutor
+
+**地道美式英语导师** - 一个用于学习地道美式英语表达的 OpenClaw Skill。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 功能特性
+
+- 📚 **每日知识点** - 地道美式表达，包含场景语境、可替换说法和中式英语陷阱
+- 📝 **测验系统** - 4种题型：选择题、填空题、对话补全、中式英语修正
+- 🎮 **多邻国风格游戏化** - XP经验值、等级、连胜、徽章、宝石
+- ⏰ **可自定义推送时间** - 通过 cron 设置您偏好的推送时间
+- 🌐 **双语支持** - 命令同时支持中英文
+
+## 快速开始
+
+### 前置条件
+
+- 服务器上已安装 OpenClaw Gateway
+- Python 3.8+
+- Discord Bot（或其他 IM 通道）
+
+### 安装步骤
+
+1. **克隆到您的 OpenClaw skills 目录：**
+
+```bash
+cd ~/.openclaw/skills/
+git clone https://github.com/rookiestar/eng-lang-tutor.git
+```
+
+2. **验证安装：**
+
+```bash
+openclaw skills list
+openclaw skills info eng-lang-tutor
+```
+
+3. **配置渠道：**
+
+**Discord 配置：**
+```bash
+openclaw config set discord.token YOUR_BOT_TOKEN
+openclaw config set discord.guildId YOUR_SERVER_ID
+```
+
+4. **完成配对：**
+
+首次向 Bot 发送消息时，您会收到一个配对码。批准它：
+
+```bash
+openclaw pairing approve discord YOUR_PAIRING_CODE
+```
+
+### 首次使用
+
+首次与 Bot 交互时，它会引导您完成 6 步引导流程：
+
+1. 选择您的 CEFR 等级（A1-C2）
+2. 选择您的兴趣主题
+3. 选择导师风格（幽默/严谨/随意/专业）
+4. 设置口语/书面语比例
+5. 配置推送时间（知识点和测验时间）
+6. 确认您的设置并创建定时任务
+
+## 命令列表
+
+| 命令 | 别名 | 描述 |
+|---------|---------|-------------|
+| `start` | `开始`, `初始化` | 启动引导配置 |
+| `keypoint` | `知识点`, `today` | 查看今日知识点 |
+| `keypoint history` | `知识点 历史` | 查看历史知识点 |
+| `quiz` | `测验`, `test` | 参加每日测验 |
+| `stats` | `进度`, `level` | 查看学习进度 |
+| `config` | `设置` | 查看设置 |
+| `errors` | `错题本` | 查看错题本 |
+| `help` | `帮助` | 显示命令列表 |
+
+## 推送时间配置
+
+### 默认推送时间（UTC+8）
+
+| 任务 | 时间 |
+|------|------|
+| 知识点 | 早上 6:45 |
+| 每日测验 | 晚上 10:45 |
+
+### 自定义推送时间
+
+```
+set schedule keypoint 7:00
+set schedule quiz 21:00
+```
+
+### Crontab 设置
+
+```bash
+# 编辑 crontab
+crontab -e
+
+# 添加定时任务
+CRON_TZ=Asia/Shanghai
+
+# 06:45 每日知识点
+45 6 * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's keypoint." --mode now
+
+# 22:45 每日测验
+45 22 * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's quiz invitation." --mode now
+```
+
+## 游戏化系统
+
+### XP 与等级
+
+本系统包含两个独立的等级体系：
+- **能力等级 (CEFR)**：A1-C2，决定内容难度（语言能力水平）
+- **活跃等级 (Level)**：1-20，衡量使用深度（使用进程）
+
+| 等级范围 | 所需 XP | 阶段 |
+|-------------|-------------|-------|
+| 1-5 | 0-350 | 启程者 (Starter) |
+| 6-10 | 550-2000 | 行路人 (Traveler) |
+| 11-15 | 2600-6000 | 探索者 (Explorer) |
+| 16-20 | 7200-15000 | 开拓者 (Pioneer) |
+
+### 徽章
+
+| 徽章 | 获取条件 | 宝石奖励 |
+|-------|-------------|------|
+| First Steps | 完成首次测验 | 10 |
+| Week Warrior | 7天连胜 | 25 |
+| Month Master | 30天连胜 | 100 |
+| Perfect 10 | 10次满分测验 | 50 |
+| Vocab Hunter | 学习100个表达 | 75 |
+| Error Slayer | 清除30个错题 | 30 |
+
+## 项目结构
+
+```
+eng-lang-tutor/
+├── SKILL.md                    # Skill 文档
+├── scripts/
+│   ├── state_manager.py        # 状态持久化与事件日志
+│   ├── scorer.py               # 答案评估与 XP 计算
+│   ├── gamification.py         # 连胜/等级/徽章逻辑
+│   ├── dedup.py                # 14天去重逻辑
+│   ├── command_parser.py       # 用户命令解析
+│   └── cron_push.py            # 定时内容推送
+├── templates/
+│   ├── state_schema.json       # 状态 JSON Schema
+│   ├── keypoint_schema.json    # 知识点 JSON Schema
+│   ├── quiz_schema.json        # 测验 JSON Schema
+│   └── prompt_templates.md     # LLM Prompt 模板
+├── references/
+│   └── resources.md            # 主题化学习资源
+├── examples/
+│   ├── sample_keypoint.json
+│   └── sample_quiz.json
+├── tests/
+│   ├── conftest.py
+│   ├── test_state_manager.py
+│   ├── test_scorer.py
+│   ├── test_gamification.py
+│   ├── test_dedup.py
+│   ├── test_command_parser.py
+│   └── test_cron_push.py
+└── data/
+    ├── state.json              # 运行时状态
+    ├── logs/                   # 事件日志
+    └── daily/                  # 每日内容
+```
+
+## 文档
+
+- [SKILL.md](SKILL.md) - 完整 Skill 文档
+- [OpenClaw 部署指南](docs/OPENCLAW_DEPLOYMENT.md) - 服务器部署
+
+## 开发
+
+### 运行测试
+
+```bash
+cd eng-lang-tutor
+pytest tests/ -v
+```
+
+### 运行演示
+
+```bash
+python3 scripts/command_parser.py --demo
+python3 scripts/cron_push.py --task status
+```
+
+## 服务器迁移
+
+迁移到新服务器：
+
+```bash
+# 在源服务器上
+cd ~/.openclaw/skills/
+tar -czvf eng-lang-tutor-backup.tar.gz eng-lang-tutor/
+
+# 传输到新服务器
+scp eng-lang-tutor-backup.tar.gz user@new-server:~/
+
+# 在目标服务器上
+cd ~/.openclaw/skills/
+tar -xzvf ~/eng-lang-tutor-backup.tar.gz
+```
+
+详细迁移指南请参见 [docs/OPENCLAW_DEPLOYMENT.md](docs/OPENCLAW_DEPLOYMENT.md)。
+
+## 许可证
+
+MIT License - 详见 [LICENSE](LICENSE)。
+
+## 贡献
+
+欢迎贡献！请随时提交 Pull Request。
+
+## 致谢
+
+- [awesome-language-learning](https://github.com/Vuizur/awesome-language-learning) - 资源灵感来源
+- [Duolingo](https://www.duolingo.com) - 游戏化模型参考

package/README_EN.md

@@ -0,0 +1,224 @@
+# eng-lang-tutor
+
+**地道美式英语导师** - An OpenClaw Skill for learning authentic American English expressions.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 📚 **Daily Knowledge Points** - Authentic American expressions with scene context, alternatives, and Chinglish traps
+- 📝 **Quiz System** - 4 question types: multiple choice, fill blank, dialogue completion, Chinglish fix
+- 🎮 **Duolingo-style Gamification** - XP, levels, streaks, badges, gems
+- ⏰ **Customizable Schedule** - Set your preferred push times via cron
+- 🌐 **Bilingual Support** - Commands work in both English and Chinese
+
+## Quick Start
+
+### Prerequisites
+
+- OpenClaw Gateway installed on your server
+- Python 3.8+
+- Discord Bot (or other IM channel)
+
+### Installation
+
+1. **Clone to your OpenClaw skills directory:**
+
+```bash
+cd ~/.openclaw/skills/
+git clone https://github.com/rookiestar/eng-lang-tutor.git
+```
+
+2. **Verify installation:**
+
+```bash
+openclaw skills list
+openclaw skills info eng-lang-tutor
+```
+
+3. **Configure Channel:**
+
+**Discord Configuration:**
+```bash
+openclaw config set discord.token YOUR_BOT_TOKEN
+openclaw config set discord.guildId YOUR_SERVER_ID
+```
+
+4. **Complete pairing:**
+
+When you first message the bot, you'll receive a pairing code. Approve it:
+
+```bash
+openclaw pairing approve discord YOUR_PAIRING_CODE
+```
+
+### First Use
+
+When you first interact with the bot, it will guide you through a 6-step onboarding:
+
+1. Select your CEFR level (A1-C2)
+2. Choose your topic interests
+3. Select tutor style (humorous/rigorous/casual/professional)
+4. Set oral vs written focus
+5. Configure schedule (keypoint and quiz times)
+6. Confirm your settings and create cron jobs
+
+## Commands
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `start` | `开始`, `初始化` | Start onboarding |
+| `keypoint` | `知识点`, `today` | View today's knowledge point |
+| `keypoint history` | `知识点 历史` | View historical keypoints |
+| `quiz` | `测验`, `test` | Take daily quiz |
+| `stats` | `进度`, `level` | View progress |
+| `config` | `设置` | View settings |
+| `errors` | `错题本` | View error notebook |
+| `help` | `帮助` | Show commands |
+
+## Schedule Configuration
+
+### Default Schedule (UTC+8)
+
+| Task | Time |
+|------|------|
+| Knowledge Point | 6:45 AM |
+| Daily Quiz | 10:45 PM |
+
+### Customize Schedule
+
+```
+set schedule keypoint 7:00
+set schedule quiz 21:00
+```
+
+### Crontab Setup
+
+```bash
+# Edit crontab
+crontab -e
+
+# Add scheduled tasks
+CRON_TZ=Asia/Shanghai
+
+# 06:45 Daily keypoint
+45 6 * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's keypoint." --mode now
+
+# 22:45 Daily quiz
+45 22 * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's quiz invitation." --mode now
+```
+
+## Gamification
+
+### XP & Levels
+
+This system has two independent level systems:
+- **Ability Level (CEFR)**: A1-C2, determines content difficulty (language proficiency)
+- **Activity Level**: 1-20, measures engagement depth (usage progression)
+
+| Level Range | XP Required | Stage |
+|-------------|-------------|-------|
+| 1-5 | 0-350 | Starter (启程者) |
+| 6-10 | 550-2000 | Traveler (行路人) |
+| 11-15 | 2600-6000 | Explorer (探索者) |
+| 16-20 | 7200-15000 | Pioneer (开拓者) |
+
+### Badges
+
+| Badge | Requirement | Gems |
+|-------|-------------|------|
+| First Steps | Complete first quiz | 10 |
+| Week Warrior | 7-day streak | 25 |
+| Month Master | 30-day streak | 100 |
+| Perfect 10 | 10 perfect quizzes | 50 |
+| Vocab Hunter | Learn 100 expressions | 75 |
+| Error Slayer | Clear 30 errors | 30 |
+
+## Project Structure
+
+```
+eng-lang-tutor/
+├── SKILL.md                    # Skill documentation
+├── scripts/
+│   ├── state_manager.py        # State persistence & events
+│   ├── scorer.py               # Answer evaluation & XP
+│   ├── gamification.py         # Streak/level/badge logic
+│   ├── dedup.py                # 14-day deduplication
+│   ├── command_parser.py       # User command parsing
+│   └── cron_push.py            # Scheduled content push
+├── templates/
+│   ├── state_schema.json       # State JSON Schema
+│   ├── keypoint_schema.json    # Keypoint JSON Schema
+│   ├── quiz_schema.json        # Quiz JSON Schema
+│   └── prompt_templates.md     # LLM prompt templates
+├── references/
+│   └── resources.md            # Themed learning resources
+├── examples/
+│   ├── sample_keypoint.json
+│   └── sample_quiz.json
+├── tests/
+│   ├── conftest.py
+│   ├── test_state_manager.py
+│   ├── test_scorer.py
+│   ├── test_gamification.py
+│   ├── test_dedup.py
+│   ├── test_command_parser.py
+│   └── test_cron_push.py
+└── data/
+    ├── state.json              # Runtime state
+    ├── logs/                   # Event logs
+    └── daily/                  # Daily content
+```
+
+## Documentation
+
+- [SKILL.md](SKILL.md) - Full skill documentation
+- [OpenClaw Deployment Guide](docs/OPENCLAW_DEPLOYMENT.md) - Server deployment
+
+## Development
+
+### Run Tests
+
+```bash
+cd eng-lang-tutor
+pytest tests/ -v
+```
+
+### Run Demo
+
+```bash
+python3 scripts/command_parser.py --demo
+python3 scripts/cron_push.py --task status
+```
+
+## Migration
+
+To migrate to a new server:
+
+```bash
+# On source server
+cd ~/.openclaw/skills/
+tar -czvf eng-lang-tutor-backup.tar.gz eng-lang-tutor/
+
+# Transfer to new server
+scp eng-lang-tutor-backup.tar.gz user@new-server:~/
+
+# On target server
+cd ~/.openclaw/skills/
+tar -xzvf ~/eng-lang-tutor-backup.tar.gz
+```
+
+See [docs/OPENCLAW_DEPLOYMENT.md](docs/OPENCLAW_DEPLOYMENT.md) for detailed migration guide.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Acknowledgments
+
+- [awesome-language-learning](https://github.com/Vuizur/awesome-language-learning) - Resource inspiration
+- [Duolingo](https://www.duolingo.com) - Gamification model reference