Create Tech Lecture Skill

Skill hỗ trợ giảng viên CNTT tạo bài viết kỹ thuật chuyên sâu nhưng dễ hiểu.

Quy trình tư duy sư phạm (Pedagogical Flow)

flowchart LR
    A[🎣 Hook] --> B[🔄 Analogy]
    B --> C[🔬 Deep Dive]
    C --> D[📊 Visual]
    D --> E[💻 Practice]
    E --> F[⚠️ Pitfalls]

1. •Hook (Thu hút): Bắt đầu bằng vấn đề thực tế hoặc câu hỏi gợi mở
2. •Analogy (Ẩn dụ): Giải thích concept bằng hình ảnh đời thường TRƯỚC KHI đi vào kỹ thuật
3. •Technical Deep Dive: Phân tích kiến trúc, code, luồng dữ liệu
4. •Visual (Trực quan): Sơ đồ hóa bằng Mermaid
5. •Practice (Thực hành): Code mẫu với chú thích
6. •Pitfalls (Cảnh báo): Lỗi thường gặp + Best Practices

Phân loại bài viết

Quy tắc trình bày Code

File Naming

// ✅ filename: src/services/auth.service.ts
export class AuthService { ... }

Comment WHY, not WHAT

# ❌ Sai: Khai báo biến x
x = 10

# ✅ Đúng: Giới hạn retry để tránh vòng lặp vô tận khi API không phản hồi
MAX_RETRIES = 10

Snippet thay vì Full Code

// ... (các import statements)

func main() {
    // 👇 Đây là phần quan trọng cần giải thích
    router := gin.Default()
    router.GET("/ping", pingHandler)
    
    // ... (phần còn lại)
}

Văn phong bắt buộc

• •Analogy First: Mọi concept mới PHẢI có ẩn dụ đời sống
• •Giải thích thuật ngữ ngay lần đầu xuất hiện
• •Paragraph ngắn: Tối đa 4-5 dòng/đoạn
• •Sử dụng emoji để đánh dấu mục quan trọng (⚠️, ✅, ❌, 💡)
• •Trade-off rõ ràng: Luôn chỉ ra đánh đổi của giải pháp

Mermaid Diagram Types