给 AI 改界面前，先让它知道屏幕有三个读者

有开发者在 X 上给 vibecoders 提了两条 AGENTS.md 规则。AGENTS.md 可以理解成给编码代理看的项目说明文件，代理动手前先读它。规则很短，指向很具体。

第一条：每个屏幕都有三个读者。看界面的用户，改界面的开发者，以及下一个编辑它的代理。三种体验都要服务，否则就是拆一个补另一个。

第二条：删掉只为解释布局而存在的标签。如果屏幕需要说明文字才能看懂，屏幕本身就有问题。

原推截图：

这里最容易被忽略的是 AX，agent experience。它不是让界面看起来对代理友好，而是代理能不能不靠猜找到该改的地方。作者在回复里补了一张图：一个屏幕，三个读者。用户看到渲染结果，开发者看到组件文件，代理要先读 AGENTS.md，找到 SaveButton.tsx，编辑，再检查屏幕。路径清楚，代理少读文件，少猜位置。

作者对 AX 的补充很关键：代理应该能找到要编辑的东西，不用猜。改一个按钮要读六个文件，即使用户看到的结果完美，AX 也是差的。一个组件，一个明显的修改点，用户看到的东西不能坏。

评论里有开发者说，代理不知道东西放在仓库哪里就会猜，猜最耗时间。也有人说，只设计给今天看屏幕的人，会漏掉明天维护它的人。另一条回复更直接：AX 常被忘掉，直到代理改坏刚修好的布局。

也有人质疑，小团队同时兼顾三种体验太难。这个质疑成立。两行规则没有增加新流程，它把可维护性往前挪了一步：让代理先知道屏幕有几个读者，再动手。

来源：Khairallah AL-Awady 的推文 https://x.com/eng_khairallah1/status/2117321468841517449