AI 能写代码,但你要给它真实现场
为什么“帮我修一下”经常越修越乱
AI 看不到你刚才点击了什么,也不自动知道浏览器 Network、后端终端和数据库里发生了什么。如果只说“保存坏了”,它只能同时猜前端、API、权限和数据库。
猜测越多,修改范围越大。
一个差的排错 Prompt
text
保存功能坏了,帮我修一下。缺少:怎样复现、看到什么、错误在哪、哪些文件相关、怎样算修好。
一个可以执行的排错 Prompt
text
目标
修复 AI 留言板点击“保存留言”后没有发出请求的问题。
复现步骤
1. 打开 /messages
2. 输入“你好”
3. 点击“保存留言”
实际结果
页面没有变化,Network 没有 POST /api/messages。
原始错误
Console 显示:
TypeError: Cannot read properties of undefined (reading 'trim')
MessageForm.tsx:24:18
相关范围
先检查 src/components/MessageForm.tsx。
不要修改后端和数据库。
验收
点击后 Network 出现一次 POST /api/messages;空内容仍然不发送;构建通过。这里最重要的不是格式漂亮,而是把猜测变成证据。
让 AI 先解释,再修改
可以要求:
text
先根据 Console 和 Network 证据说明问题最可能在哪一层。
列出准备检查的文件。
确认以后再修改,不要同时重构无关代码。如果 AI 说数据库坏了,但 Network 根本没有请求,你就有证据提出异议。
限定修改范围
一次只修一层:
text
前端没有发请求 先不改数据库
请求返回 401 先不改页面样式
后端日志缺环境变量 先不重写 React 组件
构建类型错误 先不换部署平台这不是永远不能跨文件,而是修改必须由证据推动。
要求 AI 给验证证据
“已经修好”不是验证。让 AI 报告:
text
修改了哪些文件
为什么这些修改对应原错误
运行了什么检查
构建是否成功
还需要你在浏览器完成哪一步你自己仍要重复原复现步骤。
修完以后按同一路线检查
原问题:点击没有请求。
修复后不要只看页面“好像正常”。按原路线验证:
- 打开同一页面。
- 输入同样内容。
- 点击同一按钮。
- Console 不再出现原错误。
- Network 出现一次正确请求。
- Response 正确。
- 页面和数据库结果一致。
AI 提出危险命令时怎么办
这些操作先要求解释影响范围:
text
删除整个 node_modules 以外的目录
重建数据库
git reset --hard
git push --force
删除锁文件并更换包管理器
把鉴权临时全部关掉问 AI:会删除什么、能否恢复、有没有更小的验证方法。
密钥和隐私不要作为调试材料
可以提供:
text
API_KEY 是否存在:是
变量名:AI_API_KEY
返回状态码:401不要提供:
text
真实 API Key
完整 Cookie
Authorization Header 的真实值
数据库连接密码
用户私人数据一份可以反复复制的模板
text
目标:
复现步骤:
1.
2.
3.
实际结果:
预期结果:
Console 第一条错误:
Network 请求、状态码、Response:
后端或构建日志第一条错误:
已经确认的事实:
允许修改的范围:
完成后的验证标准:AI 修改代码后说‘问题已修复’,你还需要做什么?
答案:重新走原来的复现步骤,并查看 Console、Network、后端或数据库结果。AI 的文字总结不是运行证据。