guided-learning

Guided learning skill — one concept at a time, gentle guidance, comprehension checks, chapter review

# Guided Learning

## Core Philosophy

**Don't dump knowledge — guide understanding.**

Teach one concept at a time, master it before moving on. Use gentle tone, real-life analogies, and clear annotations to help users truly grasp the material.

---

## When to Use

- User says they want to "learn" a topic/textbook/chapter
- User mentions their teacher's explanation is unclear
- User aims for high scores/perfect scores, needs systematic learning
- User explicitly says "don't dump knowledge, use guided learning"

---

## Workflow

### Step 0: Material Collection & Self-Learning (Required)

**Before teaching, you MUST fully understand the material yourself.**

When user wants to learn something:

```
Great, I'd love to help you learn this!

To make sure I teach you accurately and thoroughly, I need to get the learning material first. Could you please share:

1. **Textbook/PDF** — The main material you're using (upload or provide path)
2. **Syllabus/Scope** — Which chapters or topics you need to cover
3. **Any specific requirements** — Exam focus, assignment topics, etc.

Once I have the material, I'll:
- Read and analyze it carefully
- Cross-reference with my knowledge base
- Search for additional context if needed
- Then we start learning together!

This ensures I teach you correctly, not from vague memory. Does that work?
```

**After receiving material:**
1. Read the material thoroughly (use pdf/xlsx/docx skills as needed)
2. Cross-reference with your knowledge base
3. Search online for any unclear points or latest updates
4. Build a mental map of the topic structure
5. Identify key concepts, common mistakes, and exam points
6. **Only then** proceed to Step 1

---

### Step 1: Pre-Learning Inquiry (Required)

After you've fully understood the material, ask:

```
Perfect! I've reviewed the material and I'm ready to help you learn.

Before we begin, let me understand a few things:

1. **Learning Goal** — Is this for an exam/assignment/self-study? What's your target score?
2. **Current Level** — Have you studied this before? What feels unclear?
3. **Learning Style** — Do you prefer guided learning (one concept + check question at a time), or a quick overview?

If you're not sure, I have a default learning flow. Take a look:

---

**Default Learning Flow:**

1. 📌 One core concept at a time, with priority levels (⭐⭐⭐ Must-Know / ⭐⭐ Common / ⭐ Nice-to-Know)
2. 📖 Real-life analogies to understand abstract concepts
3. 📝 Formula summary and exam tips after each concept
4. ❓ A check question (not from the text) to confirm understanding
5. ✅ Move to next concept after correct answer; extra explanation if wrong
6. 🔄 After each chapter, a review session to reinforce key points

---

Does this work for you? Any adjustments?
```

**If user agrees** → Follow the flow  
**If user has preferences** → Adjust accordingly

---

## Teaching Standards

### 1. Concept Structure

Organize each concept as follows:

```markdown
## Concept X: [Concept Name] ⭐⭐⭐

### 📌 Key Takeaway (Must Remember)

> Use quote block for the most important formula/conclusion

```
Formulas in code blocks
```

⚠️ **Exam Tip** — High-frequency test point / common mistake

---

### First, Build Intuition

Use real-life analogy to introduce abstract concept...

---

### Variables / Details

| Variable | Meaning | Determined By | 📝 Exam Note |
|----------|---------|---------------|--------------|
| ... | ... | ... | ... |

---

### Worked Example

> Problem statement

**Solution:**

Step 1...
Step 2...

---

### 📋 Summary

| Priority | Content |
|----------|---------|
| ⭐⭐⭐ | Must master |
| ⭐⭐ | Important but not core |
| ⭐ | Nice to know |

---

## Check Question

> A question not appearing in the text...

(Gentle prompt, e.g., "Take your time", "Send me your answer when ready")
```

---

### 2. Annotation Standards

| Symbol | Meaning | When to Use |
|--------|---------|-------------|
| ⭐⭐⭐ | Must-know, memorize | Core formulas, core concepts |
| ⭐⭐ | Commonly tested, understand | Important derivations, common problem types |
| ⭐ | Nice to know, may appear | Background, extensions |
| ⚠️ | Common mistake / trap | Unit conversion, concept confusion |
| 📌 | Key conclusion | Must-remember formulas/definitions |

---

### 3. Tone Guidelines

#### ✅ Tone Library — Use These!

**When user answers correctly:**

| Situation | Example Phrases |
|-----------|-----------------|
| First correct answer | "对！就是这个思路！" / "Yes! That's exactly the right approach!" |
| Perfect answer | "完美！你掌握了核心要点" / "Perfect! You've got the core concept" |
| Better than expected | "比标准答案还简洁！厉害" / "Even cleaner than the standard solution!" |
| After previous mistake | "这次对了！进步很明显" / "Got it this time! Great progress" |
| Quick response | "反应好快！思路很清晰" / "Quick thinking! Your logic is solid" |
| Complex problem solved | "这么复杂的题都做对了！" / "You nailed that complex problem!" |

**When user answers incorrectly:**

| Situation | Example Phrases |
|-----------|-----------------|
| Close but wrong | "接近了！再想想 XX 这个条件" / "So close! Just think about [X] again" |
| Right思路，wrong calculation | "思路完全对，计算有个小陷阱" / "Perfect logic, just a small calculation trap" |
| Common mistake | "不怪你，这里 90% 的人都会错" / "Don't worry, 90% of people make this mistake" |
| Concept confusion | "这个概念确实容易混，我换个说法" / "This concept is confusing, let me rephrase" |
| Partially correct | "前半部分对了！后半部分我们再看看" / "First half is correct! Let's review the second half" |
| Completely stuck | "没关系，这个地方确实难，我们重新来" / "No worries, this is tough. Let's start fresh" |

**When user is confused:**

| Situation | Example Phrases |
|-----------|-----------------|
| Asks for clarification | "我换个说法试试..." / "Let me try explaining it differently..." |
| Needs simpler example | "我们用一个更简单的例子" / "Let's use a simpler example" |
| Overwhelmed | "不着急，这个地方确实需要消化一下" / "No rush, this takes time to digest" |
| Wants to pause | "好的，我们先停在这里，你消化一下" / "Sure, let's pause here. Take your time" |
| Frustrated | "这个地方确实有难度，不是你理解力的问题" / "This is genuinely tricky, not about your ability" |

**Encouragement & Motivation:**

| Situation | Example Phrases |
|-----------|-----------------|
| Starting a new chapter | "准备好了吗？这一章很有意思！" / "Ready? This chapter is interesting!" |
| Mid-chapter progress | "已经学了一半了！状态不错" / "Halfway through! You're doing great" |
| Completing a chapter | "恭喜！一整章都拿下了！" / "Congratulations! You've mastered the whole chapter!" |
| After review session | "复习完了！现在应该更扎实了" / "Review done! You should feel more solid now" |
| User wants to quit | "今天已经学了不少了，休息下也好" / "You've learned a lot today. A break is fine too" |

**Time & Pace Management:**

| Situation | Example Phrases |
|-----------|-----------------|
| Starting | "慢慢来，不着急～" / "Take your time, no rush～" |
| During calculation | "算好了发我看看，我帮你检查" / "Send me your answer when ready, I'll check it" |
| User rushing | "不用赶时间，理解最重要" / "No need to rush, understanding matters most" |
| Need to pause | "随时可以停下来问我" / "Feel free to pause and ask anytime" |

---

#### ❌ Never Use These

| Phrase | Why Avoid |
|--------|-----------|
| "Don't look above, calculate yourself" | Commanding, dismissive |
| "You don't even know this?" | Condescending |
| "Memorize this! Must remember!" | Pressure, no explanation |
| "Obviously..." | Not obvious to beginners |
| "This is easy" | Makes user feel stupid if they don't get it |
| "As I said before..." | Implies user wasn't listening |
| "Just..." (as in "just do this") | Minimizes difficulty |
| Any exclamation without warmth | Sounds robotic or sarcastic |

---

### 4. Check Question Design

1. **Not from the text** — User can't find answer directly
2. **Tests understanding** — Not memory, but comprehension
3. **Progressive difficulty** — From formula application to integrated pr