ระดับ 7d · บทที่ 3/6

Stop hook — ไม่ให้ agent บอกว่า "เสร็จแล้ว" จนกว่าเครื่องจะยืนยัน

⏱ 30 นาทีลองในClaude ↗

📎 ไฟล์ตัวอย่างสำหรับบทนี้

เป้าหมาย

ใช้ 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 โดยไม่พิมพ์อะไร

เพดานกันวนไม่รู้จบ (ต้องมีทุกครั้ง)

  1. ของเราเอง: นับจำนวนครั้งที่บล็อกต่อ session (stop-check.sh ใช้ไฟล์นับ ค่าเริ่ม 3 ครั้ง) ครบแล้วปล่อยให้หยุด และให้ loop.sh รู้เองว่ารอบนี้ไม่มี commit
  2. ของ 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 รันเทสต์ บล็อกพร้อมเหตุผลที่ชัด และมีเพดานเสมอ