AB
AB
AiBoss站

全部分类

project

ai-memory-skillpack - 为 Codex CLI 提供有界、失败即关闭的项目记忆层

ai-memory-skillpack 是维护者 tudoumashu 发布的一套项目记忆技能包，面向 Codex CLI，用一套「宪法」、可由代理执行的安装器和失败即关闭的校验器，把仓库记忆限制在固定字节预算内。据项目自述，它把交接笔记压缩成单页快照，按 HOT / WARM / COLD 分层读取，并禁止把密钥写入记忆文件。

ai-memory-skillpack 是一套面向 Codex CLI 的项目记忆系统，由维护者 tudoumashu 以 MIT 许可开源。它要解决的问题很具体：代理在两次会话之间要么彻底忘记项目，要么靠不断追加交接笔记和变更日志来「记住」，而这些文件没有上限，下一次会话还没开始干活，就已经把大量 token 烧在昨天的残留上。项目自述把这种做法称为「带 git 历史的上下文污染」。这套技能包试图给代理一份像谨慎工程师那样的项目记忆：一份简短简报、一张地图、一份陷阱清单，而不是一本永远写不完的日记。

它适合已经在用 Codex CLI 维护真实仓库、并且希望记忆可安装、可遵守、可验证的开发者。据项目说明，同一份技能源也可以选配 Claude Code 支持。

维护者与状态

仓库由 tudoumashu 维护，地址为 https://github.com/tudoumashu/ai-memory-skillpack。创建时间为 2026-09-08，最后提交时间同为 2026-09-08。最新 release 为 v1.25.1，发布于 2026-09-08。截至 2026-10-04，仓库星标数为 362。许可证为 MIT。

需要说明的是，事实表中创建、最后提交与最新 release 三个时间点完全一致，说明这份公开数据反映的是项目早期状态，后续活跃度无法从事实表中判断。

主要能力

以下内容均来自项目自述，属于维护者的自我描述，不是中立评测。

  • 一份「宪法」而非氛围。 据项目说明，SYSTEM.md 是整套系统的规范，规定分层、字节预算、归属标注、替换保护以及「不得写入密钥」等条款，技能文本不得凌驾于它之上。
  • 代理原生安装器。 INSTALL.md 是写给 Codex 执行的文件：适配路径、合并全局规则、启用仓库、写入机器回执、支持回滚。项目自述强调没有图形界面，安装器是给代理运行的程序，且安装可逆。
  • 校验器而非清单。 VERIFY.md 是带真实退出码的断言，包内字节由 SHA256SUMS 固定。
  • 一份技能源，两套运行环境。 项目自述称 Codex 持有真实文件，第二套环境通过符号链接接入，不做分叉副本。
  • 失败即关闭的升级。 全新安装、升级、迁移是三种不同契约；旧包会先被封存。
  • 密钥卫生作为边界。 可选的教练路径会在学习记录进入中央 wiki 之前做净化处理，项目自述称回归测试套件的存在正是因为这一环被当作安全闸门对待。

在读取策略上，项目自述把记忆分为三层：HOT 层每次会话整文件读取，例如 project-card.md 与 handoff.md；WARM 层默认只用 rg 定位到具体小节，不整文件读取，例如架构、运行手册、坑点与当前 ADR；COLD 层仅在用户明确追溯历史时才读，例如 history/、报告、截图与已被取代的 ADR。交接文件被设计成受替换保护的单页快照，而不是日志。

技能方面，项目自述包含三个：ai-project-memory 始终安装，负责每个仓库内有界的 docs/ai/；llm-wiki 仅在存在符合契约的 wiki 根目录时安装；project-mastery-coach 是可选的所有权训练，需要 wiki 加 Python 3.10 及以上。若没有 Obsidian 仓库，安装器会跳过后两者，只装 ai-project-memory。

使用入口

仓库地址：tudoumashu/ai-memory-skillpack。

据项目说明，安装流程是先克隆仓库并校验完整性：

git clone https://github.com/tudoumashu/ai-memory-skillpack.git
cd ai-memory-skillpack
sha256sum -c SHA256SUMS

随后让 Codex 读取包内的 INSTALL.md 并按其中步骤在本机安装记忆系统。项目自述给出的运行环境要求为：Linux 或 WSL、bash 4.4 及以上、git、rg、sha256sum；Python 3.10 及以上仅 project-mastery-coach 需要。macOS 需要 GNU 版本的 sha256sum、flock、readlink -f 以及较新的 bash，否则安装器会停止。

项目自述还提到，仓库内附带的技能文本包含示例性质的绝对路径与 actor 字符串，这些是适配器源值，并不要求使用者采用那些目录或模型。

许可与限制

许可证为 MIT。

限制方面，据项目说明：安装器在 macOS 上依赖 GNU 工具链与较新 bash，条件不满足会直接停止；project-mastery-coach 需要 Python 3.10 及以上；llm-wiki 与 project-mastery-coach 只在存在符合契约的 wiki 根目录时才安装，wiki 的 lint 与查询脚本并不在本仓库内；若技能文本与 SYSTEM.md 冲突，以宪法和本机适配器取值为准；修改了清单中列出的文件后必须重新生成 SHA256SUMS，否则安装器的完整性闸门会失败。

本文未对该项目进行实际安装或运行验证，上述能力与流程均来自项目自述与官方接口数据。

返回