persistent-memory 是一个用纯 Markdown 文件跨对话保存上下文的技能,记忆按用户指定主题(scope,如 parenting、work、project-acme)隔离,便于后续会话接着上次继续。
用途:按主题捕获、回忆、整合和遗忘记忆,记忆是可读、可编辑、可 grep、可删除的 Markdown 文件,不依赖专有格式。
主要能力:五种操作 —— write(默认,触发词如 remember、save to memory)、read(recall、load memory)、consolidate(consolidate memory、compress memory)、forget(forget that、delete memory)、list(list memory)。存储分三层:home(默认,~/.agent-memory/<scope>/,不提交)、project-local(<repo>/.agent/memory/<scope>/,gitignore)、project-shared(<repo>/memory/<scope>/,会提交,供团队共享)。每个 scope 目录含 INDEX.md(≤200 行,read 时总是加载)、entries/ 单条记忆、archive/ 归档、AUDIT.log 追加式审计日志。
使用方式:解析 $ARGUMENTS 首词判定操作;若未提供 scope 会一次性询问而非猜测。写入为两阶段流程,先提取候选,再对现有条目标记 ADD / UPDATE / DELETE / NOOP,并在用户确认 diff 后写入(--auto 可跳过)。该技能可被宿主技能调用,例如 Skill("persistent-memory", "read parenting"),要求 disable-model-invocation: false。
适用场景:个人或团队对某主题的长期上下文积累,如个人助理、项目笔记、团队共享知识。
限制:隐私预检会拒绝密钥、凭据、政府证件等永不存储项;默认纯 Markdown 适合每 scope 约 500 条以内、单用户、无需语义搜索;更大规模需逐级升级到 SQLite FTS、本地向量库或托管记忆层。未提供具体安装命令、收费与平台信息。