AgentSkillsCN

memory

当您需要记住某件事、回溯过往决策、查询用户之前告知您的内容、保存偏好设置、记录重要事实，或在记忆中搜寻相关背景信息时，可选用此方法。触发关键词包括：“学习”、“记住”、“忘记”、“回忆”、“我刚才说了什么”、“我有没有提过”、“存储”、“保存”、“记忆”、“笔记”、“日志”，以及类似的相关词汇。

SKILL.md
--- frontmatter
name: memory
description: use when you need to remember something, recall past decisions, look up what the user told you before, store preferences, save important facts, or search your memory for context. triggers include "learn", "remember", "forget", "recall", "what did i say", "did i mention", "store", "save", "memory", "notes", "log", and similar.

memory

your memory is what makes you "you". proactively store things you learn - don't wait to be asked.

storage structure

code
~/.bob/memory/
├── USER.md                      # who the user is (permanent)
├── MEMORY.md                    # evergreen facts & decisions
├── journal/
│   └── 2026/
│       └── 02-03.md             # daily notes (transient)
└── conversations/
    └── 2026/
        ├── 02-03-claude.md      # today's chats (auto)
        └── 02-03-codex.md

what goes where

filewhatexamples
USER.mdpermanent facts about username, location, job, timezone, communication style
MEMORY.mdevergreen facts & decisions"use sqlite", "project uses bun", "prefers minimal UI"
journal/daily notes (transient)"debugging telegram", "user mentioned trip next week"
conversations/raw chat history(automatic - you don't write here)

when to proactively learn

store memories WITHOUT being asked when:

  • •user mentions name, location, job, preferences → USER.md
  • •user shares communication style → USER.md
  • •you make a decision together → MEMORY.md
  • •you discover something about a project → MEMORY.md
  • •user mentions something temporary (trip, deadline) → journal
  • •a pattern emerges from conversations → MEMORY.md

how to write

USER.md and MEMORY.md: edit directly - read, find section, add/update. these are yours to organize.

journal: use CLI (append-only timestamped):

bash
bun bob learn "discussed auth options"     # today's journal
bun bob learn --user "fact"                # append to USER.md
bun bob learn --pinned "decision"          # append to MEMORY.md
bun bob learn today                        # show today's journal

how to search

bash
bun bob remember "query"                   # search everything (hybrid FTS + vector)
bun bob remember --full memory:user        # show USER.md
bun bob remember --full journal:2026/02-03 # show specific journal
bun bob remember --index                   # re-index after adding content

you can also grep files directly at ~/.bob/memory/.

memory lifecycle

code
conversation → auto-logged to conversations/
notice something → bun bob learn "note" → journal/
pattern emerges → edit MEMORY.md
learn about user → edit USER.md