# Troubleshooting

ใช้ไฟล์นี้เมื่อ Claude Code หรือ plugin ไม่ทำงานตามที่คาด

## Quick Runbook

1. หยุด workflow ก่อน อย่า approve คำสั่งเพิ่ม
2. เก็บ prompt, command, path ปัจจุบัน, error message และไฟล์ที่ถูกแก้
3. แยกสาเหตุ: path, permission, context, version, API key, network หรือ prompt ไม่ชัด
4. แก้ทีละจุด
5. ทดสอบด้วย prompt อ่าน-only ก่อนกลับไปรันกับไฟล์จริง
6. อัปเดต plugin/playbook ถ้าปัญหานั้นมีโอกาสเกิดซ้ำ

## ปัญหา: ไม่เห็น command

ตรวจ:

- เปิด Claude Code จาก root project ถูกที่หรือไม่
- command อยู่ใน `.claude/commands` หรือ `~/.claude/commands`
- ไฟล์ command เป็น `.md`
- ชื่อไฟล์และ path ไม่มี typo
- restart Claude Code แล้วหรือยัง

## ปัญหา: Claude ตอบไม่ตรงงาน

สาเหตุที่พบบ่อย:

- context ไม่พอ
- output format ไม่ชัด
- ข้อจำกัดหรือข้อห้ามไม่ถูกระบุ
- ไม่มีตัวอย่าง output ที่ดี

วิธีแก้:

- เพิ่มไฟล์อ้างอิงหรือข้อมูลประกอบ
- ขอให้ Claude ถามกลับเมื่อข้อมูลไม่พอ
- ระบุ output contract เช่น summary, risks, checklist, next steps
- ให้ตัวอย่างผลลัพธ์ที่ต้องการ 1-2 ชุด

## ปัญหา: Claude แก้ไฟล์กว้างเกินไป

วิธีลดความเสี่ยง:

- ระบุ scope เป็นไฟล์เดียวหรือ module เดียว
- ขอแผนก่อนแก้
- ให้ Claude สรุปไฟล์ที่จะเปลี่ยนก่อนลงมือ
- ตรวจ diff ก่อน accept ทุกครั้ง
- commit งานก่อนทดลอง workflow ใหญ่

## ปัญหา: Permission หรือ command เสี่ยง

อย่า approve ถ้า:

- เป็นคำสั่งลบไฟล์จำนวนมาก
- เป็น `git reset`, `git checkout`, หรือคำสั่งที่ย้อนงานโดยไม่ตั้งใจ
- อ่าน/ส่ง secret หรือไฟล์ env โดยไม่จำเป็น
- ติดตั้ง dependency จากแหล่งที่ไม่รู้จัก

## Troubleshooting Report Template

```text
Issue:
Command/prompt used:
Current folder:
Expected result:
Actual result:
Files changed:
Risk level:
Next action:
Owner:
Date:
```