| name | spk-scoped-tests |
| description | รันเฉพาะ test suites ที่ได้รับผลกระทบจากไฟล์ที่เปลี่ยน โดย map ไฟล์ที่เปลี่ยนไปยัง suites ที่เกี่ยวข้อง และถ้า map ไม่ได้แน่ชัดให้ fallback ไปรันทั้งชุด |
| argument-hint | [ไม่บังคับ: ระบุ paths ที่เปลี่ยนเอง; ค่าเริ่มต้นคือ git diff เทียบ HEAD] |
spk-scoped-tests
เร่ง inner loop ด้วยการรันเฉพาะ test suites ที่การเปลี่ยนแปลงปัจจุบันมีผลกระทบ แทนที่จะรันทั้งชุดทุกครั้งที่แก้ ใช้ตอนทำ TDD หรือ implement ทีละขั้นเมื่อการรันทั้งชุดช้า แต่ต้องรันทั้งชุดก่อนปิดงานเสมอ
ทำ workflow นี้โดยตรงใน conversation ปัจจุบัน
รวบรวม Context
- ถ้าอยู่ใน git worktree ให้ดูไฟล์ที่เปลี่ยนด้วย
git diff --name-only HEAD; ถ้าไม่ใช่ git repo ให้ระบุ paths ที่เปลี่ยนเอง
- ตรวจ test runner ของ project:
package.json ที่มี jest → Jest, pyproject.toml/pytest.ini → pytest, go.mod → go test
Workflow
1. หา packaged planner
หารากชุดติดตั้งจาก metadata หรือตัวแปรรากที่ host ให้ แล้วใช้ scripts/scoped-tests.cjs ใต้รากนั้น ห้ามเลือกไฟล์ชื่อเดียวกันใน repo ของ user ก่อน
2. รวบรวมไฟล์ที่เปลี่ยน
ถ้า user ระบุ paths ให้ใช้ paths นั้น ไม่งั้นใช้ทั้ง tracked และ untracked changes ของ repo ถ้าอยู่นอก git worktree ต้องระบุ paths เอง
3. สร้างแผนแบบ structured
จาก project cwd รัน node <install-root>/scripts/scoped-tests.cjs -- <path>... helper จะคืน JSON schema spk.scoped-tests/v1 ที่มี mode, runner, selected, unmapped, focused และ full ใช้ command กับ args เป็น argv array ห้ามต่อเป็น shell string
4. รันอย่างปลอดภัย
mode: scoped → รัน focused.command พร้อม focused.argsmode: full → อธิบายเหตุผล fallback แล้วรัน fullmode: blocked → รายงาน runner ที่ขาด/ไม่รองรับแล้วหยุด
5. รายงาน scope ตามจริง
รายงาน changed paths, selected inputs, unmapped paths, command/argv, exit status และบอกว่าเป็น scoped หรือ full
6. รันทั้งชุดก่อนปิดงาน
scoped pass เป็นเพียง inner-loop signal ก่อนสรุป implementation ว่าเสร็จต้องรันคำสั่ง full ที่ helper คืนมา
ข้อควรระวัง
- ห้ามรันบางส่วนเงียบ ๆ — changed path ที่ map ไม่ได้แม้แต่ไฟล์เดียวต้อง fallback ทั้งชุด
- ห้ามรัน shell string ที่ประกอบจากข้อมูลใน repo ให้ใช้ command + args แยกกัน
- การรันแบบ scope ไม่ใช่ release gate;
npm run verify:release ยังรันทั้งหมดอยู่
- ใช้ได้นอก git worktree เฉพาะเมื่อระบุ paths ที่เปลี่ยนเอง
