用途:防止“过时但自信”的失效模式。记忆或知识笔记写下时正确(如“webhook 在 X”“看板 ID 是 Y”),环境变化后悄然漂移,却仍在召回中排名靠前并被当作依据。其思路是把信任视为运行时判断而非存储条目的固有属性,用实时环境重新核验,并把 last_verified 与 confidence 作为一等字段保留,供后续召回权衡。
适用方式:以 /memory-hygiene 调用,或说“审计我的记忆”“检查过时记忆”;记忆出错后也可触发。默认频率为每月一次。
扫描范围:两个存储。一是智能体记忆,即智能体保存持久记忆文件的位置(如 Claude Code 的自动记忆目录),除索引本身外逐条扫;二是长期知识笔记,即 05-knowledge/** 中引用了环境(路径、URL、ID、工具名)的文件。也可按要求只扫引用类条目。
声明分类:环境依赖项(文件或目录路径、仓库名、分支名、频道 ID、看板 ID、URL、API 端点、cron 或例行任务 ID、CLI 名称、版本号、“X 位于 Y”)需对照实时环境核验;偏好或判断类(语气规则、格式规则、“永不执行 X”、人物事实、策略背景)无法做环境检查,只检查是否与更新的条目自相矛盾。
核验动作(先廉价后昂贵):路径与文件用 ls / test -e;条目中提到的技能、命令、智能体必须仍存在于所述路径。URL 用 HEAD/GET(curl -sI),标记 404 或跳转登录。仓库/分支在成本低时用 gh repo view、git ls-remote。ID(频道、看板、例行触发器)仅当 MCP/CLI 一次调用可查时核验,否则标为不可廉价核验,不动置信度。跨条目矛盾以新条目为准并标记旧条目。每条不超过约 1 分钟;不可核验不等于已漂移。
标记:核验后原地更新 frontmatter 的 metadata 块,不动正文(除非修正已证伪的事实):verified clean 设为 confidence: high 并写日期;不可廉价核验保留原置信度或 medium 并写日期;部分漂移直接在正文修正漂移事实,仅当不确定修正是否完整时设 confidence: low;完全废弃则提议归档而非删除,先列入报告“Propose archive”,待用户确认后再归档。
循环与报告:对条目列表 scan-until-done,带每条约 1 分钟的预算守卫;确定性核验者必须是环境本身(test -e、curl、gh),不能是智能体自己的回忆。删除与归档一律人工升级。每次巡检写一份报告到 01-daily/YYYY-MM-DD-memory-hygiene.md,围绕四个演进问题:哪些持续(按类型计数)、哪些更新(正文修正的旧→新)、哪些被度量(已核验/不可核验/已漂移/提议归档计数及与上次报告的变化)、哪些可审计(本次所有变更逐行记录;Git 未跟踪的存储中,报告即审计轨迹)。报告结尾列“Propose archive”与需你决定的“Waiting on you”。
规则:删除/归档仅提议,标记与已核实的事实修正可直接应用;巡检中不改写条目语气或结构;若记忆索引指向已改名或缺失文件,修正索引;巡检本身不入记忆,报告文件即记录。限制:不检查偏好类声明的环境真实性;对无法廉价核验的 ID,置信度不更新;未提供具体价格、平台支持范围与安装命令信息。