@rookiestar/eng-lang-tutor 1.1.5 → 1.1.7

package/SKILL.md

@@ -250,15 +250,15 @@ The bot recognizes these natural language commands:
 
 ## Initialization Flow
 
-> See [templates/prompts/initialization.md](templates/prompts/initialization.md) for detailed onboarding templates.
+> **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.
 
-6-step onboarding: Welcome → CEFR Level → Topic Interests → Tutor Style → Oral/Written Ratio → Schedule → Confirm
+7-step onboarding: Welcome → CEFR Level → Topic Interests → Tutor Style → Oral/Written Ratio → Schedule → Voice Teaching → Confirm
 
-**Step 6 Completion:** Set `initialized=true` + Create cron jobs for keypoint/quiz push times.
+**Step 7 Completion:** Set `initialized=true` + Create cron jobs for keypoint/quiz push times.
 
 **State Fields:**
 - `initialized`: Boolean - Whether user completed onboarding
-- `onboarding_step`: Integer (0-6) - Current step
+- `onboarding_step`: Integer (0-7) - Current step
 
 ---
 

package/package.json

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

package/templates/prompt_templates.md

@@ -20,7 +20,7 @@ This documentation has been split into focused modules for easier navigation:
 |------|---------|
 | [prompts/keypoint_generation.md](prompts/keypoint_generation.md) | Knowledge point generation template, topic resources |
 | [prompts/quiz_generation.md](prompts/quiz_generation.md) | Quiz generation template with question types |
-| [prompts/initialization.md](prompts/initialization.md) | 6-step onboarding flow templates |
+| [prompts/initialization.md](prompts/initialization.md) | 7-step onboarding flow templates |
 
 ### Display Templates
 | File | Purpose |

package/templates/prompts/initialization.md

@@ -1,10 +1,16 @@
 # Initialization Flow Templates
 
-> Templates for the 6-step onboarding process when a new user starts.
+> Templates for the 7-step onboarding process when a new user starts.
 
 **Related Files:**
 - [shared_enums.md](shared_enums.md) - CEFR levels, topics, tutor styles
 
+**IMPORTANT Display Rules:**
+- Every step MUST display ALL options with numbers (1, 2, 3...)
+- Every step MUST show the recommended/default option clearly
+- Model MUST NOT skip any options or abbreviate the list
+- User can reply with number or text (both should work)
+
 ---
 
 ## Step 0: Welcome Message
@@ -31,19 +37,27 @@
   "type": "init_cefr",
   "step": 1,
   "display": {
-    "title": "📊 Step 1/5: Your English Level",
+    "title": "📊 Step 1/7: Your English Level",
     "message": "What's your current English level?",
     "options": [
-      "**A1-A2**: Beginner - Basic conversations, everyday words",
-      "**B1-B2**: Intermediate - Work conversations, some idioms",
-      "**C1-C2**: Advanced - Complex topics, nuanced expressions"
+      "**1.** A1-A2 - Beginner: Basic conversations, everyday words",
+      "**2.** B1-B2 - Intermediate: Work conversations, some idioms ⭐ Recommended",
+      "**3.** C1-C2 - Advanced: Complex topics, nuanced expressions"
     ],
-    "prompt": "Reply with your level (e.g., **B1**, **B2**, **C1**)",
+    "default": "B1",
+    "prompt": "Reply with a number (1-3) or level (e.g., **2** or **B1**)",
     "hint": "💡 Not sure? Most working professionals are B1-B2. You can change this later."
   }
 }
 ```
 
+**Input Mapping:**
+| User Input | Value |
+|------------|-------|
+| 1, A1, A2, beginner | A2 |
+| 2, B1, B2, intermediate | B1 |
+| 3, C1, C2, advanced | C1 |
+
 ---
 
 ## Step 2: Topic Preferences
@@ -53,23 +67,35 @@
   "type": "init_topics",
   "step": 2,
   "display": {
-    "title": "🎯 Step 2/5: Your Interests",
-    "message": "Which topics interest you most?",
-    "topics": [
-      "🎬 movies - TV shows, films",
-      "📰 news - Current events",
-      "🎮 gaming - Video games",
-      "⚽ sports - Sports & fitness",
-      "🏢 workplace - Office & business",
-      "💬 social - Friends & parties",
-      "🏠 daily_life - Shopping, restaurants"
+    "title": "🎯 Step 2/7: Your Interests",
+    "message": "Which topics interest you most? (Select multiple)",
+    "options": [
+      "**1.** 🎬 movies - TV shows, films",
+      "**2.** 📰 news - Current events",
+      "**3.** 🎮 gaming - Video games",
+      "**4.** ⚽ sports - Sports & fitness",
+      "**5.** 🏢 workplace - Office & business ⭐ Popular",
+      "**6.** 💬 social - Friends & parties",
+      "**7.** 🏠 daily_life - Shopping, restaurants"
     ],
-    "prompt": "List your interests (e.g., **movies workplace gaming**)",
-    "example": "Example: **movies workplace gaming**"
+    "default": "workplace, social, daily_life",
+    "prompt": "Reply with numbers (e.g., **1 5 6** or **movies workplace social**)",
+    "hint": "💡 Select 2-4 topics. Popular combo: 5 6 7 (workplace + social + daily_life)"
   }
 }
 ```
 
+**Input Mapping:**
+| User Input | Value |
+|------------|-------|
+| 1, movies | movies |
+| 2, news | news |
+| 3, gaming | gaming |
+| 4, sports | sports |
+| 5, workplace | workplace |
+| 6, social | social |
+| 7, daily, daily_life | daily_life |
+
 ---
 
 ## Step 3: Tutor Style
@@ -79,19 +105,28 @@
   "type": "init_style",
   "step": 3,
   "display": {
-    "title": "🎭 Step 3/5: Tutor Style",
+    "title": "🎭 Step 3/7: Tutor Style",
     "message": "How should I teach you?",
     "options": [
-      "😄 **humorous** - Fun examples, jokes, pop culture",
-      "📚 **rigorous** - Detailed explanations, grammar focus",
-      "😎 **casual** - Short & sweet, everyday language",
-      "👔 **professional** - Business-focused, formal contexts"
+      "**1.** 😄 humorous - Fun examples, jokes, pop culture ⭐ Recommended",
+      "**2.** 📚 rigorous - Detailed explanations, grammar focus",
+      "**3.** 😎 casual - Short & sweet, everyday language",
+      "**4.** 👔 professional - Business-focused, formal contexts"
     ],
-    "prompt": "Reply with: **humorous**, **rigorous**, **casual**, or **professional**"
+    "default": "humorous",
+    "prompt": "Reply with a number (1-4) or style name (e.g., **1** or **humorous**)"
   }
 }
 ```
 
+**Input Mapping:**
+| User Input | Value |
+|------------|-------|
+| 1, humorous, funny | humorous |
+| 2, rigorous, serious | rigorous |
+| 3, casual, relaxed | casual |
+| 4, professional, formal | professional |
+
 ---
 
 ## Step 4: Oral/Written Ratio
@@ -101,18 +136,28 @@
   "type": "init_ratio",
   "step": 4,
   "display": {
-    "title": "💬 Step 4/5: Speaking vs Writing",
+    "title": "💬 Step 4/7: Speaking vs Writing",
     "message": "What do you want to focus on?",
     "options": [
-      "🗣️ **Mostly speaking** - Daily conversations, casual chat",
-      "⚖️ **Balanced** - Mix of speaking and writing",
-      "✍️ **Mostly writing** - Emails, formal documents"
+      "**1.** 🗣️ Mostly speaking (80%) - Daily conversations, casual chat",
+      "**2.** ⚖️ Balanced (50%) - Mix of speaking and writing",
+      "**3.** ✍️ Mostly writing (20%) - Emails, formal documents"
     ],
-    "prompt": "Reply with a number 0-100 for speaking focus (e.g., **70** = 70% speaking)"
+    "default": "70",
+    "prompt": "Reply with a number (1-3) or percentage 0-100 (e.g., **1** or **70**)",
+    "hint": "💡 Recommended: 70% speaking (most learners want to speak better)"
   }
 }
 ```
 
+**Input Mapping:**
+| User Input | Value |
+|------------|-------|
+| 1, mostly speaking | 80 |
+| 2, balanced | 50 |
+| 3, mostly writing | 20 |
+| 0-100 (number) | that number |
+
 ---
 
 ## Step 5: Schedule Configuration
@@ -122,18 +167,30 @@
   "type": "init_schedule",
   "step": 5,
   "display": {
-    "title": "⏰ Step 5/5: Schedule Your Learning",
+    "title": "⏰ Step 5/7: Schedule Your Learning",
     "message": "When should I send you daily content?",
+    "options": [
+      "**1.** Morning person: Keypoint 06:45, Quiz 22:45 ⭐ Recommended",
+      "**2.** Late riser: Keypoint 08:00, Quiz 23:00",
+      "**3.** Custom times (you specify)"
+    ],
     "defaults": {
-      "keypoint": "☀️ **Keypoint** (morning lesson): Default **06:45**",
-      "quiz": "🌙 **Quiz** (evening practice): Default **22:45**"
+      "keypoint": "06:45",
+      "quiz": "22:45"
     },
-    "prompt": "Reply with times in 24-hour format (e.g., **07:00 21:30**) or press Enter for defaults.",
-    "hint": "💡 Quiz time must be later than keypoint time. Example: '07:00 21:30' or just press Enter for defaults."
+    "prompt": "Reply with a number (1-3) or custom times (e.g., **1** or **07:00 21:30**)",
+    "hint": "💡 Quiz time must be later than keypoint time. Press Enter for defaults."
   }
 }
 ```
 
+**Input Mapping:**
+| User Input | Keypoint | Quiz |
+|------------|----------|------|
+| 1, default, enter | 06:45 | 22:45 |
+| 2, late | 08:00 | 23:00 |
+| 3, HH:MM HH:MM | first time | second time |
+
 **Validation Rules:**
 - Both times must be in HH:MM format (24-hour)
 - Quiz time must be later than keypoint time
@@ -142,12 +199,72 @@
 
 ---
 
-## Step 6: Confirmation
+## Step 6: Voice Teaching Configuration
 
 ```json
 {
-  "type": "init_confirm",
+  "type": "init_voice",
   "step": 6,
+  "display": {
+    "title": "🔊 Step 6/7: Voice Teaching",
+    "message": "Would you like audio versions of knowledge points for listening practice?",
+    "options": [
+      "**1.** 🔊 Yes - Enable voice teaching ⭐ Recommended",
+      "**2.** 🔇 No - Text only, no audio"
+    ],
+    "speed_options": {
+      "description": "If yes, choose your preferred speech speed:",
+      "options": [
+        "**1.** Very slow (0.5x) - Beginner shadowing",
+        "**2.** Slow (0.7x) - Learning pronunciation",
+        "**3.** Normal (0.9x) - Daily learning ⭐ Recommended",
+        "**4.** Fast (1.3x) - Listening challenge",
+        "**5.** Very fast (1.7x) - Advanced training"
+      ]
+    },
+    "default": "yes 3",
+    "prompt": "Reply with **1** or **2**. If yes, also pick speed (e.g., **1** or **1 3** or **yes 3**)",
+    "hint": "💡 Recommended: Yes with normal speed (option 3). Great for commute listening!"
+  }
+}
+```
+
+**Input Mapping:**
+| User Input | Enabled | Speed |
+|------------|---------|-------|
+| 1, yes, y | true | 0.9 (default) |
+| 2, no, n | false | - |
+| 1 3, yes 3 | true | 0.9 |
+| 1 1, yes 1 | true | 0.5 |
+| 1 2, yes 2 | true | 0.7 |
+| 1 4, yes 4 | true | 1.3 |
+| 1 5, yes 5 | true | 1.7 |
+
+**State Update:**
+```json
+{
+  "tts_settings": {
+    "enabled": true,
+    "provider": "edge-tts",
+    "speed": 0.9,
+    "voices": {
+      "narrator": null,
+      "dialogue_a": null,
+      "dialogue_b": null
+    }
+  }
+}
+```
+- If `voices` values are null, use provider defaults
+
+---
+
+## Step 7: Confirmation
+
+```json
+{
+  "type": "init_confirm",
+  "step": 7,
   "display": {
     "title": "✅ All Set! Here's Your Profile:",
     "summary": {
@@ -155,14 +272,23 @@
       "topics": "🎯 Topics: {top_topics}",
       "style": "🎭 Style: {tutor_style}",
       "focus": "💬 Focus: {oral_ratio}% speaking",
-      "schedule": "⏰ Schedule: Keypoint at {keypoint_time}, Quiz at {quiz_time}"
+      "schedule": "⏰ Schedule: Keypoint at {keypoint_time}, Quiz at {quiz_time}",
+      "voice": "🔊 Voice: {voice_status}"
     },
-    "prompt": "Does this look right? Reply **yes** to confirm or **change** to adjust.",
+    "options": [
+      "**1.** ✅ Yes, confirm and start learning",
+      "**2.** ✏️ Change something"
+    ],
+    "prompt": "Reply with **1** or **yes** to confirm, or **2** to adjust.",
     "footer": "───────────────────\n🚀 Your first lesson starts tomorrow!"
   }
 }
 ```
 
+**Voice Status Display:**
+- If enabled: "Enabled, {speed_desc} speed"
+- If disabled: "Disabled (text only)"
+
 ---
 
 ## Completion
@@ -184,9 +310,9 @@
 
 ---
 
-## Cron Job Creation (after Step 6 confirmation)
+## Cron Job Creation (after Step 7 confirmation)
 
-After user confirms with "yes", MUST execute the following bash commands to create cron jobs:
+After user confirms with "yes" or "1", MUST execute the following bash commands to create cron jobs:
 
 ```bash
 # Parse times from schedule