ข้ามไปที่เนื้อหาหลัก

เวิร์กโฟลว์ตัวแทนที่ทำงานยาวนาน

ใช้ Playbook นี้เมื่องานมีแนวโน้มที่จะครอบคลุมหลายเซสชัน การส่งมอบ หรือตัวแทนที่สร้าง

เป้าหมาย​

  • ให้แต่ละเซสชันใหม่มีวิธีที่รวดเร็วในการฟื้นบริบท
  • ทำงานแบบค่อยเป็นค่อยไปแทนที่จะทำการเปลี่ยนแปลงครั้งใหญ่เพียงครั้งเดียว
  • ติดตามข้อมูลพื้นฐานในท้องถิ่นที่เสียหายก่อนที่จะเพิ่มโค้ดเพิ่มเติม
  • ทิ้งสิ่งประดิษฐ์ที่คงทนไว้ซึ่งเซสชันถัดไปสามารถเชื่อถือได้

จะเก็บรัฐไว้ที่ไหน​

  • ใช้ docs/agent-runs/<slug>/ เมื่อมนุษย์ บอทตรวจสอบ หรือหลาย toolchains ต้องการสถานะงานเดียวกัน
  • ใช้ไดเร็กทอรีภายในเครื่องมือ เช่น .codex/runs/<slug>/ เฉพาะเมื่อสถานะของงานตั้งใจให้โลคัลกับเวิร์กสเตชันหรือหนึ่ง toolchain เท่านั้น
  • อย่าซ่อนสถานะที่แชร์แบบหลายเซสชันในไฟล์ Scratch ส่วนตัว หากผู้สนับสนุนหรือตัวแทนรายอื่นจำเป็นต้องใช้ในภายหลัง

ไฟล์ที่จำเป็น​

สร้างไฟล์เหล่านี้เมื่อเริ่มต้นงานที่ใช้เวลานาน:

  • feature-list.json
  • progress.md

ใช้เทมเพลตใน docs/agent-playbooks/templates/feature-list.template.json และ docs/agent-playbooks/templates/progress.template.md

ต้องการ JSON สำหรับรายการคุณสมบัติ เพื่อให้ตัวแทนสามารถอัปเดตฟิลด์จำนวนน้อยโดยไม่ต้องเขียนใหม่ทั้งเอกสาร

รายการตรวจสอบการเริ่มต้นเซสชัน​

  1. เรียกใช้ pwd
  2. อ่าน progress.md
  3. อ่าน feature-list.json
  4. เรียกใช้ git log --oneline -20
  5. เรียกใช้ ./scripts/agent-init.sh --smoke
  6. เลือกรายการที่มีลำดับความสำคัญสูงสุดหนึ่งรายการซึ่งยังคงเป็น pending, in_progress หรือ blocked

หากขั้นตอนควันล้มเหลว ให้แก้ไขพื้นฐานที่เสียหายก่อนที่จะใช้งานส่วนคุณลักษณะใหม่

กฎเซสชัน​

  • ทำงานกับฟีเจอร์หรืองานชิ้นเดียวในแต่ละครั้ง
  • ทำให้รายการคุณลักษณะสามารถอ่านได้โดยเครื่องและมีเสถียรภาพ อัปเดตสถานะ บันทึกย่อ ไฟล์ และฟิลด์การยืนยัน แทนที่จะเขียนรายการที่ไม่เกี่ยวข้องใหม่
  • ทำเครื่องหมายรายการที่ได้รับการตรวจสอบแล้วหลังจากรันคำสั่งหรือโฟลว์ผู้ใช้ที่แสดงอยู่ในรายการนั้นเท่านั้น
  • ใช้ตัวแทนที่สร้างสำหรับสไลซ์ที่มีขอบเขต ไม่ใช่สำหรับการเป็นเจ้าของสถานะงานโดยรวม
  • เมื่อตัวแทนย่อยเป็นเจ้าของหนึ่งรายการ ให้ระบุรหัสรายการ เกณฑ์การยอมรับ และไฟล์ที่อาจเกี่ยวข้อง

รายการตรวจสอบการสิ้นสุดเซสชัน​

  1. ผนวกรายการความคืบหน้าแบบสั้นไปยัง progress.md
  2. อัปเดตรายการที่สัมผัสใน feature-list.json
  3. บันทึกคำสั่งที่เรียกใช้เพื่อตรวจสอบความถูกต้อง
  4. จับภาพตัวบล็อก การติดตามผล และรายการที่ดีที่สุดถัดไปเพื่อดำเนินการต่อ

รูปแบบรายการความคืบหน้าที่แนะนำ​

ใช้โครงสร้างแบบสั้นเช่น:

## 2026-03-17 14:30

- Item: F003
- Summary: Updated the browser-check flow to use the shared init/bootstrap path.
- Files: `.cursor/agents/browser-check.md`, `.codex/agents/browser-check.toml`
- Verification: `corepack yarn build`, `corepack yarn lint`, `corepack yarn typecheck`
- Next: Run the smoke flow and update the task-board status.