报错怎么交给 AI？

04-01 报错怎么交给 AI？

课程定位

这一课进入运行和排错。项目第一次运行后，学员很可能会遇到红字、英文、空白页面、命令失败。排错能力的第一步，是把现场完整交给 AI。

报错是机器递上来的现场证据。证据越完整，AI 越容易判断下一步。

这一课的成果是一张「报错协作卡」。

本课目标

• 能复制完整报错。
• 能提供当前目录和运行命令。
• 能说明期待结果和实际结果。
• 能补充已经尝试过的动作。
• 能让 AI 先判断错误类型，再给下一步检查。

录制建议

• 建议时长：25 到 35 分钟。
• 现场制造一个简单报错，例如文件名写错或目录站错。
• 演示“只发一句报错”和“完整现场”的差别。
• 重点讲复制完整输出，不要只截图最后一行。
• 收尾让学员保存报错协作卡。

课前准备

• 一个可以运行的小项目。
• 一个可控报错场景。
• 终端。
• AI 工作台工具。
• 报错协作卡。

讲稿正文

可以这样开场：

“报错出现时，普通人的第一反应往往是紧张。其实在 AI 工作台里，报错是一份很珍贵的线索。我们要练的动作，是把线索打包完整，交给 AI。”

先展示坏示范：

报错了，怎么办？

这句话只表达了情绪，没有给现场。AI 只能猜。

报错协作要交七样东西。

第一，我的目标。

比如“我想运行 CSV 转 Markdown 小工具”。AI 需要知道你原本想完成什么。

第二，当前目录。

终端当前站在哪个文件夹里很关键。很多命令失败，都源于目录不对。

第三，刚才运行的命令。

命令要原样复制。不要凭记忆改写。

第四，期待结果。

比如“我期待浏览器打开页面”或“我期待生成 output.md 文件”。

第五，实际发生了什么。

比如终端报错、页面空白、按钮没反应、输出文件没出现。

第六，完整报错。

从命令开始，到最后一行输出，都尽量复制。红字前面的几行常常也有重要信息。

第七，已经尝试过的动作。

比如刷新页面、重新运行、改过文件名、重启终端。AI 知道这些，可以减少重复建议。

最后提醒：

“不要急着让 AI 直接修。先让它判断错误类型，告诉你下一步最该检查哪里。”

可以这样说：

请先判断这是目录问题、命令问题、依赖问题、文件缺失、路径问题，还是代码逻辑问题。
然后只给我下一步最小检查动作。

最后收束：

“你交给 AI 的是一份完整现场。现场越完整，修复越快。”

屏幕演示流程

1. 打开项目文件夹。
2. 故意在错误目录运行命令。
3. 展示终端报错。
4. 先给 AI 坏示范：“报错了，怎么办？”
5. 复制当前目录、命令和完整报错。
6. 填写报错协作卡。
7. 把协作卡交给 AI。
8. 要求 AI 先判断错误类型。
9. 根据 AI 建议执行下一步检查。

给 AI 的协作卡

我在运行项目时遇到报错。

我的目标：
【我想完成什么】

当前目录：
【粘贴当前目录】

运行命令：
【粘贴命令】

期待结果：
【我原本希望看到什么】

实际结果：
【实际发生了什么】

完整报错：
【从命令到最后一行，完整粘贴】

我已经尝试过：
【列出尝试过的动作】

请先判断错误类型，再给我下一步最小检查动作。

报错协作卡

• 目标：
• 当前目录：
• 运行命令：
• 期待结果：
• 实际结果：
• 完整报错：
• 已尝试动作：
• AI 判断的错误类型：
• 下一步检查：

课堂练习

让学员用课程准备的报错材料填写报错协作卡。

要求：

• 命令和报错必须完整。
• AI 必须先判断错误类型。
• 下一步检查只执行一个动作。

常见卡点

• 学员只发最后一行红字：提醒复制完整输出。
• 学员忘记当前目录：先运行查看目录的命令。
• 学员说“打不开”：补充期待结果和实际画面。
• AI 一次给很多步骤：要求它只给下一步最小动作。
• 学员急着乱试：先记录现场，再按顺序检查。

课后作业

保存一次真实或模拟报错协作记录。

提交内容：

• 报错协作卡。
• AI 的错误类型判断。
• 实际执行的下一步检查。

课件页建议

• 第 1 页：报错是现场证据
• 第 2 页：坏示范缺了什么
• 第 3 页：报错协作七件套
• 第 4 页：完整报错怎么复制
• 第 5 页：先判断类型，再执行一步
• 第 6 页：报错协作卡