用途:该技能是维护循环,用于保持记忆语料库可信。记忆会衰减:文件移动、命令变更、不变量移位、重复累积。它是一套流程,可从两个方向进入。
两种入口:被动入口——发生了变更(文件重命名、命令标志移除、ADR 改变子系统边界、代码审查发现引用旧路径的过时记忆),在受影响范围内运行流程。主动入口——空闲时间、切片结束收尾或计划维护窗口,全语料库运行流程。
流程:
-
验证。全语料库运行 doctrine memory validate corpus-wide(被动时用 --path-scope/--glob 限定到变更区域)。对每条发现分诊:可立即修复的就修(更新路径、刷新范围);非琐碎的记为积压项(风险、杂务或改进);影响低且不急迫的记录并延后。
-
修剪。识别过时记忆:超过 review_by 日期 → 标记审查或归档;未验证线程超过有效期 → 归档(memory status <REF> archived);working-lifespan 记忆超过数天 → 撤回或提升为持久类型。对过时项运行 doctrine memory status <REF> archived;对单纯错误的记忆使用 retracted。
-
链接。强化图谱:检查最近记录或编辑记忆的建议关系(memory show <REF> 查看关系行);检查孤儿——无入边也无出边的记忆,用 memory list --orphans。若有孤儿,本次聚焦链接 20-30 条记录;若无,则探索语料库并强化/修剪既有记忆间的连接。用 memory search <keyword> 找候选记忆进行链接,它只返回一页,需用 --limit / --page 扫描。对高置信匹配运行 doctrine link。
-
积压整理。本轮无法修复的发现成为积压项:风险(尚未浮现的问题,如记忆指向已弃用 API)、杂务(清理工作,如合并重复记忆)、改进(增强,如把模式记忆提升为规范)。
-
事实核查。按严重度 × 陈旧度(距更新时间天数)抽查前 N 条记忆。对每条:核对引用来源(代码路径、文档、ADR)与当前树是否一致;正确则不动;漂移则用 doctrine memory edit <REF> 修正;过时则取代(memory status <REF> superseded --by <SUCCESSOR>)或隔离(memory status <REF> quarantined);无法验证则降低信任(memory edit <REF> --trust low)。
-
报告。生成简短交接摘要:已采取动作(验证 N、修剪 M、链接 L、核查 F)、延后到积压的发现(含已提交的 id)、需人工关注项(高严重度、有歧义、需决策)。写入 notes.md 或当前交接文档,避免下一个智能体重复相同检查。
适用场景:需要长期维护记忆库的智能体工作流,既用于响应变更,也用于空闲期主动维护。
限制:资料未提供具体安装命令、依赖环境、平台支持或收费信息。