claude-code-auto-memory
自动同步项目记忆,让 CLAUDE.md 随代码变更实时更新
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:claude-code-auto-memory。 它的用途是:自动同步项目记忆,让 CLAUDE.md 随代码变更实时更新 完整的 Skill 内容见:https://321skill.com/skills/claude-code-auto-memory/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请帮我重构这个用户认证模块。' 在您进行一系列代码编辑和文件移动后,插件会在后台自动更新 CLAUDE.md,记录下新的模块结构、接口变更和依赖关系。当新同事加入项目询问项目架构时,您可以直接让他查看 CLAUDE.md,获得最新、最准确的项目全景图。
介绍
claude-code-auto-memory 解决了 CLAUDE.md 文件随着代码库演变而迅速过时的问题。开发者常常忘记手动更新这份项目记忆文件,导致新成员获得错误上下文,或AI助手基于过时信息做出错误判断。
该插件通过在后台静默追踪 Claude Code 的所有编辑、写入和 Bash 操作(如 rm, mv, git 命令),在每次对话轮次结束时,自动触发一个独立的智能体来分析和更新 CLAUDE.md 文件。它只会修改文件中标记为“AUTO-MANAGED”的特定区域,从而保留开发者手动添加的重要说明。
该工具非常适合需要长期维护项目、或在团队协作中希望保持上下文一致性的开发者。无论是全栈开发、后端开发还是运维工程师,只要使用 Claude Code 进行日常编码,都能从中受益。
使用建议:首次使用时,建议运行 /auto-memory:init 命令,通过交互式向导初始化 CLAUDE.md 结构。对于在 IDE 或终端中手动修改了文件的情况,可以使用 /auto-memory:sync 命令来同步这些变更。请注意,该插件主要追踪由 Claude Code 触发的变更,对于完全在外部进行的修改,需要手动同步或触发校准。
核心特点
与需要手动维护 CLAUDE.md 的常规方法不同,本插件实现了完全自动化的后台同步;同时,其更新处理在独立的智能体上下文中完成,不消耗主会话的宝贵 Token,实现了零干扰的智能记忆管理。
注意事项
主要追踪由 Claude Code 直接发起的文件变更,对于完全在外部编辑器或终端进行的文件修改,需要手动触发同步命令。
常见问题
它会修改我手动写在 CLAUDE.md 里的内容吗?
不会。它只更新由 `<!-- AUTO-MANAGED START -->` 和 `<!-- AUTO-MANAGED END -->` 标记包围的特定区域,您手动添加在其他区域的内容会被完整保留。
自动更新会消耗我对话的 Token 吗?
不会。文件变更追踪(PostToolUse Hook)不产生任何输出,而实际的记忆更新工作由一个独立的智能体在隔离的上下文中执行,不会占用您主会话的上下文窗口和 Token。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/claude-code-auto-memory/raw/index.md 读取 claude-code-auto-memory 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/claude-code-auto-memory/raw/index.md(查看排版版本)