Claude Code 用久了越来越”健忘”?这个记忆体检 Skill 帮你找回丢失的规则
你的 Claude Code 用久了,是不是越来越”健忘”?
该让 Agent 做一次”记忆体检”了。
今天介绍一个冷门但极其实用的 Skill:audit-memory-hygiene。
问题比你想的严重
Claude Code 有一整套持久化记忆系统——MEMORY.md、axioms、lessons、ADRs、topic files……但这套系统有两个致命缺陷:
缺陷一:静默截断。 MEMORY.md 超过 ~200 行后会被悄悄截断,丢失的内容没有任何警告。你以为规则还在,实际上 Agent 已经看不见了。
缺陷二:中间信息丢失。 LLM 对长上下文中间位置的信息有 >30% 的准确率下降(Liu et al., 2023)。一条藏在 1400 行 lessons 文件第 617 行的关键规则,对 Agent 来说基本等于不存在。
长期不维护的记忆系统会积累:重复的 lesson 编号、指向已不存在代码的陈旧引用、ADR 编号冲突、被注入的恶意内容……
audit-memory-hygiene 怎么解决这个问题
它不是简单的”清理文件”,而是一套基于研究的分层记忆架构:
- T0(始终加载): axioms.md(≤12 条行为规则)+ CLAUDE.md(工作流规则)
- T1(始终加载): MEMORY.md(索引指针,40-80 行)
- T1.5(按需加载): .claude/rules/(按文件路径匹配的阶段规则)
- T2(按需加载): topic files(每个主题 50 行)
- T3(仅 grep): lessons、sessions 等归档文件
Skill 会在执行时做全面审计:检测 axiom 缺失、分层是否合理、陈旧引用、重复编号、凭证泄露、注入污染等。然后生成结构化报告,列明每项发现及严重等级。
适用场景
my lessons file is 1400 lines and critical rules keep getting ignoredaudit memory/check memory hygiene- MEMORY.md 接近或超过 200 行限制
- lesson 文件越来越大、可能包含重复内容
- 发现 ADR 编号冲突
- 记忆文件内容与当前代码产生矛盾
安装方式
# 通过 LobeHub 安装
npx claudepluginhub wan-huiyan/memory-hygiene --plugin memory-hygiene
# 或手动安装,复制到 ~/.claude/skills/memory-hygiene/
安装后直接说:audit memory 或 check memory hygiene,Agent 就会启动完整审计流程。
总结
这个 Skill 的价值不在于”清理”,而在于让你看清记忆系统的健康状态。
长期运行的 Claude Code session,如果没有定期维护,记忆系统会悄悄退化——规则被截断、关键知识被埋没、注入内容潜伏其中。audit-memory-hygiene 用结构化的方法把这层灰擦掉,让 Agent 真的能记住你教它的事。
GitHub 链接:https://github.com/wan-huiyan/memory-hygiene
评论区
登录后可评论。