memory Skill：让 Claude Code 自动记住你的项目

Claude Code 和 Kimi Code CLI 里有一个常见痛点：每个新会话都要重新介绍项目背景。技术栈是什么、上周定了什么方案、踩过哪些坑，全得再说一遍。

/memory Skill 就是解决这个问题的。它把 memory CLI 包装成 AI 工作流，让 Claude 或 Kimi 自动加载、检索、记录和继承项目记忆。你继续用自然语言交流，AI 在需要时自动调用 memory 命令。

这是什么

Skill 不是新工具，而是 memory CLI 的包装层。你安装 memory CLI 并初始化项目后，在 Claude Code 中输入 /memory，Claude 会自动注入当前项目背景。之后你直接说"继续优化那个查询接口"，它就知道你在说什么。

背后是这些命令在跑：

• memory status：查看项目记忆摘要
• memory inject --compact：把背景注入当前会话
• memory query "问题"：基于已有记忆回答问题
• memory decision add ...：记录技术决策
• memory pitfall add ...：记录踩坑
• memory scan：项目结构变化后更新上下文

你不需要背这些命令，让 Claude 帮你调用就行。

快速开始

第一步：安装 memory CLI

python -m venv .venv
pip install -e .

第二步：在项目目录初始化并扫描

memory init
memory scan

第三步：在 Claude Code 中加载

/memory

Claude 会自动注入当前项目背景，之后即可围绕项目展开对话。

完整使用流程

加载 Skill

输入 /memory，Claude 自动执行 memory status 和 memory inject --compact，把项目背景注入会话。

提问前先检索

遇到具体问题，Claude 优先调用 memory query "你的问题"，基于已整理的决策、踩坑、备注回答。不会盲目翻代码。

做决策时记录

每当你或 Claude 选定技术方案，让它执行 memory decision add ...，把原因和细节存下来。三个月后有人问"为什么不用 RQ"，Claude 会直接引用这条决策。

踩坑后沉淀

解决非显而易见的 bug 后，让 Claude 执行 memory pitfall add ...。下次 memory query "Docker 中文乱码" 会直接给出答案。

结构变化后更新

新增/删除重要文件、升级依赖后，执行 memory scan 更新上下文。

新会话继承

下次打开 Claude Code，再次输入 /memory，所有记录自动恢复。

使用案例

新会话开局：30 秒进入状态

周一早上打开 Claude Code，输入 /memory。Claude 立即知道：

• 项目技术栈是 Python + Flask + Docker
• 上周决定用 PostgreSQL 替换 SQLite
• CI 环境有一个关于时区的踩坑

你直接说："继续优化那个查询接口"，无需从头介绍项目。

记录一次架构决策

讨论后决定引入 Celery 处理异步任务：

memory decision add "引入 Celery 处理异步任务" \
  --why "用户注册后需要发送邮件和生成报表，同步请求响应太慢" \
  --details "使用 Redis 作为 broker，任务结果不持久化，失败重试 3 次"

三个月后有人问"为什么不用 RQ"，Claude 会直接引用这条决策。

保存一个调了一下午的坑

Docker 中 Python 日志中文乱码，最后发现是 LANG 未设置：

memory pitfall add "Docker 中中文日志乱码" \
  --solution "Dockerfile 中设置 ENV LANG=C.UTF-8" \
  --details "Alpine 镜像默认无 locale，print 中文时终端显示 ???"

下次遇到同样问题，memory 会直接给出答案。

基于已有知识精准问答

你问："这个项目的认证是怎么做的？"

Claude 不会盲目翻代码，而是先执行 memory query "认证是怎么做的"。如果记忆里记录了认证方案，回答会基于该记录；如果没有，Claude 会提示你补充。

项目结构变化后自动同步

你新增了 docker-compose.prod.yml，并把 Flask 升级到 3.0。告诉 Claude：

memory scan

扫描后 detected_stack 会更新，下一次 /memory 注入时 Claude 会知道新的部署方式。

多项目切换：白天后端，晚上前端

初始化两个项目：

memory init ~/work/backend-api --name "backend-api"
memory init ~/side-projects/blog --name "blog"

切换目录后输入 /memory，Claude 会自动加载当前目录对应的记忆。如果当前目录不是已知项目，它会提示你初始化。

Claude Code 与 Kimi Code CLI 的区别

Claude Code 的自动化程度更高，Kimi 更多作为规则提醒存在。

常见问题

触发 /memory 提示 command not found: memory

说明 Skill 没找到 CLI。先确保虚拟环境已安装：

pip install -e .

Skill 会优先查找 ./.venv/bin/memory，再回退 PATH。

Claude 没有自动记录决策/踩坑

主动说"记录一下这个决策"或"这是个坑，记下来"，Claude 会执行对应命令。

注入的上下文太旧

说"更新一下项目扫描"，或手动执行 memory scan。

Skill 文件在哪里

• Claude Code Skill：.claude/skills/memory/
• Kimi Skill：.kimi/skills/memory/

一句话总结

/memory Skill 让 Claude Code 真正开始"记得"你的项目。不用每次重述背景，不用重复踩同样的坑，新会话打开 30 秒就能进入状态。