เป้าหมาย
รวมทุกบทในระดับนี้เป็นระบบเดียวที่ใช้กับ 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 นาที