Imported from Yu-Xiao-Sheng/codex-memory-trim (skill/SKILL.md). Install upstream with npx skills add Yu-Xiao-Sheng/codex-memory-trim --skill skill. Copyright stays with the author.

Codex 全局记忆管理（trim / compress / add-global）

按用户需求只读取对应子技能文件执行，不要全量加载：

共享事实（所有子技能依赖，不要重新推导）

• 分层：sessions/*.jsonl（不可变原始证据）→ raw_memories.md / rollout_summaries/（整理输入，由 ~/.codex/memories_1.sqlite 表 stage1_outputs 重新渲染，手改会被还原）→ MEMORY.md（检索层）/ memory_summary.md（会话启动时注入的快照，文件头 v1）。
• usage_count（stage1_outputs 列）= 检索命中次数，是保留/删除的核心依据。
• ~/.codex/memories/.git 是整理基线：Phase 2 以 HEAD→工作区 diff 决定巩固内容。任何手工修改必须以 git 提交收尾，且提交前工作区若不干净、或 git log 顶部是新的 "Initialize Codex git baseline"（刚跑过自动整理），必须先读 diff 合并新内容，禁止覆盖。
• 巡检脚本（只读）：python3 ~/.codex/skills/codex-memory-trim/scripts/collect.py。
• 记忆快照是会话启动时一次性注入；修改只对新会话（或 codex fork）生效。
• 备份模板：mkdir -p ~/.codex/backups && TS=$(date +%Y%m%d-%H%M%S) && tar czf ~/.codex/backups/memories-before-trim-$TS.tar.gz -C ~/.codex memories && cp ~/.codex/memories_1.sqlite ~/.codex/backups/memories_1-before-trim-$TS.sqlite

共享红线

• 永不动 sessions/*.jsonl、extensions/ad_hoc/notes/ 既有文件内容（note 只能新增或按用户原话修订）、.git 内部对象（正常 commit 除外）。
• 禁用 codex debug clear-memories（全量重置）。整理任务（collect.py 中 consolidate_global）运行中不写文件。
• 动手前必备份，结束必提交：cd ~/.codex/memories && git add -A && git -c user.name="Codex" -c user.email="noreply@openai.com" commit -m "<一句话>"，收尾 git status --short 必须为空。
• 本 skill 自身按效率优先执行：单次完成，不循环重复校验。