← 参考库学习路径
参考卡 · 配套 2.6 调试思维 · 可反复回看 / 可打印

四栏调试卡

卡住的时候照这四栏填一遍,把填出来的整段发给 Agent。四栏都填,它才不用猜。这张卡不是只给这一节用的——以后每个项目、每次报错都能回来照着填,所以值得单独存一份。

先记住一句:报错不是在骂你,是电脑在告诉你"哪儿不对、在哪一行"。看到红字第一件事是把它看清、原封不动地留下来,不是关掉重来。你看不懂没关系——你的活是把它完整搬给 Agent。

1. 四栏,缺一不可

① 报错原文

把红字/报错完整、原样复制进来,别改写、别只留一半。看不懂也照搬。截图不如文字——很多 Agent 看不了图。

② 我刚做了什么

出错前的最后一步。八成问题就出在这一步。"我刚让它加了个筛选""我刚改了配色""我刚 push 了一次"。

③ 期望 vs 实际

你本以为会怎样,结果实际怎样。这条帮 Agent 对准"到底哪里不对",而不是猜你在抱怨什么。

④ 已试过什么

你自己试过的招,哪怕没用也写。免得 Agent 让你再走一遍冤枉路。没试过就写"没试过"。

2. 对照:这样说等于没说 / 这样说它一下就能动手

✗ 等于没说
✓ 一下就能动手

3. 空白卡(可以打印下来手填)

课件里 2.6 有一个能自动拼好整段话的生成器。手边没有课件的时候,用下面这份。

① 报错原文(原样贴全)

② 我刚做了什么(出错前最后一步)

③ 期望 vs 实际

④ 已试过什么

4. 修好之后,别忘了这一句

玻璃箱:Agent 修完,别只说"好了下一个"。多问一句"它为什么会坏、你改了什么"。你不用看懂每行代码,但要能听懂"哦,原来是那个 key 填错了 / 那个字段名写错了"。这样下次同类的错,你自己一眼就看出来。

5. 什么时候翻这张卡

四栏都填了、发给 Agent 还是修不好?把你填的四栏和 Agent 的来回对话发到群里,或直接找 Abel、助教。有时换个人看一眼报错,一下就通了。