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

Capstone: agent กะดึก — ปิดงานใน backlog ข้ามคืน เช้ามาตรวจแล้วเปิด PR

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

เป้าหมาย

รวมทุกบทในระดับนี้เป็นระบบเดียวที่ใช้กับ repo จริงของคุณ: agent ทำงานจาก backlog ทุกคืนใน worktree แยก ตรวจตัวเองด้วยเทสต์ หยุดเองเมื่อชนเพดาน และตอนเช้าคุณใช้เวลาไม่เกิน 15 นาทีตรวจแล้วตัดสินใจว่าจะเปิด PR หรือทิ้ง

หลักการ

ภาพรวมของระบบ

01:00  launchd/cron ─▶ worktree agent/nightly ─▶ loop.sh
                                                  ├─ อ่าน PROMPT.md + PROGRESS.md
                                                  ├─ claude -p (ข้อเดียวต่อรอบ, dontAsk, สิทธิ์แคบ)
                                                  ├─ Stop hook: เทสต์ต้องผ่านก่อนจบรอบ
                                                  ├─ commit ทีละข้อ
                                                  └─ หยุดเมื่อ: งานหมด / ชนเพดาน / ไม่คืบหน้า / มีไฟล์ STOP
08:30  คุณ ─▶ รายงานเช้า ─▶ ตรวจ diff ─▶ push + เปิด PR ร่าง (หรือทิ้ง branch)

เลือกงานให้ agent กะดึก

✅ เหมาะ ❌ ไม่เหมาะ
เขียนเทสต์ให้โค้ดที่ยังไม่มี ออกแบบฟีเจอร์ใหม่ที่ต้องตัดสินใจเรื่อง UX
แก้ lint/type error ทีละไฟล์ migration ฐานข้อมูลจริง
ย้ายโค้ดไป API ใหม่ทีละจุด (มีเทสต์คุม) อะไรที่แตะเงิน สิทธิ์ผู้ใช้ หรือข้อมูลลูกค้า
เติม docstring/README ตามโค้ดจริง งานที่ "เสร็จ" ตรวจด้วยเครื่องไม่ได้

หลักง่ายๆ: ถ้าคุณมอบงานนี้ให้เด็กฝึกงานทำคนเดียวตอนกลางคืนไม่ได้ ก็อย่ามอบให้ agent

การ์ดความอิสระ (ต่อยอดจากบท 6g-03)

ก่อนเปิดใช้ กรอกการ์ดนี้ไว้ใน PROGRESS.md หรือ README ของ worktree:

agent: [ชื่อ]               เจ้าของ: [คุณ]
ทำได้: แก้ไฟล์ใน [โฟลเดอร์], รัน [คำสั่งเทสต์], git add/commit บน branch agent/nightly
ห้าม: push, merge, แก้ไฟล์นอก [โฟลเดอร์], แก้ config/lockfile, ลบ/ทำให้เทสต์อ่อนลง
เพดาน: MAX_ITER=[ ] MAX_TOTAL_USD=[ ] ต่อคืน, MAX_TURNS=[ ] ต่อรอบ
หยุดฉุกเฉิน: touch STOP ใน worktree / launchctl bootout
ใครตรวจ: [คุณ] ทุกเช้าก่อน 10:00 — ไม่มีคนตรวจ = ไม่รันคืนนั้น

ตั้งค่า ⚙️

ทุกค่าในการ์ดด้านบนต้องไปอยู่ในไฟล์จริงสักแห่ง ตารางนี้บอกว่าอยู่ที่ไหน (รายละเอียดแต่ละค่าดูบทที่อ้างถึง)

ค่าในการ์ด ตั้งที่ เริ่มที่ ตรวจยังไง
ทำได้ / ห้าม ALLOWED ใน loop.sh + กติกาใน PROMPT.md (7d-02) ค่าใน sample แก้แค่คำสั่งเทสต์ ขั้น 3: รอบซ้อมมี commit และไม่แตะไฟล์นอกขอบเขต
เพดาน MAX_ITER MAX_TOTAL_USD MAX_TURNS (7d-02) ซ้อม MAX_ITER=1 MAX_TOTAL_USD=1 · คืนจริงเริ่มจาก MAX_TOTAL_USD=5 ตาม plist ในบท 7d-04 แล้วปรับจากรายงานเช้า cost_usd ในรายงานเช้าต่ำกว่าเพดาน
นิยามเสร็จ TEST_CMD + MAX_BLOCKS + timeout ใน loop-hooks.json (7d-03) npm test, 3 ครั้ง, 300 วินาที ทดลอง A ของบท 7d-03 ใน worktree นี้
เวลา + ที่รัน plist/crontab ชี้ไปที่ ../myrepo-nightly (7d-04) ตีหนึ่ง launchctl kickstart แล้วดู .loop-logs/launchd.log
หยุดฉุกเฉิน ไฟล์ STOP + .gitignore — touch STOP แล้วรอบถัดไปไม่เริ่ม

→ เปลี่ยนค่าทีละอย่างต่อคืน แล้วดูผลในรายงานเช้า ถ้าเปลี่ยนหลายอย่างพร้อมกันจะไม่รู้ว่าอะไรทำให้ดีขึ้นหรือแย่ลง

ลองเลย 🧪

ขั้น 1 — เตรียม worktree กะดึก (ใน repo จริงของคุณ)

git worktree add ../myrepo-nightly -b agent/nightly
cd ../myrepo-nightly
npm install                                  # หรือคำสั่งติดตั้งของโปรเจกต์
cp /path/to/loop.sh /path/to/PROMPT.md /path/to/PROGRESS.md .
mkdir -p .claude/hooks
cp /path/to/stop-check.sh .claude/hooks/ && chmod +x .claude/hooks/stop-check.sh loop.sh
cp /path/to/loop-hooks.json .claude/
printf '.loop-logs/\nSTOP\n' >> .gitignore

→ แก้ ALLOWED ใน loop.sh ให้ตรงคำสั่งเทสต์ของโปรเจกต์ และแก้ npm test ใน PROMPT.md ให้ตรงกัน (ถ้าไม่ใช่ npm ให้ตั้ง TEST_CMD ด้วย)

ขั้น 2 — สร้าง backlog ด้วย Claude (แบบมีคนเฝ้า)

อ่านโปรเจกต์นี้แล้วเสนองาน 5–8 ข้อสำหรับ agent ที่ทำงานคนเดียวตอนกลางคืน
เกณฑ์: แต่ละข้อทำจบได้ในรอบเดียว (ไม่เกิน ~30 เทิร์น), ตรวจได้ด้วย [คำสั่งเทสต์], ไม่แตะ config/lockfile/ข้อมูลจริง
เขียนเป็น checklist "- [ ] ..." ที่ระบุไฟล์ที่ต้องแก้และเทสต์ที่ต้องเพิ่มชัดเจน แล้วใส่ไว้ใต้ "## งาน" ใน PROGRESS.md
ห้ามเริ่มทำงานใดๆ

→ อ่าน backlog เองทุกข้อ ตัดข้อที่กำกวมหรือใหญ่เกินไปทิ้ง แล้ว commit

ขั้น 3 — ซ้อมหนึ่งรอบต่อหน้า

MAX_ITER=1 MAX_TOTAL_USD=1 ./loop.sh
git show --stat HEAD

→ ถ้ารอบเดียวยังไม่ได้ commit ที่ดี อย่าเพิ่งตั้งเวลา ให้แก้ PROMPT.md, ALLOWED หรือขนาดงานก่อน

ขั้น 4 — ตั้งเวลา ใช้ plist หรือ crontab จากบท 7d-04 ชี้ไปที่ ../myrepo-nightly (ไม่ต้อง git switch แล้ว เพราะ worktree อยู่บน agent/nightly อยู่แล้ว)

ขั้น 5 — รายงานเช้า

cd ../myrepo-nightly
jq -s '{runs: length, cost_usd: (map(.total_cost_usd // 0) | add * 100 | round / 100), turns: (map(.num_turns // 0) | add), errors: (map(select(.is_error)) | length), by_subtype: (group_by(.subtype) | map({key: .[0].subtype, value: length}) | from_entries)}' .loop-logs/*.json
git log --oneline main..HEAD
sed -n '/## ติดปัญหา/,$p' PROGRESS.md
git diff --stat main...HEAD

→ ตัวอย่างผล:

{ "runs": 3, "cost_usd": 0.84, "turns": 27, "errors": 0, "by_subtype": { "success": 3 } }

→ จากนั้นให้ Claude ช่วยรีวิว (แบบมีคนเฝ้า) ก่อนตัดสินใจ:

รีวิว git diff main...HEAD ซึ่งเขียนโดย agent ตอนกลางคืน ตรวจ: (1) มีเทสต์ที่ถูกลบ ข้าม หรืออ่อนลงไหม
(2) แก้ไฟล์นอกขอบเขตที่กำหนดไหม (3) มีโค้ดที่ทำงานต่างจากที่ commit message บอกไหม (4) จุดเสี่ยงที่คนต้องดูเอง
ตอบเป็นตาราง ไฟล์ / ปัญหา / ความรุนแรง และสรุปว่าควรเปิด PR หรือไม่

ขั้น 6 — ตัดสินใจ

  • ผ่าน: git push -u origin agent/nightly แล้ว gh pr create --draft ให้คนในทีมรีวิวตามปกติ
  • ผ่านบางข้อ: git switch -c review/nightly-1 main แล้ว git cherry-pick <commit ที่ดี>
  • ไม่ผ่าน: จดสาเหตุไว้ปรับ PROMPT.md แล้ว git reset --hard main ใน worktree (งานเมื่อคืนหายทั้งหมด — แน่ใจก่อน)

ข้อดี / ข้อเสีย

✅ ข้อดี ❌ ข้อเสีย / ต้นทุน
งานเล็กที่น่าเบื่อเดินหน้าตอนคุณไม่อยู่ ภาระตรวจย้ายมาอยู่ที่คุณ ทุกเช้า — ไม่มีเวลาตรวจ = ระบบนี้ไม่มีประโยชน์
ทุกอย่างอยู่บน branch แยก ทิ้งได้ทั้งคืนโดยไม่เสียหาย คืนแรกๆ ได้งานน้อย เพราะต้องปรับ PROMPT.md, ALLOWED และขนาดงาน
เพดานทุกด้าน ค่าใช้จ่ายต่อคืนคาดเดาได้ เสียเงินทุกคืนที่รัน แม้ผลจะถูกทิ้งทั้งหมด
รายงานเช้าบอกต้นทุน/ผล/ปัญหาในหน้าเดียว โค้ดที่ผ่านเทสต์แต่ผิดความตั้งใจ จับได้ด้วยการอ่าน diff เท่านั้น · มีสคริปต์ hook และตัวตั้งเวลาให้ดูแลต่อ

ทางเลือกที่ง่ายกว่า

  • รัน ./loop.sh เองตอนกลางวันระหว่างที่คุณทำงานอื่น แล้วตรวจก่อนกลับบ้าน — ไม่ต้องตั้งเวลา ไม่มีกับดัก login
  • งานก้อนเดียวที่ชัดเจน → /goal ใน session ที่คุณเปิดไว้
  • อยากได้แค่รายงาน (สรุป issue, PR ที่ค้าง) ไม่ใช่แก้โค้ด → routine แบบอ่านอย่างเดียว (บท 7d-04)

เมื่อไรไม่ควรใช้: repo ไม่มีเทสต์ที่เชื่อถือได้ · backlog มีแต่งานที่ต้องตัดสินใจ · ไม่มีใครรับปากว่าจะตรวจทุกเช้า

สังเกตอะไร

  • คืนแรกๆ เวลาส่วนใหญ่ของคุณจะหมดไปกับการปรับ PROMPT.md และขนาดงาน ไม่ใช่การตรวจโค้ด — เป็นเรื่องปกติ และจะลดลงเมื่อ backlog ดีขึ้น
  • จด 3 ตัวเลขทุกเช้า: งานที่เสร็จ / ต้นทุน / เวลาที่คุณใช้ตรวจ ถ้าเวลาตรวจมากกว่าเวลาที่จะทำเอง ให้ลดขอบเขตลง
  • ทุกการกระทำที่ย้อนไม่ได้ (push, merge, deploy) ยังเป็นของคน ระบบนี้ทำให้งาน "พร้อมให้ตรวจ" ไม่ใช่ "เสร็จ"

สรุปจำง่าย

Agent กะดึกที่ดีทำงานเล็กๆ ที่เครื่องตรวจได้ บน branch แยก มีเพดานทุกด้าน และทิ้งร่องรอยให้คนตรวจตอนเช้าได้ใน 15 นาที