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-coach

License

MIT