用途：帮助用户安装或操作公开的 Codex Memory 系统。仓库为 https://github.com/mcncarl/codex-memory ，本技能充当面向智能体的运行手册。Markdown 是唯一事实来源，Claude Code 和 Codex 共享同一 vault，各自维护薄规则与钩子适配器。
安装：克隆仓库 git clone https://github.com/mcncarl/codex-memory.git ；进入目录后用模板创建本地私有 vault：python3 scripts/bootstrap.py --memory-root "$HOME/codex-memory-vault" --write-env ，再 source .env 。随后构建索引并校验：python3 scripts/codex_agent_evolution.py --init --scan --report、python3 scripts/codex_memory_index.py --init --scan --report、python3 scripts/codex_memory_check.py、python3 scripts/codex_memory_doctor.py。需告知用户最终 vault 路径、状态数据库路径，以及后续重要任务结束时应运行的命令：python3 scripts/codex_memory_closeout.py --dry-run 与 --commit。
日常操作：安装中性包装后优先使用 memoryctl --actor codex search "query" --limit 5、memoryctl --actor claude prewrite "..."、memoryctl --actor claude closeout；旧脚本名仍兼容。统一检索入口：python3 scripts/codex_memory_search.py "query" --limit 5，可加 --track、--memory-type。写入前先做 prewrite 核对：--prewrite，允许的核对动作包括 ADD、UPDATE、NOOP、MARK_OUTDATED、MERGE_REQUIRED、ASK_USER。任务结束运行 closeout：--dry-run、--commit，它会发现脏文件、校验结构与泄漏、执行写后核对、刷新 SQLite、可选刷新 Zvec 等，并可只提交已处理的记忆文件；closeout 使用进程锁，检查失败或语义重复未解决会阻塞提交。审计可手动运行 codex_memory_audit.py、codex_memory_audit_autorun.py、codex_memory_doctor.py。
可选能力：安装 requirements-vector.txt 后可用 codex_memory_zvec_index.py --scan --prune 与 --report 构建语义检索；检索结果只是候选，使用前必须读取 Markdown 原文。仅在用户明确要求自动化时才安装全局钩子或 macOS LaunchAgent。
升级/发布：只在公共仓库更新公开安全的脚本、模板、文档与虚构示例，真实记忆留在私有 vault；提交前运行 compileall、索引、check、doctor 及泄漏检查，并检查 git diff。
排障：索引缺失时重建；closeout 找不到变更时检查 CODEX_MEMORY_ROOT 与 CODEX_MEMORY_GIT_ROOT；Zvec 慢或不可用可加 --no-zvec、--skip-zvec；审计重复提示可用 --ack、--ignore、--resolve、--snooze 记录决定。
限制：不得把真实记忆库复制进公共仓库，不得提交 .env、数据库、向量库、密钥、日志等敏感内容；删除文件须先获用户明确许可并使用回收站；不要让 Claude Code 自动记忆指向正式 vault。其余细节资料未提供。