@rookiestar/eng-lang-tutor 1.1.8 → 1.2.0

package/README.md

@@ -22,16 +22,6 @@
 - ffmpeg（用于音频合成）
 - Discord Bot（或其他 IM 通道）
 
-**系统依赖：**
-
-```bash
-# macOS
-brew install ffmpeg python3
-
-# Ubuntu/Debian
-sudo apt-get install ffmpeg python3 python3-venv
-```
-
 ### 安装步骤
 
 **方式一：npm 安装（推荐）**
@@ -46,25 +36,10 @@ npm install -g @rookiestar/eng-lang-tutor
 
 ```bash
 cd ~/.openclaw/skills/
-git clone --depth 1 --filter=blob:none --sparse https://github.com/rookiestar/Skills.git temp-skills
-cd temp-skills
-git sparse-checkout set eng-lang-tutor
-mv eng-lang-tutor ../eng-lang-tutor
-cd .. && rm -rf temp-skills
+git clone https://github.com/rookiestar/eng-lang-tutor.git
 pip install -r eng-lang-tutor/requirements.txt
 ```
 
-**手动安装依赖（如需要）：**
-
-```bash
-# 创建 Python 虚拟环境
-python3 -m venv ~/.venvs/eng-lang-tutor
-source ~/.venvs/eng-lang-tutor/bin/activate  # Linux/macOS
-
-# 安装依赖
-pip install -r ~/.openclaw/skills/eng-lang-tutor/requirements.txt
-```
-
 **验证安装：**
 
 ```bash
@@ -158,8 +133,6 @@ export XUNFEI_API_SECRET=xxx
 
 ### 语速选项
 
-在引导流程中可选择语速：
-
 | 语速 | 值 | 适用场景 |
 |------|-----|----------|
 | 非常慢 | 0.5 | 初学者跟读 |

package/README_EN.md

@@ -22,16 +22,6 @@
 - ffmpeg (for audio synthesis)
 - Discord Bot (or other IM channel)
 
-**System Dependencies:**
-
-```bash
-# macOS
-brew install ffmpeg python3
-
-# Ubuntu/Debian
-sudo apt-get install ffmpeg python3 python3-venv
-```
-
 ### Installation
 
 **Option 1: npm (Recommended)**
@@ -46,25 +36,10 @@ Installation runs automatically, skill will be installed to `~/.openclaw/skills/
 
 ```bash
 cd ~/.openclaw/skills/
-git clone --depth 1 --filter=blob:none --sparse https://github.com/rookiestar/Skills.git temp-skills
-cd temp-skills
-git sparse-checkout set eng-lang-tutor
-mv eng-lang-tutor ../eng-lang-tutor
-cd .. && rm -rf temp-skills
+git clone https://github.com/rookiestar/eng-lang-tutor.git
 pip install -r eng-lang-tutor/requirements.txt
 ```
 
-**Manual Dependency Installation (if needed):**
-
-```bash
-# Create Python virtual environment
-python3 -m venv ~/.venvs/eng-lang-tutor
-source ~/.venvs/eng-lang-tutor/bin/activate  # Linux/macOS
-
-# Install dependencies
-pip install -r ~/.openclaw/skills/eng-lang-tutor/requirements.txt
-```
-
 **Verify Installation:**
 
 ```bash
@@ -158,8 +133,6 @@ export XUNFEI_API_SECRET=xxx
 
 ### Speed Options
 
-During onboarding, you can choose speech speed:
-
 | Speed | Value | Use Case |
 |-------|-------|----------|
 | Very Slow | 0.5 | Beginner shadowing |

package/SKILL.md

@@ -1,14 +1,12 @@
 ---
 name: eng-lang-tutor
-description: |
-  地道美式英语导师 - 提供每日知识点、Quiz测验等学习内容。
-  支持游戏化学习（XP/连胜/等级/徽章）。
-  触发场景：学习英语、英语知识点、Quiz、错题本、学习进度。
-  被 cron job 调用以实现定期内容推送。
+description: "地道美式英语导师 - 提供每日知识点、Quiz测验等学习内容。支持游戏化学习（XP/连胜/等级/徽章）。触发场景：学习英语、英语知识点、Quiz、错题本、学习进度。被 cron job 调用以实现定期内容推送。【⛔重要：引导流程固定7步，显示为 Step 1/7 到 Step 7/7，绝不可显示 Step X/6】"
 ---
 
 # American English Tutor
 
+> **⛔ ONBOARDING = 7 STEPS** (Step 1/7 through Step 7/7). NEVER display "Step X/6"!
+
 ## Overview
 
 Teaches authentic American English expressions, avoiding Chinglish patterns.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rookiestar/eng-lang-tutor",
-  "version": "1.1.8",
+  "version": "1.2.0",
   "description": "English language tutor skill for OpenClaw - Learn authentic American English expressions with gamification",
   "keywords": [
     "english",

package/templates/prompts/initialization.md

@@ -314,10 +314,13 @@
 
 After user confirms with "yes" or "1", MUST execute the following bash commands to create cron jobs:
 
+**CRITICAL: Capture the current channel ID from the message context and include it in the cron job command.**
+
 ```bash
 # Parse times from schedule
 KEYPOINT_TIME="06:45"  # Default, replace with user's keypoint_time
 QUIZ_TIME="22:45"      # Default, replace with user's quiz_time
+CHANNEL_ID="<current_channel_id>"  # Get from message context (e.g., Discord channel ID)
 
 # Extract hour and minute
 KEYPOINT_HOUR=$(echo $KEYPOINT_TIME | cut -d: -f1)
@@ -325,15 +328,29 @@ KEYPOINT_MIN=$(echo $KEYPOINT_TIME | cut -d: -f2)
 QUIZ_HOUR=$(echo $QUIZ_TIME | cut -d: -f1)
 QUIZ_MIN=$(echo $QUIZ_TIME | cut -d: -f2)
 
-# Create cron jobs using openclaw
+# Create cron jobs using openclaw with channel parameter
 # Keypoint job
-${KEYPOINT_MIN} ${KEYPOINT_HOUR} * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's keypoint." --mode now
+${KEYPOINT_MIN} ${KEYPOINT_HOUR} * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's keypoint." --mode now --channel ${CHANNEL_ID}
 
 # Quiz job
-${QUIZ_MIN} ${QUIZ_HOUR} * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's quiz invitation." --mode now
+${QUIZ_MIN} ${QUIZ_HOUR} * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's quiz invitation." --mode now --channel ${CHANNEL_ID}
 ```
 
 **IMPORTANT:** The cron job creation requires:
-1. Parse user's `keypoint_time` and `quiz_time` from state.json schedule
-2. Execute the bash command to register each cron job
-3. Log the event using `state_manager.py append_event`
+1. Capture `channel_id` from the current message context (where user is doing onboarding)
+2. Save `channel_id` to `state.json schedule.channel_id`
+3. Parse user's `keypoint_time` and `quiz_time` from state.json schedule
+4. Execute the bash command to register each cron job with `--channel` parameter
+5. Log the event using `state_manager.py append_event`
+
+**State Update:**
+```json
+{
+  "schedule": {
+    "keypoint_time": "06:45",
+    "quiz_time": "22:45",
+    "timezone": "Asia/Shanghai",
+    "channel_id": "123456789012345678"
+  }
+}
+```

package/templates/state_schema.json

@@ -19,9 +19,9 @@
     "onboarding_step": {
       "type": "integer",
       "minimum": 0,
-      "maximum": 6,
+      "maximum": 7,
       "default": 0,
-      "description": "Current onboarding step (0=not started, 6=complete)"
+      "description": "Current onboarding step (0=not started, 7=complete)"
     },
     "completion_status": {
       "type": "object",
@@ -64,6 +64,11 @@
           "type": "string",
           "default": "Asia/Shanghai",
           "description": "Timezone for schedule"
+        },
+        "channel_id": {
+          "type": ["string", "null"],
+          "default": null,
+          "description": "Channel ID for scheduled pushes (captured during onboarding)"
         }
       },
       "description": "User's preferred schedule for content delivery"
@@ -153,6 +158,47 @@
         }
       }
     },
+    "tts_settings": {
+      "type": "object",
+      "description": "TTS voice and speed configuration",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether voice teaching is enabled"
+        },
+        "provider": {
+          "type": "string",
+          "enum": ["edge-tts", "xunfei"],
+          "default": "edge-tts",
+          "description": "TTS provider to use"
+        },
+        "speed": {
+          "type": "number",
+          "enum": [0.5, 0.7, 0.9, 1.3, 1.7],
+          "default": 0.9,
+          "description": "Speech speed: 0.5=very slow, 0.7=slow, 0.9=normal(recommended), 1.3=fast, 1.7=very fast"
+        },
+        "voices": {
+          "type": "object",
+          "description": "Voice mappings for different roles",
+          "properties": {
+            "narrator": {
+              "type": "string",
+              "description": "Narrator voice (female by default)"
+            },
+            "dialogue_a": {
+              "type": "string",
+              "description": "Dialogue A voice (male by default)"
+            },
+            "dialogue_b": {
+              "type": "string",
+              "description": "Dialogue B voice (female by default)"
+            }
+          }
+        }
+      }
+    },
     "progress": {
       "type": "object",
       "required": ["total_quizzes", "correct_rate", "last_study_date"],