| name | spk-debug |
| description | Debug root cause อย่างเป็นระบบ - วินิจฉัยก่อน ไม่แก้จนกว่าจะมีหลักฐานชัด |
| argument-hint | [bug, failing test, error output, หรือ reproduction steps] |
spk-debug
วิเคราะห์ root cause อย่างเป็นระบบก่อนที่จะลองแก้ไข
ใช้ตอน test fail, production bug, build error, regression, behavior ไม่ตามที่คาด หรือทุกสถานการณ์ที่การเดาจะเสียเวลา
รวบรวม Context
- ถ้าอยู่ใน git worktree ให้รัน
git status --short, git log -5 --oneline และ git diff --stat; ถ้าไม่ใช่ git repo ให้ข้าม git context และใช้ข้อมูลที่มีแทน
- เก็บ error output, test failure หรือ behavior ที่ไม่คาดคิดให้ครบ
Process RCA 4 ขั้น
ขั้นที่ 1: อ่าน Error และ Reproduce
- เก็บ error message, stack trace หรือ failing assertion ที่แน่นอน
- ระบุ reproduction steps ขั้นต่ำ
- ถ้า reproduce ไม่ได้ ให้ return
NEEDS_REPRO พร้อมระบุข้อมูลที่ขาด
ขั้นที่ 2: เปรียบเทียบ Pattern ที่ทำงาน
- หา code path หรือ test ที่ใกล้เคียงกันที่ทำงานปกติ
- Diff working vs. failing path เพื่อแยกจุดที่ต่าง
- เช็ค commits ล่าสุดที่น่าจะเป็นต้นเหตุ
ขั้นที่ 3: สร้างและทดสอบ Hypothesis
- เขียน hypothesis ทีละข้อ
- ทดสอบแต่ละ hypothesis ด้วย experiment ที่มุ่งเป้า (log, breakpoint, unit test)
- ทิ้ง hypothesis ที่ผิดก่อนสร้างข้อใหม่
- ถ้า 3 hypotheses ผิดแล้ว ให้ flag
POSSIBLE_ARCHITECTURE_ISSUE
ขั้นที่ 4: แนะนำ Fix
- ระบุ root cause พร้อมหลักฐาน
- ระบุ file:line ที่ได้รับผลกระทบ
- แนะนำ fix ที่เล็กที่สุด
- แนะนำ regression test ที่จะจับปัญหานี้ได้
Output Format
## Debug Report
- Error: <error หรือ behavior ที่แน่นอน>
- Root cause: <คำอธิบายที่มีหลักฐาน>
- ตำแหน่งที่ได้รับผล: <file:line list>
- Fix ที่แนะนำ: <การเปลี่ยนแปลงที่เล็กที่สุด>
- Regression test: <test ที่จะจับปัญหานี้>
- Status: <FIX_READY | NEEDS_REPRO | POSSIBLE_ARCHITECTURE_ISSUE>
ข้อควรระวัง
- ห้ามแก้ไขก่อนมีหลักฐาน root cause
- ถ้า reproduce ไม่ได้ ให้ return
NEEDS_REPRO พร้อมระบุข้อมูลที่ขาด
- ถ้าลองแก้แล้ว 3 ครั้งแล้วยังไม่ได้ ให้ flag
POSSIBLE_ARCHITECTURE_ISSUE แทนที่จะเสนอ patch ที่ 4
- อย่าแก้ source code คืน diagnosis และ next action ที่แนะนำ
- สำหรับ production data, credentials, destructive actions หรือ external services ให้หยุดและถาม operator ก่อน
