memory-keeper

name	memory-keeper
description	Codex 记忆管理技能。用于“记住、记下来、忘掉、删除记忆、整理记忆、合并记忆、检查记忆冲突”等请求；把稳定信息路由到正确的 AGENTS.md、项目知识或已有个人知识库，并执行去重、合并、死链检查。显式调用：$memory-keeper。

记忆管理（Codex）

管理用户明确要求保存、删除或整理的长期信息。重点是正确归位和可验证修改，而不是保存整段对话。

与其他技能的边界

• $memory-keeper：处理明确的“记住/忘掉/整理记忆”。
• $weaver-自我迭代：跨项目扫描和提炼新候选。
• $file-tidy：移动普通文件，不判断知识层级。
• $debug-architect：复盘错误并写项目 .codex/ERROR_LOG.md。

“整理记忆”只重构现有内容，不从对话中顺手提取新事实。

可写位置

按用户现有体系优先，不强制创建新的 memory 目录：

内容	首选位置
跨项目硬规则	~/.codex/AGENTS.md
项目硬规则	项目根或最近子目录的 AGENTS.md
Codex 配置	~/.codex/config.toml 或项目 .codex/config.toml
稳定偏好、决策、项目上下文	项目已有 memory/docs/知识文件
通用概念、规律、方法论	用户已有个人知识库
技能说明	~/.agents/skills 或项目 .agents/skills

AGENTS.md 只放执行必须看到的规则，不放叙事、聊天摘要或不稳定状态。需要合并案例时读取 references/merge-examples.md。

“记住”流程

1. 提炼原子事实

把用户内容压缩为一条或数条可独立更新的事实，区分：

• 明确事实；
• 用户偏好；
• 硬规则/禁止事项；
• 项目决策；
• 通用知识；
• 敏感信息。

不保存密钥、口令、令牌、身份信息或完整私密对话。用户要求保存敏感信息时，说明风险并建议安全存储位置。

2. 判断层级

• 明确跨项目 → 全局；
• 当前仓库专属 → 项目；
• 模块专属 → 最近子目录；
• 不确定 → 保守下沉到项目或先询问一次。

3. 搜索已有内容

在候选位置及其索引中搜索同义词、旧说法、反向规则和引用。读取目标文件后再决定：

• 新增；
• 更新旧条目；
• 合并重复；
• 替换被推翻内容；
• 无需修改（已存在）。

4. 展示计划

## 记忆写入计划
| # | 动作 | 目标文件 | 内容 | 原因 |

修改全局文件、删除旧内容、创建新知识文件或存在冲突时先确认。用户已明确指定文件和内容且操作低风险时可直接执行。

5. 融入并验证

1. 按目标文件原有结构更新相关段落，不在文件尾堆重复“补充”。
2. 若更新知识库，遵循该知识库最近的 AGENTS.md、索引和链接规范。
3. 读回目标段落，搜索旧冲突表述和重复内容。
4. 检查新链接和路径存在；配置文件需可解析。
5. 报告绝对路径与最终落点。

“忘掉”流程

1. 搜索所有明确匹配和可能派生项，区分规则、事实、链接、索引和配置。
2. 展示拟删除/改写清单及影响；不要把“忘掉 X”扩大成清理整个主题。
3. 用户确认后精确删除或改写。
4. 清理死链、空标题、重复索引和只因该事实存在的交叉引用。
5. 再次搜索目标词与同义表达，报告残留及原因。

若内容来自 Git 历史、备份或不可写的外部系统，说明只能从当前可控文件中移除，不能承诺彻底擦除历史。

“整理记忆”流程

1. 审计

限定用户指定的层级和目录，检查：

• 重复、矛盾、过期和被推翻的内容；
• 死链接、孤立文件、空标题和失效索引；
• 全局规则中混入项目细节；
• 项目规则应下沉到子目录；
• 配置说明与实际 config.toml 不一致；
• 同一知识在多个文件重复但没有权威来源。

2. 分级

动作	典型场景	默认行为
删除	死链、明确过期、完全重复	先确认
合并	同主题碎片、多个版本	先确认
更新	新决定明确推翻旧规则	先确认冲突处理
下沉/提升	层级放错	先展示理由
关联	不同主题但同根因	建议双向链接
保留	有意重复、不同受众	说明原因

3. 一次性计划

合并所有动作到一张表，给每项编号。用户可以整体确认或排除编号，不逐条打断。

4. 执行与完整性检查

• 先建立权威版本，再删重复版本；
• 更新所有索引和链接；
• 不改变事实含义，不把推测改成事实；
• 使用 git diff -- <明确路径> 检查变更边界；
• 整理结束后再次搜索重复词、死链和冲突规则。

特殊情况

• 目标位置不存在：优先使用项目已有体系；只有内容确有长期价值且用户同意时才创建文件。
• 两条记忆冲突：用户最新明确决定优先；否则并列展示并询问。
• 请求“记住这次对话”：先提炼候选清单，不保存全文。
• Codex 历史不可访问：不影响明确的记住/忘掉请求；整理范围只覆盖当前可读文件，并说明限制。
• 没有发现可整理项：报告检查范围和“无需变更”。