一个经常跟 Claude 唠嗑的码农，折腾出来的提示词版本管理野路子
我大概是从去年开始频繁用 AI 写代码的。用的就是 VSCode + Claude 插件，典型 vibe coding 流。一开始很爽，想到啥说啥，AI 哗哗给我生成代码。但很快我就发现一个问题：每次做一个新功能，都要跟 AI 反复拉扯好几轮。
比如上个星期做邀请好友功能。功能本身不复杂，就是生成邀请码、做个海报、搞个分享链接。但我跟 Claude 聊了大概四十多分钟，中间改了七八次。最后代码是能跑了，但我关了对话框之后突然意识到——我要是下个月再做一遍类似的功能，是不是还得重新跟 AI 聊一遍？那些调过的位置、修过的 bug、试过的方案，全在聊天记录里沉底了。
于是我开始折腾一套适合个人开发者的提示词管理方法。经过两三个项目的实践，现在基本稳定了。写下来分享一下，不是什么高大上的方案，但确实管用。
先把提示词从聊天框里捞出来
我做的第一件事特别简单：在项目根目录建了一个 .prompts 文件夹。
my-project/
├── .prompts/
│ ├── code-review.txt
│ ├── invite-poster.txt
│ ├── api-route-generator.txt
│ └── debugging.txt
├── src/
└── ...
每个 .txt 文件就是我给 AI 的一个“任务模板”。比如做邀请海报那个功能，我的模板长这样：
## 任务
实现一个 React 的邀请海报生成组件。
## 输入
- 用户头像 URL
- 用户昵称
- 邀请码
## 输出
一个 Canvas 绘制的海报，750x1334 尺寸，包含头像、昵称、邀请码、背景图。
提供保存为图片和 Web Share 分享两个功能。
## 技术约束
- TypeScript
- React Hooks
- 处理图片加载失败的情况
- 头像要有圆角
## 已知坑（来自上次经验）
- Safari 上跨域图片会导致 toDataURL 失败，记得加 crossOrigin
- 快速点击保存可能生成两次图片，用 ref 做防抖
然后用的时候直接在 Claude 对话框输入 @.prompts/invite-poster.txt（Claude 插件支持这种引用），或者手动复制粘贴进去。AI 一次生成的代码基本上能直接用，不用再解释一遍“头像要圆角”、“记得处理加载失败”这些东西。
版本号？不用那么重，记一下调整历史就行
提示词不可能一次写对。你肯定会调。比如我那个海报模板，第一版生成的邀请码位置太靠下，第二版头像圆角没生效，第三版才搞定。
我的做法是：在提示词文件末尾加一个“调整历史”区块。
## 调整历史
- 2025-04-09: 邀请码 Y 坐标 800→700，圆角改用 clip 实现
- 2025-04-08: 初始版本，缺少跨域处理
- 2025-04-07: 手写草稿
下次你再让 AI 做类似的事情，可以加一句：“参考调整历史，不要再出现圆角失效的问题”。AI 能看懂。
如果你用 Git，每次改完提示词文件顺手提交一下，commit message 就写你改了啥。比如 git commit -m "调整: 邀请码字号 32px→48px"。这样以后 git log 一看就知道你踩过哪些坑。
把大需求拆成小模板，别写一本百科全书
刚开始我犯过一个错：写了一个巨长的提示词，想把整个邀请功能（前端+后端+数据库）一次性搞定。结果 AI 生成了一坨代码，乱七八糟，前后端混在一起，改都不知道从哪下手。
后来学乖了。一个提示词只做一件事。
邀请功能我拆成了四个小模板：
· invite-code-api.txt —— 生成邀请码的后端接口 · invite-page.txt —— 展示邀请码和分享链接的前端页面 · invite-poster.txt —— 海报组件 · register-with-invite.txt —— 注册时验证邀请码的逻辑
每个模板单独跑，跑通了再合到一起。这样每一轮的反馈都很短，AI 不容易跑偏，我也能看清楚到底是哪一块出了问题。
调整指令也要留痕，但不是每句话都记
跟 AI 沟通的时候，你肯定会说很多话。“再往上挪10像素”、“把颜色改成蓝色”、“加个 loading 状态”。这些需要记吗？
我的经验是：区分“一次性调整”和“通用规则”。
· 一次性调整：比如“按钮从左边移到右边”。这种不用记，下次你大概率不会遇到同样的问题。 · 通用规则：比如“在 iOS 上 Canvas 跨域图片保存会失败，需要加 crossOrigin”。这种必须记，因为你换个项目还会踩。
那怎么记？我一般直接在提示词文件的“调整历史”里写一句话，或者单独开一个 common-pitfalls.txt，把所有跨项目通用的坑都扔进去。
# common-pitfalls.txt
## Canvas 跨域
在 Safari 上，如果 Canvas 绘制了跨域图片，调用 toDataURL 会报错。
解决方案：给 img 标签加 crossOrigin="anonymous"，并确保服务端支持 CORS。
## Web Share API 不支持文件分享
某些浏览器（比如安卓旧版 Chrome）的 Web Share API 不支持分享图片文件。
需要做 fallback：降级到下载图片。
下次做类似功能的时候，直接把这个文件也扔给 AI：“参考 common-pitfalls.txt，避免出现已知问题”。
实测下来效果怎么样？
拿邀请功能来说。以前我做这个，从开始聊到代码能跑，大概需要跟 AI 来回十几轮，耗时一两个小时。用了这套方法之后：
· 第一轮：把 invite-poster.txt 模板扔给 AI，生成初始代码（80% 可用） · 第二轮：微调位置和样式（我直接说“邀请码往上挪20像素”，AI 改好） · 第三轮：把 common-pitfalls.txt 里关于跨域的那条指给 AI，让它加上处理逻辑
三轮搞定，总耗时大概 20 分钟。而且这些模板我后面做另一个项目的时候又用上了，直接把文件复制过去，改几个参数就行。
最后说两句
我不是在推销什么重量级方案。这套东西说白了就是：把你跟 AI 反复沟通的那些“套路”写成文本文件，用 Git 管起来，下次直接复用。
核心理念就是把重复的事情自动化，把经验沉淀成可追溯的资产。对于个人开发者来说，从一个 .txt 文件加几句 commit message 就足够开始了。
哦对了，如果你有什么更好的野路子，欢迎来跟我唠。我这套也还在摸索中。
