| name | update-codex-memory |
| description | 判断已完成任务是否产生了长期有效知识，并更新 Codex Memory Markdown 知识库。适用于用户要求更新 Codex memory、写入 memory、memory closeout、沉淀记忆、更新记忆、更新 codex memory，或重要任务结束后需要记录可复用偏好、流程、决策、项目路径、已验证排查结论、未闭环事项的场景。 |
更新 Codex Memory
使用这个技能回顾近期工作，判断哪些内容值得进入长期记忆，先检索已有笔记，再把小段、可审查的 Markdown 写入合适位置。
知识库路径
按以下顺序解析 memory 根目录：
- 用户明确提供的路径。
- shell 环境变量
CODEX_MEMORY_DIR。
如果两者都不存在，停止并请用户先设置 CODEX_MEMORY_DIR，或提供正确路径。
写入前必须验证所选路径存在，并且包含 AGENTS.md。如果不满足，停止并请用户先初始化 Codex Memory 或提供正确路径。
工作流程
- 回顾已完成的开发或执行流程。
- 提炼任务中学到的事实、已验证命令、稳定路径、决策、用户偏好、未闭环事项和可复用流程。
- 区分事实和推断。
- 判断候选内容是否有长期价值。
- 只写入未来任务大概率会复用的信息。
- 跳过低价值总结、临时过程记录和完整聊天记录。
- 写入前先检索已有 memory。
- 使用
rg -n "<关键词>" <memory-root> 检索具体项目名、命令名、文件名、决策或流程关键词。
- 优先更新已有相关笔记。
- 没有合适笔记时再新建。
- 写入小段 Markdown。
- 使用明确标题。
- 包含日期、来源任务和适用范围。
- 同时存在事实和推断时，分节记录。
- 发现旧记忆过时时，不直接删除，标注
已过时 并说明原因。
- 返回更新后的文件路径，供用户审查。
写入内容
只写入预计之后会再次用到的长期知识：
- 用户长期偏好、明确边界、反复强调的工作方式。
- 项目的稳定路径、关键命令、环境差异、发布流程。
- 已验证过的故障原因、修复方式、排查顺序。
- 重要决策及其原因。
- 跨项目待办、悬而未决的问题。
- 可复用的文章结构、脚本流程、研究模板、提示词。
禁止写入
不要写入：
- 完整聊天记录、流水账、临时情绪、一次性中间过程。
- Cookie、Token、API Key、密码、验证码、身份证号、银行卡、私密联系方式、第三方账号凭证、日志里的敏感值。
- 为了“显得有记忆”而写的低价值总结。
目录选择
- 项目相关长期事实：
Projects/
- 用户、合作方、角色偏好：
Roles/
- 可复用流程、命令、检查清单、提示词：
Workflows/
- 重要选择、取舍和原因：
Decisions/
- 可复用模板或表达方式：
Resources/
- 跨项目未闭环事项：
TODO.md
- Agent 后续跟踪事项：
agent/open-loops.md
写作风格
- 默认使用简体中文；如果用户当前对话使用其他语言，则技能内容、记忆内容和输出语言跟随用户对话语言。
- 追加到已有笔记时使用带日期的小节。
- 每次更新保持足够小，方便 diff 审查。
- 使用具体名称、路径、命令或适用条件。
- 避免把猜测沉淀成规则。
最终回复
写入后说明：
- 是否更新了 memory。
- 变更了哪些文件路径。
- 用一句话概括记录了什么。
