English Coach 🎯
ติวเตอร์ภาษาอังกฤษรายวันที่รันใน Claude CLI — ฝึกเป็นบทสนทนาในแชต จำความคืบหน้าข้ามวัน ทบทวนแบบ spaced repetition (FSRS) และ ประเมินระดับแบบตรงไปตรงมา (no-bias) เทียบ CEFR / IELTS พร้อมแดชบอร์ดสรุปเป็นไฟล์ HTML
> A self-tracking daily English tutor for the Claude CLI: adaptive sessions, FSRS spaced repetition, > honest (no-bias) CEFR/IELTS evaluation, and an HTML progress dashboard. Built for a Thai learner.
---
เริ่มใช้ (Quick start)
ต้องมี Node.js (เครื่องนี้มีแล้ว) — สคริปต์ไม่มี dependency ใดๆ
1. เปิด Claude CLI ในโฟลเดอร์นี้ (claude ในไดเรกทอรีนี้) — คำสั่ง /english* จะใช้ได้ทันที ไม่ต้องติดตั้งอะไร 2. วันแรก: พิมพ์ /english-test → ทำแบบทดสอบจัดระดับ (~10 นาที) ระบบจะตั้งระดับ + โหมดให้อัตโนมัติ 3. ทุกวันถัดไป: พิมพ์ /english → ฝึกวันละ ~12–15 นาที 4. อยากรู้ว่าตอนนี้อยู่ระดับไหนจริงๆ: /english-eval 5. เปิดดูความคืบหน้า: เปิดไฟล์ progress/dashboard.html (คลิกเอง)
คำสั่ง (Commands)
| คำสั่ง | ทำอะไร | |--------|--------| | /english-test | แบบทดสอบจัดระดับ (no-bias) — ทำครั้งแรก แล้วทวนทุกเดือน | | /english | เซสชันหลักประจำวัน — ทบทวน + โฟกัสหมุนเวียน + อ่าน + บันทึก | | /english-quick | โหมดสั้น ~5 นาที (วันยุ่ง รักษา streak) | | /english-write | เน้นเขียน — เขียนแล้วได้ feedback ละเอียด เก็บไฟล์ไว้ | | /english-eval | รายงานระดับรายทักษะ เทียบ CEFR + IELTS/TOEIC แบบ no-bias |
แนวคิด (Design, evidence-based)
- สั้นแต่ทุกวัน ดีกว่ายาวแต่นานๆ ที — ~12–15 นาที/วัน
- มือใหม่โฟกัสทีละด้าน (blocked) ก่อน แล้วค่อย สลับหลายด้าน (interleaved) เมื่อถึง B1
- FSRS จัดเวลาทบทวนคำ/ไวยากรณ์/จุดผิดให้พอดีก่อนลืม
- อ่าน input ระดับ i+1 เป็นฐานทุกวัน
- ประเมินแบบ no-bias: ยึด can-do ของ CEFR, อ้างหลักฐานจริง, ก้ำกึ่งให้ปัดลง, แยก "ระดับที่ทำได้สม่ำเสมอ" กับ "เพดานวันดีๆ"
ความคืบหน้า & ความเป็นส่วนตัว (Progress & privacy)
ข้อมูลส่วนตัวทั้งหมดอยู่ใน progress/ ซึ่ง ถูก gitignore — ระดับ งานเขียน และจุดอ่อนของคุณ
ไม่ถูก commit ขึ้น GitHub repo จึงแชร์เป็น public ได้อย่างปลอดภัย (คนอื่น clone ไปเริ่มของตัวเองสะอาดๆ)
progress/
├─ profile.json # ระดับ, mode, difficulty, streak, เป้าหมาย
├─ review-deck.json # การ์ด FSRS (คำ/ไวยากรณ์/จุดผิด)
├─ log.jsonl # บันทึกแต่ละเซสชัน + corrections
├─ evaluations.json # ผลประเมินย้อนหลัง
├─ writing/ # งานเขียน + feedback
└─ dashboard.html # แดชบอร์ด (เปิดเอง)โครงสร้าง (Project structure)
.claude/commands/ 5 slash commands
.claude/skills/ english-coach skill (auto-trigger)
.claude/settings.json SessionStart reminder hook
scripts/coach.mjs JSON store + FSRS + analytics + goal/ETA (Node, zero-dep)
scripts/dashboard.mjs renders progress/dashboard.html
reference/ syllabus.md, bands.md (CEFR/IELTS + no-bias protocol)สคริปต์เรียกเองก็ได้: node scripts/coach.mjs status · node scripts/dashboard.mjs
ติดตั้งเป็น plugin (optional)
ใช้ในโฟลเดอร์นี้ได้เลยไม่ต้องติดตั้ง สำหรับใช้ข้ามโปรเจกต์/แชร์เป็น Claude Code plugin:
/plugin marketplace add <your-github-repo>
/plugin install english-coachLicense
MIT
