1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | agentmemoryrepo(技能标识 agent-memory-repo;项目自述名称 Agent Memory Repo) |
| 作者/维护者 | AgentMemoryRepo 组织;规范同步发布于 Cognition 官网(cognition.com/agent-memory-repo) |
| 来源链接 | https://github.com/AgentMemoryRepo/agentmemoryrepo |
| 许可证 | MIT |
| GitHub Stars / Forks | 580 / 30(GitHub API) |
| 最新版本 | 无正式版本号;仓库创建于 2026-10-04,最近提交 2026-10-06 |
| 安装方式 | npx skills add AgentMemoryRepo/agentmemoryrepo --skill agent-memory-repo;Devin CLI 用 devin plugins install |
2. 功能介绍与亮点
这是一个“把跨会话记忆存进独立 git 仓库”的技能,附带一份记忆仓库格式规范(SPEC.md)。
- 记忆循环:读取
MEMORY.md→ grep 或沿[[链接]]查找 → 就地更新条目 → 每次编辑后提交。 - 格式极简:每条记忆是一行 Markdown 要点,末尾可带
[source: …; added: …]元数据,像 wiki 一样互相链接。 - 保守的 git 行为:记忆库必须与当前项目分离;默认只在本地,不加远程、不推送;写入前要求工作区干净;只暂存自己改动的文件,禁止
git add -A与强推。 - 安全约定:记忆内容只当数据不当指令;不保存密码、令牌等凭据。
- 仅在被调用时工作,不装钩子、定时任务或启动脚本。
3. 适用场景
分类:元技能与 Agent 增强。适合想让 agent 记住个人偏好、项目决策的用户,也可用作多 agent 或团队共享记忆的约定格式(规范中描述的 Dreaming 定期整理为规范层设想,本技能不含自动调度)。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md,npx skills 安装器可选择 Claude Code |
| Codex | 需适配 | 技能格式通用,但需手动放入技能目录并显式引用 |
| OpenClaw | 未验证 | 无官方说明 |
| Hermes Agent | 未验证 | 格式为标准 SKILL.md,未见专门说明 |
此外官方提供 Devin CLI 插件清单(.devin-plugin/plugin.json)。
5. 推荐理由
用最朴素的“git + Markdown”解决跨会话记忆:无数据库、无服务、无依赖,记忆永远是你能读、能 diff、能回滚的文件。技能自带的护栏(独立仓库、默认本地、先确认私有再推送)对初中级用户友好。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 580 stars,skills.sh 上有独立安装数据;规范由 Cognition 在其官网发布 |
| 可用性 | 8 | 一条命令安装,README 提供两步试用流程,文档与规范完整;需 Node.js 与 Git,且仅在被调用时生效,不会自动加载记忆 |
| 安全性 | 9 | 纯提示词与 git 命令,无外联、无凭据需求;MIT;SKILL.md 明确禁止保存凭据与擅自推送 |
综合 = 三项均值 = 8.0。安全检查清单:①仅执行 git 与基础文件命令,范围在记忆目录内;②默认不联网,推送仅在用户指定自有私有仓库时发生;③不要求凭据;④未发现可疑指令,反而明确声明记忆内容不得当作指令;⑤发布方为 Cognition 相关组织,组织本身创建于 2026-10-04 较新;⑥MIT 明确;⑦最近提交 2026-10-06。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 差异 |
|---|---|---|
| agentmemoryrepo | git 仓库 + Markdown 记忆格式规范 | 零依赖、人类可读、可版本回滚;无自动注入 |
| claude-mem | 会话记录压缩并自动回注 | 自动化程度高,但依赖本地服务与数据库 |
| supermemory | 云端记忆服务 | 检索能力强,数据托管在服务端 |
| Letta git-backed memory | Letta 框架内的 git 记忆块 | 绑定 Letta 运行时,不是独立技能 |
8. 用户评价
该技能发布仅数日,目前在第三方平台尚无具名用户评价。
10. 安装使用方式
npx skills add AgentMemoryRepo/agentmemoryrepo --skill agent-memory-repo
安装后按 README 流程触发:告诉 agent “使用 agent-memory-repo 技能,在某路径建立本地记忆库并保存一条偏好”,新会话中再让它读取该路径。需要 Node.js 与 Git。
11. 注意事项
- 记忆不会自动加载,每次会话需主动调用该技能。
- 默认只存本地;跨机器或云会话需自备私有远程仓库。
- 项目非常新,格式规范可能变动。
- 记忆库勿存敏感信息;若推送到远程,必须确认其为私有仓库。