用途:给智能体一套可信的记忆规则——什么值得写下来、放在哪里、何时删除。适用于基于文件的智能体记忆:指令文件(CLAUDE.md、AGENTS.md)、记忆目录、rules 与 skills 文件夹;示例采用 Claude Code 约定。不适用于向量库与检索基础设施,该技能解决的是整理(curation)问题。
三个动作与对应规则文件:WRITE 判断“这条是否值得存在”,准入测试是“若这行没了,智能体是否会犯错”,一个文件一条事实并写清原因(references/write-rules.md)。ROUTE 决定位置:Working=会话(不持久化)、Episodic=日志、Semantic=事实文件加索引且一事一家、Procedural=指令层,任务专用的大量内容降级为技能(references/routing.md)。PRUNE 决定何时消亡:错误立即删、完成转归档、约60至90天未用则质疑、索引上限约150行(references/prune.md)。执行前先读对应规则文件,不要自行设定阈值。
模式选择:从请求推断模式,含糊时用一行说明。bootstrap(“帮我搭一套记忆系统”)先访谈不创建,用用户语言问三到五个问题:主要用途、每次都要重复解释什么、智能体犯过且绝不能再犯的错误;对回答套用 WRITE,只保留通过准入测试的事实,并说出被拒绝的内容。最少化创建:按 templates/MEMORY-template.md 建索引、按 templates/fact-template.md 建事实文件(含 type、description、why、how-to-apply),若已有指令文件则给出精简建议 diff,经批准才应用;预期3至8条记忆而非20条。audit(“审计我的记忆”)先完整阅读,禁止部分阅读后审计;扫描六类缺陷并逐条以 file:line 举证:重复、矛盾、僵尸、错放、缺 why、索引缺陷;按类别分组报告并给出建议动作(合并/删除/归档/降级为技能/补 why),未经批准不应用,删除始终由用户决定;批准后应用并展示结果树。maintain(“执行记忆清扫”)按 references/prune.md 跑每周清扫:日志同步到事实、归档已完成项、矛盾扫描、僵尸检查、索引审计,同样先提议后应用。
环境行为(“记住这个”):运行准入测试,不通过则一行说明原因并给替代(可推导/仅会话/已记录在 X);通过则路由、写事实文件并附 why、加索引行,用一行确认写了什么、写在哪;若与既有记忆重复或矛盾,更新该文件而非新建第二处并说明。
输出纪律:具体并引用文件,展示目录树和 diff 而非长篇论述;拒绝候选记忆只给一行理由;未经批准绝不删除;不创建访谈未证明必要的结构。完整改造示例见 examples/before-after.md。