四栏调试卡
卡住的时候照这四栏填一遍,把填出来的整段发给 Agent。四栏都填,它才不用猜。这张卡不是只给这一节用的——以后每个项目、每次报错都能回来照着填,所以值得单独存一份。
先记住一句:报错不是在骂你,是电脑在告诉你"哪儿不对、在哪一行"。看到红字第一件事是把它看清、原封不动地留下来,不是关掉重来。你看不懂没关系——你的活是把它完整搬给 Agent。
1. 四栏,缺一不可
① 报错原文
把红字/报错完整、原样复制进来,别改写、别只留一半。看不懂也照搬。截图不如文字——很多 Agent 看不了图。
② 我刚做了什么
出错前的最后一步。八成问题就出在这一步。"我刚让它加了个筛选""我刚改了配色""我刚 push 了一次"。
③ 期望 vs 实际
你本以为会怎样,结果实际怎样。这条帮 Agent 对准"到底哪里不对",而不是猜你在抱怨什么。
④ 已试过什么
你自己试过的招,哪怕没用也写。免得 Agent 让你再走一遍冤枉路。没试过就写"没试过"。
2. 对照:这样说等于没说 / 这样说它一下就能动手
✗ 等于没说
- "它坏了,你帮我修一下。"
- "报错了,怎么办?"
- "页面白了。"
✓ 一下就能动手
- "我刚把提交按钮改成蓝色,一保存,页面就白了。报错原文是(贴全)……我期望页面正常显示,实际整页空白。我试过刷新,没用。"
3. 空白卡(可以打印下来手填)
课件里 2.6 有一个能自动拼好整段话的生成器。手边没有课件的时候,用下面这份。
① 报错原文(原样贴全)
② 我刚做了什么(出错前最后一步)
③ 期望 vs 实际
④ 已试过什么
4. 修好之后,别忘了这一句
玻璃箱:Agent 修完,别只说"好了下一个"。多问一句"它为什么会坏、你改了什么"。你不用看懂每行代码,但要能听懂"哦,原来是那个 key 填错了 / 那个字段名写错了"。这样下次同类的错,你自己一眼就看出来。
5. 什么时候翻这张卡
- 终端刷出一片红字,你不知道从哪下手
- 页面突然白屏 / 打开是一堆代码 / 按钮点了没反应
- 昨天还好好的,今天一打开就报错
- 跟 Agent 来回说了几轮,它总是修不到点上——多半是你给的信息不够,回来补齐四栏
四栏都填了、发给 Agent 还是修不好?把你填的四栏和 Agent 的来回对话发到群里,或直接找 Abel、助教。有时换个人看一眼报错,一下就通了。