让 AI 少犯错：提示词、规则文件和检查点
写清提示词、用规则文件固定约定、提防上下文丢失和幻觉，再用 Diff、检查点和 Git 给每一步留退路。
AI 犯错，多半是因为信息不够、约定丢了、改动没人检查。下面几件事能挡掉大部分返工。
说清这一次任务：提示词
提示词越具体，结果越接近预期。别说「做个好看的列表」，直接说出布局和组件的名字：「用数据表，上方加筛选栏」。
- 少样本示例：给 AI 一个样板，比如「参照 UserList.tsx 的写法做 ProductList」，它会沿用同样的结构和命名。
- 多模态：模型能看图，可以直接发截图或设计稿（截图生成代码），再用文字补充图里看不出的交互。
- 迭代式提示：别指望一次说完所有要求，先出初版，再一轮只改一两处。
把长期约定写下来：规则文件
系统提示词是工具预先给模型设定的底层指令；规则文件则由你放在项目里，每次对话都会自动提供给 AI，比如 AGENTS.md、CLAUDE.md。适合写：技术栈、组件库、目录约定、禁止事项、改完要运行的检查命令。发现 AI 反复犯同一个错，就把纠正写进去。
本项目使用 React + TypeScript，组件统一用 shadcn/ui，样式只用 Tailwind，不要引入新的 UI 库。新组件放在 src/components 下，不要修改 src/api 目录。改完后运行 pnpm lint 和 pnpm build，通过后再汇报。
提防它会忘、会编
- 上下文窗口：模型一次能看到的内容有上限，按 Token 计算。对话太长，前面的约定会被挤掉。一个任务一个对话，长任务先让 AI 写总结，再开新对话接着做。
- 幻觉：AI 会编造不存在的属性、接口字段和包名。给它真实资料（报错原文、接口示例、相关文件），不确定时让它直说。
- 中大型功能用规格驱动开发：先让 AI 写需求、设计和任务清单，你确认后再逐项实现。
每一步都留退路
Agent 智能体会自己读文件、改代码、执行命令，改动范围可能比你想的大。
- 看 Diff 差异：红色是删掉的，绿色是新增的，确认只改了该改的地方。
- 检查点回滚：改坏了就退回这一轮之前。它不能替代 Git，每完成一个可用阶段就提交一次。
- 重构和加功能分开做，出了问题好定位。
- API Key 放进环境变量，不要贴进代码，也不要提交到仓库。