@rookiestar/eng-lang-tutor 1.1.7 → 1.1.9

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.
@@ -250,9 +248,20 @@ The bot recognizes these natural language commands:
 
 ## Initialization Flow
 
-> **CRITICAL:** You MUST follow [templates/prompts/initialization.md](templates/prompts/initialization.md) exactly. Display ALL options with numbers (1, 2, 3...). NEVER skip or abbreviate options.
-
-7-step onboarding: Welcome → CEFR Level → Topic Interests → Tutor Style → Oral/Written Ratio → Schedule → Voice Teaching → Confirm
+> **⛔ CRITICAL - TOTAL ONBOARDING STEPS = 7 (NOT 6!)**
+>
+> You MUST display step titles as **"Step 1/7"**, **"Step 2/7"**, etc. (NOT "Step 1/6"!)
+>
+> The 7 steps are:
+> 1. CEFR Level
+> 2. Topic Interests
+> 3. Tutor Style
+> 4. Oral/Written Ratio
+> 5. Schedule
+> 6. **Voice Teaching** ← THIS IS THE NEW STEP!
+> 7. Confirm
+>
+> Follow [templates/prompts/initialization.md](templates/prompts/initialization.md) exactly. Display ALL options with numbers (1, 2, 3...). NEVER skip or abbreviate options.
 
 **Step 7 Completion:** Set `initialized=true` + Create cron jobs for keypoint/quiz push times.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rookiestar/eng-lang-tutor",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "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"],