best.memoryx-skill

Windows-only Codex skill installer for project-scoped best memory.

安装

npx best.memoryx-skill install

或者全局安装后执行：

npm i -g best.memoryx-skill
best-memoryx-skill install

安装器会把 skill 复制到：

%USERPROFILE%\.codex\skills\best-project-memory

并追加全局入口规则到：

%USERPROFILE%\.codex\AGENTS.md

如果能识别 config.toml 中的单行 developer_instructions，安装器还会追加一条“新会话先读取 AGENTS.md”的规则。修改前会备份 config.toml。

使用方式

安装完成后，在具体项目目录中正常使用 Codex。处理项目任务时，Codex 会通过 best-project-memory 初始化并读取：

项目目录\best_memory\best_memory.md

每次项目相关任务结束后，追加最核心的“提问”和“结果”。有价值时才补充证据或后续事项。

如果项目是 Git 仓库，初始化、追加和裁剪记忆后会自动把本次写入的 best_memory/best_memory.md / best_memory/best_sessions/*.md 加入暂存区。自动添加只限定在 best_memory 路径内，不会执行 git add .。

从当前版本开始，Next 不再只是详情字段：

• Next 有有效内容时，会自动同步到 best_memory.md 的 ## 待处理问题
• 同一事项后续完成时，再追加一条没有 Next 的同键记录，就会自动从 待处理问题 删除
• 默认使用标题生成稳定键；需要更稳时可以显式传 PendingKey
• 一次关闭多个待办时，可以传 Resolves

从 v0.2 开始，项目记忆按“索引 + 详情”分层保存：

项目目录\best_memory\best_memory.md
项目目录\best_memory\best_sessions\*.md

best_memory.md 只作为短索引，新会话先扫描索引；需要历史细节时再按 ID 读取 best_sessions 里的详情。

检索命令

普通用户不需要手动运行这些命令，Codex 会按 skill 规则使用。需要自己查历史时可以运行：

best-memoryx-skill search "关键词"
best-memoryx-skill show "best-20260428-180000-abcdef-title"
best-memoryx-skill timeline "best-20260428-180000-abcdef-title"

入口索引变长时，可以只裁剪索引，详情文件不会删除：

best-memoryx-skill compact --keep 80

说明：npm 包名是 best.memoryx-skill；全局安装后的命令是 best-memoryx-skill；安装到 Codex 后的 skill 名称仍是 best-project-memory，避免破坏已有 AGENTS 规则。

说明

• 只支持 Windows。
• 不创建全局 best_data。
• 不触碰项目已有的 memory/memory.md、memory/merory.md 或其他记忆系统。
• 这是指令驱动的 Codex skill，不是后台常驻服务。
• 追加记忆时会剔除 <private>...</private> 中的内容，避免把敏感上下文写入长期记忆。
• PowerShell 脚本随包以 UTF-8 BOM 保存，兼容 Windows PowerShell 5 的中文模板解析。

发布维护

发布前检查：

npm run publish:check

首次发布：

npm publish

后续发布新版：

npm run release:patch

需要发布功能版本或破坏性版本时，分别使用：

npm run release:minor
npm run release:major