麻了，用AI写代码总是崩？加了这个约束文件，错误率直接降了90%

麻了用AI写代码总是崩封面图

社群里最近被问烂了一个问题：

为什么让AI写的代码，跑两下就崩了？

答案不是AI变笨了。

是你没给它立规矩。

说一个真实发生过的小剧场吧——

你：帮我写个脚本，把 D 盘的文件整理一下。

AI：好的！（自信满满输出 200 行）

你：（满心期待，复制粘贴，运行）

终端：FileNotFoundError: No such file or directory: '/data/files'

你：???

AI：（淡定）抱歉，稍作修改——

你：（再等 5 分钟）

终端：AttributeError: 'NoneType' object has no attribute 'split'

一顿操作猛如虎，一看战绩 0/5。

这不是AI的锅。

它根本不知道你在用 Windows，它默认就往 Linux 路径格式上写。

三个真正的崩溃凶手

不是模型太弱，而是它对你的项目一无所知，只能靠猜。

不是提示词写错了，而是没人告诉它哪些事能干、哪些绝对不能碰。

不是Bug难修，而是对话上下文越来越脏，越改越乱，最后一锅粥谁也救不了。

把这三个认清楚，你就知道该从哪下手了。

AGENTS.md 是什么？

不是插件，不是要付费的新工具。

就是在你的项目根目录，放一个普通文本文件，取名叫 AGENTS.md。

VS Code中AGENTS.md项目约束规则配置截图

AI 每次读你的项目代码，都会先把这份文件读一遍。

知道规矩，再动手。

就像新来的实习生，不是让他随便发挥，而是先递给他一份岗位职责说明书，告诉他什么能做、什么碰了就完蛋。

规矩在，乱猜就少了。

写进去的四条核心规矩

路径不许乱来：跨平台文件路径必须用 os.path.join()，禁止硬编码斜杠——这条单拿出来能堵掉 60% 的 FileNotFoundError。

不知道就停下来问：遇到不确定的 API 用法，不许凭空虚构，必须主动暂停提问，不是闷头写出来让我来排错。

改之前先存档：动关键代码前提醒我跑一下 git commit，随时留好后路，不是改到一半出事了才后悔。

死磕超过两次就停：同一个 Bug 改了两次没好，立刻停手别继续，开新对话重来，不是继续在脏了的上下文里越挣扎越深。

加了AGENTS.md前后终端报错对比截图

四条规矩下去，AI就从"随机乱猜"变成了"有边界的执行者"。

这次一顿操作，战绩真的可以到 5/5 了。

配置三分钟，省的是几小时抓狂

毒蛇的解药，往往就在九步之内。

AGENTS.md 就是这个解药，而且就放在项目根目录这九步以内。

创建文件，写进四条规矩，保存。

然后再跟AI协作，感受一下有规矩和没规矩的区别。