辛辛苦苦做了 3 天的 HTML PPT,被 AI 几秒钟改得面目全非。
想让它回到对话前的那个版本,结果发现根本找不回来。
如果你也在用 Codex、Claude Code、WorkBuddy 这类本地 Agent 直接改工作文件,80% 的概率你迟早会碰上这种事。
说实话,我当时心态直接崩了。
本来只是想把它导出成 PDF,结果 AI 一通操作,直接把我原始文件全改坏了。最后硬生生多花了半天,才让它按前面的对话和要求重新做了一遍。
真·血与泪的教训。
一、为什么 AI 改文件,比你自己改危险得多?
翻车之后我认真想了一下这个问题。
以前我们写文档或者材料,大部分是在飞书、钉钉、Notion 这些在线文档里。它们默认就有历史版本,改错了点一下就能回退,根本没觉得"版本管理"是个事儿。
但现在不一样了。
Codex、Claude Code、WorkBuddy 这些本地 Agent,默认都是在你自己电脑上生成本地文件——markdown、html、PPT 源文件、代码——没人帮你做自动备份。
而且更重要的是:人改文件和 AI 改文件,完全不是一个速度。
你自己改 PPT,通常是拖几个框、改几行字,而且每一步都是深思熟虑之后才下的手。
Agent 不是。它几秒钟就能重写一个文件,甚至同时改一堆文件。你还没反应过来,它已经改完了。
所以,你需要的不是"更小心的 Prompt",而是一个能让你随时后悔的机制。
二、我给自己做的"后悔药"
翻车之后我就痛定思痛,给自己做了一个工具,叫 version-management。
它是一个给 Codex、Claude Code、WorkBuddy 这类桌面 Agent 用的小白级版本管理 Skill。做的事情非常简单:
👉 Agent 修改你已有的本地文件之前,先记录一次当前版本。
👉 修改完成之后,再记录一次。
效果也很直观:
- 如果 AI 改崩了 → 直接说"帮我回到上一个版本",就像玩游戏读档一样。
一句话总结:给 AI 动手前存档,改崩了能退回来。
三、底层原理一分钟讲完
这个"能后悔的机制",技术圈管它叫 Git。
你可以把它理解成一个本地文件的历史记录器——每次改了什么、什么时候改的、谁改的,全给你记下来。而且这个记录是在你电脑上本地做的,不会传到网上,也不会同步到 GitHub,不用担心泄露。
Git 原来是程序员管理代码用的。因为代码项目极其复杂,必须有这么一套机制。
但现在不一样了。
只要你开始让 AI 去改你的本地文件——不管是文档、PPT、HTML、还是 Vibe Coding 的代码——其实都需要 Git。
当然,Git 本身那是真的复杂。一大堆 add、commit、branch、stash、rebase......要在终端里敲命令,我估计大部分人看一眼就劝退了。
所以 version-management 做的事情,就是把 Git 这套能力,包装成了能直接发给 Agent 的人话。
你不需要懂 Git,不需要记任何命令。你只需要说话。
四、三句话,就能装上
用法真的简单到离谱,三步搞定:
第一步:装上这个 Skill
把下面这句话,直接复制给你的 Agent:
请从这个 GitHub 仓库根目录安装本地版本管理 skill—— https://github.com/chituai/version-management 名称是 version-management;如果安装工具需要填写路径,请使用仓库根目录 “.”安装后,以后修改本地已有文件前先记录一次,改完后再记录一次;如果只是新建文件,不需要记录版本。
第二步:确认电脑有 Git
如果电脑还没装 Git(大多数 Mac 自带,Windows 大概率没有),也直接让 Agent 处理:
请先检查我的电脑有没有安装 git。如果没有,请问我要不要安装;我同意后再帮我安装,然后再启用本地版本管理功能。
第三步:把规则写进项目文件
这一步最关键。有了它,Agent 在多轮对话之后依然记得要在改文件前后记录版本,不会聊着聊着就忘了。
把这句话发给 Agent:
请从 https://github.com/chituai/version-management读取 templates/AGENTS.version-management.md,并把里面的版本管理规则合并到当前项目的 agent 规则文件里。根据你自己的规则文件习惯选择 AGENTS.md 或 CLAUDE.md;如果文件已经存在,不要覆盖原内容,只把版本管理规则合并进去。
搞定。从此以后,你的 Agent 就自带"改前存档、改后记录"的肌肉记忆了。
五、平时怎么用
配置好之后,平时你甚至不用刻意提,Agent 就会自动在做任何文件修改之前问一句:
这个文件夹还没有版本记录。我可以先记录当前状态,这样改错了可以回到现在这个版本。要我现在设置吗?
你同意就行,之后它就自动运行了。
如果你想主动看一下某次对话之后到底改了哪些文件,就说:
帮我看看这次 AI 改了什么。
如果真的改坏了,直接说:
帮我回到上一个版本。
就这一句话,Agent 会帮你回到 AI 动手前的状态。
六、几个你可能关心的问题
这东西会把我文件传到网上吗?
不会。所有版本记录都在你电脑本地,不会上传、不会同步到 GitHub,也不会云备份。它就是你的本地"后悔药",不是云服务。
新建文件需要用吗?
不需要。如果你只是让 AI 新建一个全新的文件,不覆盖不修改已有文件,就不需要触发版本管理。它只在"改已有文件"这个场景下工作。
Agent 改错了又改了一次,我能回退到更早的版本吗?
可以。每一次改动前后都有记录,你可以选择回到任意一个之前的版本。
写在最后
说白了其实就一件事:把程序员的 Git,变成普通人的"存档/读档"。
以前我们觉得版本管理是程序员的专属技能。但现在,只要你的工作文件开始被 AI 直接操作,尤其是 PPT 源文件、产品文档、客户方案这种真正重要的东西——你就已经是一个"版本管理的刚需用户"了。
真心建议:别等翻车了再后悔。
三句话,十分钟,把这颗后悔药备好。
我是吃土,带你用产品视角看懂 AI。