1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | okf-agent-memory | GitHub |
| 作者/维护者 | okf-memory 组织（创建者与核心维护者 @sknr，另有 3 名代码贡献者） | GitHub API |
| 来源链接 | https://github.com/okf-memory/okf-agent-memory | — |
| 许可证 | MIT License | GitHub API |
| GitHub Stars | 605 | GitHub API |
| Forks | 44 | GitHub API |
| 最新版本 | v0.2.0（2026-09-12 发布，6 天内连发 5 个版本） | GitHub Releases API |
| 安装方式 | make build 本地编译，或通过 Homebrew tap 安装 okf 可执行文件 |
官方 README |
2. 功能介绍与亮点
这是一个把“项目记忆”落到 Git 仓库里的持久记忆技能：基于 Google 发布的开放规范 Open Knowledge Format（OKF）v0.2，把架构决策、调研结论、运维事实等知识存成 knowledge/ 目录下带 YAML front matter 的纯 Markdown 文件，用标准 git diff/git log 即可审阅历史。
核心能力由零依赖的 Go 工具链 okf 提供：本地内存 BM25 全文检索（官方基准 <300µs）、按需加载的渐进式披露索引（避免一次性把整份知识库塞进上下文）、区分“AI 生成”与“人工核实”的信任分级，以及把知识条目绑定到具体代码路径的 code_refs 治理机制（编辑前可先查该路径是否有生效中的约束）。工具同时提供 CLI 与内嵌 MCP Server 两种接入方式。
亮点：① 全部数据是本地明文文件，无需外部数据库、无需联网、无 Embedding API 调用成本；② okf bootstrap 一条命令即可把完整技能与知识库脚手架拷贝进任意目标项目，不依赖本仓库本身继续存在；③ 项目文档中记录过一起真实的路径穿越安全问题并已修复（见第 6 章），说明有第三方在做安全复核。
3. 适用场景
固定分类：元技能与 Agent 增强——该技能的主体是“agent 自身如何记忆、检索与治理项目知识”，属于调教 agent 本身的能力，而非某个具体业务领域的产出物。
适用于在 Claude Code、Codex 等编程 agent 中长期维护同一个代码库、需要让架构决策与调研结论跨会话保留，又不希望引入向量数据库或按 token 计费的团队与个人开发者；也适用于科研笔记、咨询/教练类客户档案等同样需要“可审计、可回溯”知识沉淀的非软件工程场景。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——README 给出
claude_desktop_config.json的 MCP 配置示例，技能目录也可直接复制进.claude/skills/ - Codex：✅ 原生支持——README 明确列出 Codex 为 MCP 客户端之一，技能本身是通用 SKILL.md 格式
- OpenClaw：❓ 未验证——官方材料未提及，机制上（纯 Markdown 技能 + 可选 MCP）应可运行，但未找到实测记录
- Hermes Agent：❓ 未验证——同上，官方材料未提及
5. 推荐理由
用一个开放规范加一个零依赖的本地小工具，把“agent 记忆”做成了可以像代码一样审查、无需订阅、无需数据库运维的仓库资产，适合不想为记忆功能背上额外基础设施或 API 账单的团队。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 上线 8 天内获 605 星、44 次 fork，增长速度快；已有 induwara.lk、n1n.ai 等多篇独立第三方博客专门撰文介绍该项目 |
| 可用性 | 8 | 文档完整（快速上手、CLI/MCP 双接口参考、入门指南俱全），近一周内连发 5 个版本、维护活跃；但需要本地编译 Go 二进制或另装 Homebrew，不是纯拷贝即用 |
| 安全性 | 8 | 纯本地运行，无网络外发、无需 API Key；有独立贡献者报告并修复过一起 SaveConcept 路径穿越安全问题（见 CONTRIBUTORS.md），License 与漏洞披露渠道均明确 |
安全检查清单：①执行范围限于本地文件读写与仓库自身 Go 二进制，无外部 shell 命令下发；②不联网、不外发数据；③无需任何 API Key 或凭据；④SKILL.md 与文档中未发现可疑指令；⑤维护者活跃且有第三方安全复核记录；⑥MIT License 明确；⑦近一周内持续更新。
7. 跟同类 Skills 相比的优势
| 项目 | 存储方式 | 检索机制 | 依赖 |
|---|---|---|---|
| okf-agent-memory | Git 仓库内 Markdown + YAML front matter | 本地内存 BM25，零 token 成本 | 零外部依赖，纯 Go 二进制 |
| claude-mem | 本地 SQLite 压缩存储 | 自动压缩摘要后按需注入 | Node.js（npx 安装） |
| supermemory | 托管 API + 向量库 | 云端语义检索 | 需注册账号与 SDK（npm/pip） |
claude-mem 侧重“自动帮你压缩会话历史”，几乎零配置但存储格式不直接可读；supermemory 走托管服务路线，适合需要跨设备同步的场景但引入了外部依赖。okf-agent-memory 的差异化在于坚持纯文本、纯本地、可用标准 Git 工作流（diff/PR/审查）管理知识，且明确区分“AI 生成”与“人工核实”两种信任等级，更适合看重可审计性、不想额外付费的团队。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，仅有若干篇技术博客对项目机制做了介绍性报道（如 induwara.lk、n1n.ai 的专题文章），尚未见到使用后的具名反馈。
9. 其他补充
项目文档区分了 OKF 规范本身（Google 发布的开放格式）与 okf-agent-memory（本仓库的独立 Go 实现）——后者并非 Google 官方项目，是社区对该规范的一种实现。仓库另提供 docs/ALTERNATIVES.md，从存储位置、检索延迟、信任层级等维度系统对比了 Mem0、Letta 等托管方案与普通 AGENTS.md 手工笔记方案。
10. 安装使用方式
- 克隆仓库后执行
make build，生成bin/okf可执行文件（需 Go 1.26+）；也可通过官方 Homebrew tap 安装 - 在目标项目中运行
./bin/okf bootstrap /path/to/project --name "项目名"，一次性生成knowledge/、.agents/skills/okf-memory/（含完整 SKILL.md）与项目专属AGENTS.md - 如需 MCP 接入，运行
./bin/okf mcp knowledge并在 Claude Code / Codex 的 MCP 配置中登记该命令 - 日常使用中 agent 通过
okf search/okf show/okf create/okf update等命令（或对应 MCP 工具）查询与维护知识库，改动前建议先执行okf validate --strict --drift检查一致性
11. 注意事项
- 需要本地具备编译 Go 程序的环境，或依赖 Homebrew 分发，比纯 Markdown 拷贝型技能多一道安装步骤
- 项目创建仅一个多月，版本号仍在 0.x 阶段，接口与文件格式可能随规范演进而调整
- OpenClaw、Hermes Agent 上的兼容性未经官方或第三方验证，实际使用前建议先在小范围项目试用