解决 AI 开发中的“失忆症”-Vibe Memory
- 内容介绍
- 文章标签
- 相关推荐
2026.03.31更新：
更新内容+更新方式
这次 vbm 主要做了 3 类升级：记忆结构优化、写入质量控制、多仓库工作区支持增强。
- 记忆结构更清晰
- 优化了 .ai/ 目录下的模板设计，不再只是“空壳提示语”。
- project/、memory/、index/ 的职责更明确，更适合长期维护。
- manifest.json 现在不只是文件计数，还会输出：
- 分类统计
- 基础记忆导航
- 文档健康度
- 正式记录缺失项诊断
- 工作区交接导航
- 正式记忆写入更可靠
- frontmatter 改成真实 YAML 解析与写回，不再依赖脆弱的字符串拆分。
- 正式 bug / decision 记录增加质量门槛，缺少以下内容时会拒绝正式落盘：
- 标题
- 标签
- 路径
- 必填章节
- 这样可以避免记忆文件越积越多，但真正可检索、可复用的内容越来越少的问题。
- 多仓库工作区支持增强
- 如果当前目录不是一个具体 git 仓库，而是一个包含多个子仓库的工作区目录：
- 会自动发现子仓库
- 分仓库生成 diff 候选记忆
- session-close 支持按仓库生成独立 handoff
- 同时修复了一个路径解析问题：
- 以前显式传 --project 时，某些场景会被错误解析到祖先目录
- 现在会优先命中你明确指定的项目路径
- 测试基线补齐
- 新增 Vitest 自动化测试基线
- 当前已覆盖：
- YAML frontmatter round-trip
- workspace 模式的 per-repo handoff
- 正式记录写入前的质量校验
如何升级
如果之前已经装过 vbm，推荐按下面流程更新：第一步：更新 vbm 仓库本体
git pull
npm install
npm test第二步：对每个已接入项目重新执行 setup
node “<vbm-skill-路径>/scripts/setup.mjs” --project “<目标项目>”
需要特别说明的一点
setup.mjs 默认不会覆盖项目里已经存在的 .ai 文档内容。
也就是说，这次升级会更新“协议、入口、索引、hooks、规则区块”，但不会强行重写你已有的项目记忆。如果你希望老项目也采用这次新版模板结构，需要再手动整理或迁移：
- .ai/project/*
- .ai/memory/*
一句话总结
这次升级的重点不是“多加几个文件”，而是把 vbm 从“能记东西”提升到“更适合长期开发协作、质量更可控、工作区场景更实用”。
最近一直在用 Codex、Claude Code 这类 CLI AI 工具做开发，但有一个问题特别烦：
每次新开会话，AI 都像“失忆”了一样。
你要反复告诉它：
- 数据库连接在哪个配置文件
- 某段业务逻辑为什么不能改
- 某个 bug 之前为什么会出现
- 改 A 为什么会连带影响 B
- 这个项目到底有哪些隐藏约束
结果就是：
- 同样的信息反复说很多遍
- 同一个 bug 反复修错
- 改一处动一片
- 新会话几乎等于重新 onboarding 一次
所以我做了这个项目：vibe-memory-skill
1.这是什么
它不是“让模型真的变聪明”。
它做的事情其实更务实：给项目加一层可持续沉淀、可自动读取、可结构化回写的记忆系统。
简单说，就是把原来只存在聊天里的知识，沉淀成项目里的记忆文件，让 AI 每次进入项目时都能按规则读取，任务完成后还能继续补
充记忆。
2.为什么要做这个
原因很简单：
现在很多 AI 开发工具都有一个共性问题：会话断了，项目知识就丢了。
但真正影响开发效率的，往往不是代码生成本身，而是这些“上下文知识”：
- 配置在哪里
- 业务规则是什么
- 历史决策为什么这样定
- 哪些地方改了会有回归风险
- 某类 bug 之前是怎么修掉的
如果这些信息不沉淀下来，AI 每次都只能重新猜。
所以我想做一个东西，让 AI 在开发场景里具备这几个能力：
- 自动读取项目记忆
- 自动避免重复踩坑
- 自动记录 bug 根因和决策
- 自动在修改前召回相关风险
- 不破坏用户现有规则
3.这个 Skill 的核心好处
它主要解决的是开发场景里的“长期记忆”问题。
具体好处有这些：
- 减少重复解释项目背景
- 减少同一个 bug 被反复修错
- 让业务规则不只存在聊天记录里
- 让历史决策可以复用
- 让 AI 在改代码前先看到相关风险
- 支持 Codex 和 Claude Code
- 支持 Windows 和 macOS
- 只追加规则，不覆盖你原来的 AGENTS.md / CLAUDE.md
4.它是怎么工作的
把“规则”和“知识”分开处理：
- AGENTS.md / CLAUDE.md：只负责告诉 AI什么时候读记忆、什么时候写记忆、写入有什么边界
- .ai/ ：负责存项目知识本身
也就是说：
- 规则文件负责“流程”
- 记忆文件负责“事实、决策、bug、风险”
这样不会把业务细节塞爆系统提示词，也不会污染你原本的项目规则。
一句话安装 ：
帮我从这个仓库安装 vbm（Vibe Memory）skill，并在安装后立即执行仓库 manifest 指定的 install_script，为当前项目完成 .ai 初始化、规则追加和默认 hook 配置：GitHub - dengyuwu/vibe-memory: 开发侧项目级的记忆技能 · GitHub
安装后需要重启cli以加载最新的规则文件
一句话卸载：
帮我移除 vbm（Vibe Memory）为当前项目追加的记忆规则：GitHub - dengyuwu/vibe-memory: 开发侧项目级的记忆技能 · GitHub
会修改哪些文件
它不会覆盖你原来的规则文件。
它只会在这些文件里追加一个受控规则块：
- AGENTS.md
- CLAUDE.md
具体行为是：
- 如果只检测到 AGENTS.md，就按 Codex 安装
- 如果只检测到 CLAUDE.md，就按 Claude Code 安装
- 如果两个都有，就两边都接入
- 如果都没有，会创建对应规则文件并写入受控区块
重点是：
它只管理自己追加进去的那一段，不会动你原来写的内容。
会生成哪些文件
它会初始化一套 .ai/ 目录：
.ai/
├── project/
│ ├── overview.md
│ ├── architecture.md
│ ├── config-map.md
│ └── business-rules.md
├── memory/
│ ├── handoff.md
│ ├── known-risks.md
│ ├── regression-checklist.md
│ ├── bugs/
│ └── decisions/
└── index/
├── manifest.json
└── tags.json
这些文件分别用来存：
- 项目概览
- 架构说明
- 配置位置
- 业务规则
- 当前任务交接
- 已知联动风险
- 回归检查点
- 历史 bug 记录
- 技术决策记录
- 记忆索引
更新了一些内容
- 修复了中文召回能力，现在支持中文连续片段和双字token，不再只对英文查询有效。
- 统一了项目根解析，现在优先按 git 根定位，失败时回退到最近项目标记目录；
- 修复了记忆文件重名覆盖问题，新增唯一命名逻辑，会自动生成 -2、-3 后缀。
- 增强了 diff 候选生成的容错，细化了 git 错误诊断；支持在 git 受限时通过 --paths 回退生成 paths -only 候选。
最后，希望大家集思广益，提出更多更好的意见来完善整个工具
网友解答：真诚、友善、团结、专业、开源、共享、协作
--【壹】--：
Mark一下！我去用用
--【贰】--：
这么多文件，如果一个项目长期维护，不会导致文件越来越大吗
--【叁】--：
希望佬能提点好的建议
--【肆】--：
感谢大佬
--【伍】--：
这个帖子沉的有点快啊。。。
--【陆】--：
马克，研究一下
--【柒】--：
点赞 很nice的功能
--【捌】--：
会compact 记忆文件
而且在大也比去读整个项目的代码好吧
--【玖】--：
试试，我现在就是每次/clear后就要重新 onboarding
--【拾】--：
感谢分享
--【拾壹】--：
学习了！！！
--【拾贰】--：
各位佬真是，白天石沉大海，晚上活跃的一批啊
--【拾叁】--：
补一些使用情况截图吧：
image1067×418 34.8 KB
image1089×352 32.4 KB
image1092×480 47 KB
image1090×293 24.5 KB
--【拾肆】--：
好像有记忆的skill,可以问codex让他推荐
--【拾伍】--：
你让ai自己记忆的话是会给你生成一个记忆文件，但是不会自动读写整理
其他skill的话，目前参考了龙虾的self-improving-agent
--【拾陆】--：
前排支持
--【拾柒】--：
本身带的需要你主动跟他说让他记忆，否则不记忆，可以看看他的记忆文件
--【拾捌】--：
我咋记得codex和claude-code都有自己的memory机制，不过有可能是experimental
--【拾玖】--：
就算不clear，每次打开cli也是没有之前的上下文的。总不可能不关cli吧
2026.03.31更新：
更新内容+更新方式
这次 vbm 主要做了 3 类升级：记忆结构优化、写入质量控制、多仓库工作区支持增强。
- 记忆结构更清晰
- 优化了 .ai/ 目录下的模板设计，不再只是“空壳提示语”。
- project/、memory/、index/ 的职责更明确，更适合长期维护。
- manifest.json 现在不只是文件计数，还会输出：
- 分类统计
- 基础记忆导航
- 文档健康度
- 正式记录缺失项诊断
- 工作区交接导航
- 正式记忆写入更可靠
- frontmatter 改成真实 YAML 解析与写回，不再依赖脆弱的字符串拆分。
- 正式 bug / decision 记录增加质量门槛，缺少以下内容时会拒绝正式落盘：
- 标题
- 标签
- 路径
- 必填章节
- 这样可以避免记忆文件越积越多，但真正可检索、可复用的内容越来越少的问题。
- 多仓库工作区支持增强
- 如果当前目录不是一个具体 git 仓库，而是一个包含多个子仓库的工作区目录：
- 会自动发现子仓库
- 分仓库生成 diff 候选记忆
- session-close 支持按仓库生成独立 handoff
- 同时修复了一个路径解析问题：
- 以前显式传 --project 时，某些场景会被错误解析到祖先目录
- 现在会优先命中你明确指定的项目路径
- 测试基线补齐
- 新增 Vitest 自动化测试基线
- 当前已覆盖：
- YAML frontmatter round-trip
- workspace 模式的 per-repo handoff
- 正式记录写入前的质量校验
如何升级
如果之前已经装过 vbm，推荐按下面流程更新：第一步：更新 vbm 仓库本体
git pull
npm install
npm test第二步：对每个已接入项目重新执行 setup
node “<vbm-skill-路径>/scripts/setup.mjs” --project “<目标项目>”
需要特别说明的一点
setup.mjs 默认不会覆盖项目里已经存在的 .ai 文档内容。
也就是说，这次升级会更新“协议、入口、索引、hooks、规则区块”，但不会强行重写你已有的项目记忆。如果你希望老项目也采用这次新版模板结构，需要再手动整理或迁移：
- .ai/project/*
- .ai/memory/*
一句话总结
这次升级的重点不是“多加几个文件”，而是把 vbm 从“能记东西”提升到“更适合长期开发协作、质量更可控、工作区场景更实用”。
最近一直在用 Codex、Claude Code 这类 CLI AI 工具做开发，但有一个问题特别烦：
每次新开会话，AI 都像“失忆”了一样。
你要反复告诉它：
- 数据库连接在哪个配置文件
- 某段业务逻辑为什么不能改
- 某个 bug 之前为什么会出现
- 改 A 为什么会连带影响 B
- 这个项目到底有哪些隐藏约束
结果就是：
- 同样的信息反复说很多遍
- 同一个 bug 反复修错
- 改一处动一片
- 新会话几乎等于重新 onboarding 一次
所以我做了这个项目：vibe-memory-skill
1.这是什么
它不是“让模型真的变聪明”。
它做的事情其实更务实：给项目加一层可持续沉淀、可自动读取、可结构化回写的记忆系统。
简单说，就是把原来只存在聊天里的知识，沉淀成项目里的记忆文件，让 AI 每次进入项目时都能按规则读取，任务完成后还能继续补
充记忆。
2.为什么要做这个
原因很简单：
现在很多 AI 开发工具都有一个共性问题：会话断了，项目知识就丢了。
但真正影响开发效率的，往往不是代码生成本身，而是这些“上下文知识”：
- 配置在哪里
- 业务规则是什么
- 历史决策为什么这样定
- 哪些地方改了会有回归风险
- 某类 bug 之前是怎么修掉的
如果这些信息不沉淀下来，AI 每次都只能重新猜。
所以我想做一个东西，让 AI 在开发场景里具备这几个能力：
- 自动读取项目记忆
- 自动避免重复踩坑
- 自动记录 bug 根因和决策
- 自动在修改前召回相关风险
- 不破坏用户现有规则
3.这个 Skill 的核心好处
它主要解决的是开发场景里的“长期记忆”问题。
具体好处有这些：
- 减少重复解释项目背景
- 减少同一个 bug 被反复修错
- 让业务规则不只存在聊天记录里
- 让历史决策可以复用
- 让 AI 在改代码前先看到相关风险
- 支持 Codex 和 Claude Code
- 支持 Windows 和 macOS
- 只追加规则，不覆盖你原来的 AGENTS.md / CLAUDE.md
4.它是怎么工作的
把“规则”和“知识”分开处理：
- AGENTS.md / CLAUDE.md：只负责告诉 AI什么时候读记忆、什么时候写记忆、写入有什么边界
- .ai/ ：负责存项目知识本身
也就是说：
- 规则文件负责“流程”
- 记忆文件负责“事实、决策、bug、风险”
这样不会把业务细节塞爆系统提示词，也不会污染你原本的项目规则。
一句话安装 ：
帮我从这个仓库安装 vbm（Vibe Memory）skill，并在安装后立即执行仓库 manifest 指定的 install_script，为当前项目完成 .ai 初始化、规则追加和默认 hook 配置：GitHub - dengyuwu/vibe-memory: 开发侧项目级的记忆技能 · GitHub
安装后需要重启cli以加载最新的规则文件
一句话卸载：
帮我移除 vbm（Vibe Memory）为当前项目追加的记忆规则：GitHub - dengyuwu/vibe-memory: 开发侧项目级的记忆技能 · GitHub
会修改哪些文件
它不会覆盖你原来的规则文件。
它只会在这些文件里追加一个受控规则块：
- AGENTS.md
- CLAUDE.md
具体行为是：
- 如果只检测到 AGENTS.md，就按 Codex 安装
- 如果只检测到 CLAUDE.md，就按 Claude Code 安装
- 如果两个都有，就两边都接入
- 如果都没有，会创建对应规则文件并写入受控区块
重点是：
它只管理自己追加进去的那一段，不会动你原来写的内容。
会生成哪些文件
它会初始化一套 .ai/ 目录：
.ai/
├── project/
│ ├── overview.md
│ ├── architecture.md
│ ├── config-map.md
│ └── business-rules.md
├── memory/
│ ├── handoff.md
│ ├── known-risks.md
│ ├── regression-checklist.md
│ ├── bugs/
│ └── decisions/
└── index/
├── manifest.json
└── tags.json
这些文件分别用来存：
- 项目概览
- 架构说明
- 配置位置
- 业务规则
- 当前任务交接
- 已知联动风险
- 回归检查点
- 历史 bug 记录
- 技术决策记录
- 记忆索引
更新了一些内容
- 修复了中文召回能力，现在支持中文连续片段和双字token，不再只对英文查询有效。
- 统一了项目根解析，现在优先按 git 根定位，失败时回退到最近项目标记目录；
- 修复了记忆文件重名覆盖问题，新增唯一命名逻辑，会自动生成 -2、-3 后缀。
- 增强了 diff 候选生成的容错，细化了 git 错误诊断；支持在 git 受限时通过 --paths 回退生成 paths -only 候选。
最后，希望大家集思广益，提出更多更好的意见来完善整个工具
网友解答：真诚、友善、团结、专业、开源、共享、协作
--【壹】--：
Mark一下！我去用用
--【贰】--：
这么多文件，如果一个项目长期维护，不会导致文件越来越大吗
--【叁】--：
希望佬能提点好的建议
--【肆】--：
感谢大佬
--【伍】--：
这个帖子沉的有点快啊。。。
--【陆】--：
马克，研究一下
--【柒】--：
点赞 很nice的功能
--【捌】--：
会compact 记忆文件
而且在大也比去读整个项目的代码好吧
--【玖】--：
试试，我现在就是每次/clear后就要重新 onboarding
--【拾】--：
感谢分享
--【拾壹】--：
学习了！！！
--【拾贰】--：
各位佬真是，白天石沉大海，晚上活跃的一批啊
--【拾叁】--：
补一些使用情况截图吧：
image1067×418 34.8 KB
image1089×352 32.4 KB
image1092×480 47 KB
image1090×293 24.5 KB
--【拾肆】--：
好像有记忆的skill,可以问codex让他推荐
--【拾伍】--：
你让ai自己记忆的话是会给你生成一个记忆文件，但是不会自动读写整理
其他skill的话，目前参考了龙虾的self-improving-agent
--【拾陆】--：
前排支持
--【拾柒】--：
本身带的需要你主动跟他说让他记忆，否则不记忆，可以看看他的记忆文件
--【拾捌】--：
我咋记得codex和claude-code都有自己的memory机制，不过有可能是experimental
--【拾玖】--：
就算不clear，每次打开cli也是没有之前的上下文的。总不可能不关cli吧