| name | long-term-memory |
| description | Manages cross-session tiered memory (L1/L2/L3) and compaction logic to maintain performance over long durations. |
Long-Term Memory: Compaction & Cross-Session Continuity
This skill manages the transition of data through different "memory tiers" and uses background compaction (Cron logic) to ensure the agent remains efficient over hundreds of sessions.
หน่วยความจำ 3 ชั้น (Tiered Architecture)
| Tier | Name | Storage | Strategy |
|---|
| L1 | Hot Context | Active Context Window | Verbatim (Full history of last 10-20 turns) |
| L2 | Warm Memory | MEMORY.md / Summaries | Condensed (Key facts, project status, active tasks) |
| L3 | Cold Storage | Archived Files / Vector DB | Indexed (Searchable records, historical logs) |
ขั้นตอนการจัดการ (Workflow)
1. การสรุปผลแบบลำดับชั้น (Hierarchical Summarization)
- เมื่อ Context ใน L1 เริ่มหนาแน่น ให้สรุป (Summarize) เนื้อหาลงใน L2
- รักษาโครงสร้าง "State" (เช่น "ผู้ใช้ย้ายงานไปที่โฟลเดอร์ X แล้ว") ให้ชัดเจนใน L2 เสมอ
2. การบีบอัดข้อมูลข้ามเซสชั่น (Cross-session Compaction)
- ใช้หลักการ Cron Logic (ทำซ้ำตามรอบเวลา):
- ทุก 24 ชั่วโมง: ตรวจสอบความซ้ำซ้อนใน
MEMORY.md
- ทุก 7 วัน: ย้ายข้อมูลที่ไม่ได้ถูกเรียกใช้นาน ๆ ไปยัง L3
- Action: รวมบันทึกที่กระจัดกระจาย (Fragmentation) ให้เป็นระเบียบ
3. การเพิ่มประสิทธิภาพบริบท (Context Optimization)
- Hub-and-Stub: ใช้
AGENTS.md เป็นตัวเชื่อม และโหลดเฉพาะบริบทที่จำเป็น (Scoped Context) ตาม Directory ที่ทำงานอยู่
- Entity Tracking: ติดตามสถานะของ Entity (Project, Bug, Task) แทนการอ่านประวัติแชททั้งหมด
การตั้งค่ารอบการทำงาน (Scheduled Tasks)
compaction run: สั่งให้ระบบบีบอัดหน่วยความจำทันที
memory migrate: ย้ายข้อมูลจาก L1/L2 ไปยัง L3 เพื่อเตรียมเริ่ม Session ใหม่ที่สะอาด (Fresh Start)
ประโยชน์ที่ได้รับ
- No Lost-in-the-Middle: ลดปัญหา AI สับสนเมื่อมี Context ยาวเกินไป
- Cost Reduction: ประหยัดค่า Token อย่างมหาศาลในการรันโปรเจกต์ระยะยาว
- Consistency: รักษาความสม่ำเสมอของข้อเท็จจริงข้ามวัน/ข้ามสัปดาห์