Auto Memory 是 Gemini CLI 的实验性功能，在后台扫描你的历史会话，自动识别反复出现的多步操作模式，生成 SKILL.md 草稿。你审批后，这些技能就能在未来会话中自动被调用，无需每次重复解释。

Auto Memory 自动记忆

Auto Memory 会悄悄在后台挖掘你过去的 Gemini CLI 使用记录，把反复出现的工作流变成可复用的 Skills。

实验性功能：目前仍在积极开发中，行为可能发生变化。

适合什么场景？

• 固化团队工作流 — 你经常要向 AI 解释同一套操作步骤（如"先跑测试再提交"）
• 记录踩坑经验 — 项目里有特定的"地雷"，每次都要提醒 AI 注意
• 自动建立技能库 — 不想手写每一个 SKILL.md

与 save_memory 工具不同（后者只保存单条事实到 GEMINI.md），Auto Memory 捕捉的是多步骤流程，将其提炼为可执行的技能。

如何开启

Auto Memory 默认关闭，在 settings.json 中启用：

全局开启（所有项目）：

// ~/.gemini/settings.json
{
  "experimental": {
    "autoMemory": true
  }
}

仅在特定项目开启：

// 项目根目录/.gemini/settings.json
{
  "experimental": {
    "autoMemory": true
  }
}

修改后重启 Gemini CLI 使设置生效。

触发条件

Auto Memory 不是每次启动都运行，需满足：

• 项目目录中有至少 10 条用户消息的历史会话
• 这些会话已空闲超过 3 小时（非活跃）

符合条件时，Auto Memory 在后台启动，不会阻塞 UI，不消耗交互次数。

工作原理

1. 扫描会话记录 — 读取 ~/.gemini/tmp/<project>/chats/ 下的历史会话
2. 识别重复模式 — 一个专用子代理分析跨会话中反复出现的操作序列
3. 生成 SKILL.md 草稿 — 将提取出的流程写入项目级"收件箱"目录
4. 通知你 — CLI 界面显示"有 N 个待审批的技能草稿"

子代理的策略是宁缺毋滥：只有证据充分时才提取技能，大多数会话运行后不会产生任何草稿。

审批和管理技能草稿

Auto Memory 提取的草稿需要你手动审批：

# 查看待审批的技能草稿（通常在项目的 .gemini/skills-inbox/ 目录）
ls .gemini/skills-inbox/

# 审阅草稿
cat .gemini/skills-inbox/some-skill.md

# 满意则移动到正式技能目录
mv .gemini/skills-inbox/some-skill.md ~/.gemini/skills/

# 不满意则删除
rm .gemini/skills-inbox/some-skill.md

Auto Memory vs 手动 /memory add

对比项	Auto Memory	/memory add
捕捉内容	多步骤流程（Skills）	单条事实（GEMINI.md）
触发方式	后台自动	主动在 REPL 中输入
输出格式	SKILL.md 文件	GEMINI.md 追加内容
需要审批	是（草稿 → 确认）	否（立即生效）
适用场景	积累可复用工作流	记录一次性信息

常见问题

Q: Auto Memory 会读取我的代码内容吗？

A: 会读取会话记录（你和 AI 的对话），以及会话中访问过的文件路径信息。代码内容的处理与普通会话一样，受 Google 隐私政策约束。

Q: 为什么启用了很久都没有生成任何草稿？

A: 检查是否满足触发条件（10+ 条消息、3+ 小时空闲）。如果满足但仍无草稿，说明 AI 未检测到明显的重复模式——这是正常的，宁缺毋滥。

Q: 生成的 SKILL.md 质量怎么样？

A: 作为草稿质量通常还可以，但需要你审查和调整。AI 提取的是行为模式而非你的真实意图，可能有过度泛化或捕捉偏差，使用前务必仔细阅读。