เป้าหมาย
ใช้ Stop hook ตรวจงานด้วยคำสั่งจริง (เช่น เทสต์) ทุกครั้งที่ Claude จะจบเทิร์น ถ้ายังไม่ผ่านให้ส่งผลกลับไปให้แก้ต่อ พร้อมเพดานที่กันไม่ให้วนไม่รู้จบ และรู้ว่าเมื่อไรควรใช้ /goal แทน
หลักการ
ปัญหา: โมเดลมักบอกว่าเสร็จเร็วเกินไป
ใน loop ที่ไม่มีคนเฝ้า คำว่า "เสร็จแล้ว ✅" จากโมเดลไม่มีความหมาย ถ้าไม่มีอะไรตรวจ สิ่งที่ต้องการคือ ตัวตรวจที่ไม่ใช่โมเดลตัวเดียวกับที่ทำงาน
Stop hook ทำงานยังไง (ต่อจากบท 6d-04)
- ทำงานทุกครั้งที่ Claude จบเทิร์นตามปกติ (ไม่ทำงานเมื่อผู้ใช้กดขัดจังหวะ) และทำงานในโหมด
claude -pด้วย - ได้ JSON ทาง stdin มีฟิลด์
session_id,cwd,last_assistant_messageและstop_hook_active(เป็นtrueถ้ารอบนี้เกิดจากการที่ Stop hook บล็อกไปแล้ว) - ไม่ให้หยุด: พิมพ์
{"decision": "block", "reason": "..."}แล้ว exit 0 (ต้องมีreasonเพราะ Claude จะได้อ่านเป็นคำสั่งว่าต้องทำอะไรต่อ) หรือ exit 2 พร้อมเหตุผลทาง stderr - ให้หยุด: exit 0 โดยไม่พิมพ์อะไร
เพดานกันวนไม่รู้จบ (ต้องมีทุกครั้ง)
- ของเราเอง: นับจำนวนครั้งที่บล็อกต่อ session (stop-check.sh ใช้ไฟล์นับ ค่าเริ่ม 3 ครั้ง) ครบแล้วปล่อยให้หยุด และให้ loop.sh รู้เองว่ารอบนี้ไม่มี commit
- ของ Claude Code: ถ้า Stop hook บล็อกติดกัน 8 ครั้งโดยที่ Claude ไม่ได้เรียก tool เลย ระบบจะจบเทิร์นเอง (ปรับได้ด้วย env
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP) — เป็นตาข่ายสุดท้าย อย่าพึ่งมันอย่างเดียว
แนวทางที่ง่ายกว่าคือ if stop_hook_active == true → ปล่อยให้หยุด ซึ่งบล็อกได้แค่ครั้งเดียว ส่วน stop-check.sh เลือกนับจำนวนครั้ง เพื่อให้ Claude มีโอกาสแก้ได้ 2–3 รอบ
/goal vs Stop hook vs /loop
| เริ่มเทิร์นถัดไปเมื่อ | หยุดเมื่อ | เหมาะกับ | |
|---|---|---|---|
/goal |
จบเทิร์นก่อนหน้า | โมเดลเล็กตัดสินว่าเงื่อนไขครบ / เป็นไปไม่ได้ | เงื่อนไขที่อธิบายเป็นภาษาคนได้ ใช้เฉพาะ session นี้ |
| Stop hook | จบเทิร์นก่อนหน้า | สคริปต์ของเราตัดสิน (exit code จริง) | เงื่อนไขที่เครื่องตรวจได้แน่นอน ใช้ซ้ำทุก session ที่โหลดไฟล์ |
/loop |
ครบเวลาที่ตั้ง | เราสั่งหยุด หรือ Claude ตัดสินว่าเสร็จ | งานเฝ้าดูเป็นระยะ (บท 7d-04) |
/goal เบื้องหลังก็คือ Stop hook แบบ prompt ที่ระบบสร้างให้ชั่วคราว ใช้คู่กันได้: Stop hook ตรวจเทสต์ และ /goal ตรวจเงื่อนไขภาพรวม
ตั้งค่า ⚙️
ใส่ hook ไว้ที่ไหน
ถ้าใส่ใน .claude/settings.json hook จะทำงานกับ ทุก session ในโปรเจกต์ รวมตอนคุณคุยเล่นแบบ interactive (ถามอะไรนิดเดียวก็ต้องรอเทสต์) สำหรับ loop ให้แยกไฟล์เป็น .claude/loop-hooks.json แล้วส่งเข้าไปด้วย --settings เฉพาะตอนรัน loop — loop.sh ทำแบบนี้ให้แล้ว (ตัวแปร HOOKS)
⚠️
--bare(บท 6d-06) ข้าม hooks ที่ค้นพบจากโปรเจกต์ทั้งหมด loop ในบทนี้รันบน repo ของคุณเอง จึงไม่ใช้--bareแต่ระบุ hook ด้วย--settingsแทน · ถ้ารันกับ repo ของคนอื่น ให้อ่าน.claude/ทุกไฟล์ก่อนเสมอ
ค่าที่ปรับได้
| ตั้งอะไร | ค่าเริ่ม | เปลี่ยนเมื่อไร | ตรวจยังไง |
|---|---|---|---|
MAX_BLOCKS (env ของ stop-check.sh) |
3 ครั้งต่อ session | งานที่ต้องแก้หลายจุดกว่าจะผ่าน → 4–5 · อยากให้บล็อกครั้งเดียวพอ → 1 | ทดลอง A: ครั้งที่ MAX_BLOCKS+1 ต้องไม่มี output |
TEST_CMD (env) |
npm test |
โปรเจกต์ใช้คำสั่งอื่น เช่น pytest -q · เทสต์ช้า → ใช้เฉพาะชุดที่เร็ว |
ทดลอง A ด้วยค่าใหม่ |
timeout ใน loop-hooks.json |
300 วินาที (ถ้าไม่ใส่ Claude Code ใช้ 600 สำหรับ command hook) | ตั้งให้มากกว่าเวลาเทสต์ทั้งชุดเล็กน้อย | เทสต์ไม่ถูกตัดกลางคัน |
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP |
8 ครั้งติดกันที่ไม่มี tool call | แทบไม่ต้องแตะ — ใช้ MAX_BLOCKS ของเราคุมแทน |
— |
| ปิด hook ทุกตัวชั่วคราว | — | สงสัยว่า hook ทำให้ช้าหรือวน | รันด้วย --settings '{"disableAllHooks": true}' แล้วเทียบผล |
→ hook ที่ใส่ใน settings ของโปรเจกต์หรือผู้ใช้ ดูได้ว่าโหลดมาจากไฟล์ไหนด้วย /hooks ใน session แบบ interactive · ส่วน hook ที่ส่งผ่าน --settings ตรวจด้วยทดลอง A/B
ลองเลย 🧪
ทดลอง A — ทดสอบ hook นอก Claude ก่อน (ใน repo loop-lab จากบท 7d-02 · ดาวน์โหลด stop-check.sh และ loop-hooks.json ด้านบนไว้ในโฟลเดอร์นั้น)
mkdir -p .claude/hooks
mv stop-check.sh .claude/hooks/ && chmod +x .claude/hooks/stop-check.sh
mv loop-hooks.json .claude/
# เทสต์ผ่าน → ต้องไม่พิมพ์อะไร และ exit=0
echo '{"session_id":"t1","cwd":"'"$PWD"'"}' | .claude/hooks/stop-check.sh; echo "exit=$?"
# ทำเทสต์ให้พัง → ต้องได้ JSON decision=block พร้อมผลเทสต์
cat > test/broken.test.js <<'EOF'
import { test } from "node:test"; import assert from "node:assert";
test("broken on purpose", () => assert.equal(1 + 1, 3));
EOF
echo '{"session_id":"t2","cwd":"'"$PWD"'"}' | .claude/hooks/stop-check.sh | jq .decision→ ผลที่ควรได้: ครั้งแรก exit=0 ครั้งที่สอง "block" · รันคำสั่งสุดท้ายซ้ำอีก 3 ครั้ง ครั้งที่ 4 ต้องไม่มี output (ครบเพดาน ปล่อยให้หยุด)
ทดลอง B — ดู hook ทำงานจริงใน headless (ยังเก็บ test/broken.test.js ไว้)
claude -p "ตอบแค่ว่า ok ห้ามแก้ไฟล์ใดๆ" \
--settings .claude/loop-hooks.json \
--permission-mode dontAsk --allowedTools "Read" \
--max-turns 12 --max-budget-usd 0.8 \
--output-format json < /dev/null | jq '{subtype, num_turns, result}'→ ผลที่ควรได้: num_turns มากกว่า 1 (ถูกบล็อกให้ทำต่อ) และ result ที่ Claude อธิบายว่าเทสต์ broken on purpose ผ่านไม่ได้ถ้าไม่แก้เทสต์ ซึ่งทั้ง hook และคำสั่งห้ามไว้ — ตัวอย่างนี้แสดงว่า reason ที่ดีกันการโกงได้
→ ลบ test/broken.test.js แล้วรันซ้ำ ต้องจบใน 1 เทิร์น
ทดลอง C — ใส่ใน loop รัน ./loop.sh อีกครั้งพร้อมงานใหม่ใน PROGRESS.md · loop.sh เจอ .claude/loop-hooks.json แล้วส่ง --settings ให้อัตโนมัติ ถ้าตั้ง TEST_CMD ไว้ (เช่น TEST_CMD="pytest -q" ./loop.sh) stop-check.sh จะใช้คำสั่งนั้นแทน npm test
ถ้าพัง
| อาการ | สาเหตุที่พบบ่อย |
|---|---|
| hook ไม่ทำงาน | ลืม chmod +x, path ใน loop-hooks.json ไม่ตรง ($CLAUDE_PROJECT_DIR/.claude/hooks/stop-check.sh) หรือไม่ได้ส่ง --settings |
| Claude ไม่ทำต่อทั้งที่เทสต์พัง | พิมพ์ JSON แล้ว exit ด้วยโค้ดที่ไม่ใช่ 0 (JSON จะถูกอ่านเฉพาะตอน exit 0) หรือ JSON ผิดรูปแบบ → ทดสอบด้วย jq . |
| วนนานมากทุกรอบ | เทสต์ช้า → ตั้ง timeout (วินาที) ใน loop-hooks.json ให้พอ และพิจารณารันเฉพาะเทสต์ที่เร็ว |
| Claude แก้เทสต์ให้ผ่านแบบโกง | ต้องเขียนห้ามทั้งใน PROMPT.md และใน reason และตรวจ git diff ของโฟลเดอร์ test ทุกเช้า |
ข้อดี / ข้อเสีย
| ✅ ข้อดี | ❌ ข้อเสีย / ต้นทุน |
|---|---|
| ตัดสินด้วย exit code จริง ไม่ใช่คำพูดของโมเดล | ทุกครั้งที่จะจบเทิร์นต้องรอเทสต์ทั้งชุด — เทสต์ 2 นาที = ช้าลง 2 นาทีทุกครั้ง |
| ส่งผลเทสต์กลับให้ Claude แก้ต่อเองโดยไม่ต้องมีคน | งานที่ทำไม่ได้จริงจะวนจนครบ MAX_BLOCKS ทุกครั้งที่บล็อกคือเทิร์นที่ต้องจ่ายเงิน |
| ไฟล์เดียวใช้ซ้ำได้ทุก loop และทุกโปรเจกต์ | ดีได้เท่ากับเทสต์ที่มี — เทสต์ที่ไม่ครอบคลุมจะ "ผ่าน" ทั้งที่งานผิด และโมเดลอาจแก้/ข้ามเทสต์เพื่อให้ผ่าน |
ถ้าเผลอใส่ใน .claude/settings.json จะทำให้ทุก session ช้าลง รวมตอนคุยธรรมดา |
ทางเลือกที่ง่ายกว่า
- เขียนใน PROMPT.md ว่า "รันเทสต์ให้ผ่านก่อน commit" แล้วตรวจผลตอนเช้า — ไม่มีอะไรบังคับ แต่บ่อยครั้งก็พอสำหรับงานเล็ก
- ให้ CI รันเทสต์ตอนเปิด PR แทน — ช้ากว่าแต่ไม่ต้องดูแล hook
- เงื่อนไขที่อธิบายเป็นภาษาคนได้และใช้ครั้งเดียว →
/goal
เมื่อไรไม่ควรใช้: ไม่มีชุดเทสต์ที่เร็วและเชื่อถือได้ · งานคุยแบบ interactive · งานสำรวจที่ยังไม่มีนิยามคำว่าเสร็จ
สังเกตอะไร
- ข้อความใน
reasonคือ prompt ที่ Claude ได้รับต่อจากการโดนบล็อก ใส่ผลเทสต์ 20–30 บรรทัดสุดท้ายพร้อมสิ่งที่ห้ามทำ ดีกว่าบอกแค่ว่า "ยังไม่ผ่าน" - ตัวตรวจที่ดีที่สุดคือสิ่งที่มีอยู่แล้ว: เทสต์, type check, lint, build ไม่ต้องให้ AI อีกตัวมาตัดสินถ้าเครื่องตรวจได้
- เพดานจำนวนครั้งที่บล็อกสำคัญพอกับตัวตรวจ เพราะงานบางข้อทำไม่ได้จริง และ agent ต้องมีทางออก
สรุปจำง่าย
ให้เครื่องตัดสินว่าเสร็จ ไม่ใช่โมเดล — Stop hook รันเทสต์ บล็อกพร้อมเหตุผลที่ชัด และมีเพดานเสมอ