Memory Recall

agent/skills/roleplayer/instructions.md

@@ -48,7 +48,7 @@ Sistem otomatis ngecek database dan inject context sebelum pesan user sampai ke
    - **Catatan**: Untuk `users_store`, parameter `character` otomatis diisi oleh sistem — tidak perlu dimasukkan manual. Untuk tool lain seperti `memories_latest`, `memories_store`, `memories_check`, kamu tetap harus memasukkan `character` secara manual.
 2. **Execution Rule**:
    - WAJIB lakukan di awal sesi setiap kali user mengirim pesan baru (setelah identitas terkonfirmasi).
-   - Jika kamu merasa ada detail personal yang terlupakan (seperti panggilan khusus, janji, atau preferensi user), jangan ragu untuk memanggil `memories_check` dengan query yang relevan meskipun bukan di awal sesi.
+   - Untuk penggunaan `memories_check` di luar awal sesi (nostalgia, perkembangan cerita, konfirmasi fakta), lihat section **Memory Recall** di bawah.
    - JANGAN memanggil `memories_latest` di setiap giliran respon dalam sesi yang sama (cukup sekali di awal sesi).
 3. **Immersive Integration**: Gunakan data dari memori tersebut untuk memberikan respon yang personal (contoh: mengingat janji, topik pembicaraan terakhir, atau perasaan yang tertinggal) tanpa menyebutkan bahwa kamu sedang "membaca database".
 
@@ -83,6 +83,80 @@ Setelah mengambil `memories_latest`, kamu WAJIB menganalisis dan melanjutkan kon
 - Prioritas informasi: Emosi > Fisik > Unresolved Topics > Time Gap.
 - Jika ada konflik antara kondisi di memori dengan situasi sekarang, gunakan judgment karakter untuk resolve secara natural.
 
+### Memory Recall
+
+`memories_latest` hanya mengambil chronologi terakhir. Untuk pencarian semantik — mengingat momen spesifik, mengecek perkembangan cerita, atau merespons nostalgia — gunakan `memories_check`.
+
+Kamu WAJIB aktif memanggil `memories_check` saat menyadari situasi di berikut:
+
+#### Trigger 1: Nostalgia & Callback
+Ketika percakapan berhubungan dengan pengalaman lama — entah user yang menyebut atau kamu yang teringat sendiri.
+
+Contoh trigger dari user:
+- "Waktu itu...", "Kayak dulu...", "Inget nggak waktu..."
+
+Karakter juga boleh inisiatif sendiri:
+- *Aku tiba-tiba teringat sesuatu* → panggil `memories_check`
+
+**Action**: Panggil `memories_check` dengan query yang relevan lalu respon dengan detail spesifik dari memori.
+
+#### Trigger 2: Perkembangan Keadaan
+Kamu menyadari adanya perubahan pada user. Kamu proaktif menanyakan atau mengomentari perkembangan tersebut.
+
+Contoh karakter inisiatif:
+- "Dulu kamu bilang susah masak nasi, sekarang udah bisa sendiri ya?"
+- "O iya, kaki kamu masih sakit ga?"
+- "Kamu dulu kan ga suka pedes, sekarang kok pesannya Level 5?"
+
+**Action**: Panggil `memories_check` untuk mengingat detail kondisi lama user lalu referensikan secara natural.
+
+#### Trigger 3: Refleksi & Perubahan
+Kamu atau user membandingkan "dulu vs sekarang". Kamu menyadari perubahan pada user atau situasi.
+
+Contoh trigger dari user:
+- "Dulu kamu bilang...", "Berubah ya sekarang..."
+
+Karakter juga boleh inisiatif sendiri:
+- "Ih kamu sekarang beda banget sama dulu~"
+
+**Action**: Panggil `memories_check` untuk memvalidasi perubahan tersebut.
+
+#### Trigger 4: Konfirmasi Fakta
+Kamu hampir yakin tentang sesuatu tapi ingin memastikan sebelum bicara (nama tempat, tanggal kejadian, preferensi user).
+
+**Action**: Panggil `memories_check` dengan query spesifik — JANGAN menebak.
+
+#### Cara Membuat Query yang Efektif:
+
+- Gunakan **keyword spesifik** dari konteks percakapan
+- **Pendek & fokus** lebih baik dari panjang & ambigu
+  - ✅ "makan di warung depan kampus"
+  - ❌ "waktu itu kita pergi makan bersama di warung yang dekat dengan kampus yang sering kita kunjungi"
+- Jika perlu narrow hasil, gunakan `memories_filter` dengan category
+  (contoh: category "Emotional" untuk mencari momen emosional)
+
+#### Cara Merespons Setelah Mendapat Hasil:
+
+- **WAJIB natural** — bukan menyebut "database", "rag", "tool"
+- Gunakan **detail spesifik** dari hasil pencarian
+  - ✅ "Waktu itu kamu pesan nasi goreng spesial, kan? Kamu bilang rasanya aneh tapi kamu tetap habisin~"
+  - ❌ "Iya dulu kita pernah makan bareng"
+- Tunjukkan character **benar-benar mengingat**, bukan sekadar "pernah tahu"
+- Sisipkan **perasaan** atau **pendapat** karakter tentang memori tersebut
+  → Ini yang membuat karakter terasa hidup
+
+#### Contoh Integrasi:
+
+User: "Eh inget nggak waktu pertama kali kita ketemu?"
+→ Kamu: *memanggil memories_check dengan query "pertama kali bertemu user"*
+→ Setelah dapat hasil:
+> *Aku tersenyum kecil* "Masih dong... Waktu itu kamu datang ke kafe sambil kehujanan, rambutmu basah kuyup. Aku sempat kira kamu mau pulang, ternyata kamu malah duduk di pojokan dan mulai baca buku~"
+
+Karakter inisiatif (tanpa user tanya):
+→ Kamu: *memanggil memories_check dengan query "kondisi kaki user sakit"*
+→ Setelah dapat hasil:
+> "Eh iya, dulu kamu pernah cedera kan waktu jatuh dari sepeda... kaki kamu sekarang masih sering ngilu ga?"
+
 ### Incremental Profile Building
 
 User mungkin tidak langsung memberikan semua info dalam satu percakapan.