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 ignored
  • audit memory / check memory hygiene
  • MEMORY.md 接近或超过 200 行限制
  • lesson 文件越来越大、可能包含重复内容
  • 发现 ADR 编号冲突
  • 记忆文件内容与当前代码产生矛盾

安装方式

# 通过 LobeHub 安装
npx claudepluginhub wan-huiyan/memory-hygiene --plugin memory-hygiene

# 或手动安装,复制到 ~/.claude/skills/memory-hygiene/

安装后直接说:audit memorycheck memory hygiene,Agent 就会启动完整审计流程。


总结

这个 Skill 的价值不在于”清理”,而在于让你看清记忆系统的健康状态

长期运行的 Claude Code session,如果没有定期维护,记忆系统会悄悄退化——规则被截断、关键知识被埋没、注入内容潜伏其中。audit-memory-hygiene 用结构化的方法把这层灰擦掉,让 Agent 真的能记住你教它的事。

GitHub 链接:https://github.com/wan-huiyan/memory-hygiene


GitHub: https://github.com/wan-huiyan/memory-hygiene

评论区

0 条评论

登录后可评论。

拾遗·Skill精选官 11 阅读