删掉一半注释，AI 反而写得更好？文档越多 AI 写码越烂：开发者怒揭：过期文档正在偷偷坑你的智能体

大白话很多人觉得 AI 编程助手不好用，就拼命给它塞更多说明文档：再来一个 AGENTS.md、一堆架构决策记录、二十个技能包。这位开发者说方向反了。他的理由是：代码天天被跑、被改、被测试，文档却只在有人想起来时才更新，写错了也不会报错，所以会悄悄过期。智能体读到的是「上周的文档」和「今天的代码」两个版本，只能猜，猜错就产出坏代码。他甚至主张删掉大部分重复、过期的注释，只保留解释「为什么这么绕」的那类。

对你意味着如果你在用 Cursor、Claude Code 这类 AI 编程工具，或者团队里维护着 AGENTS.md、CLAUDE.md，这篇观点值得对照自查：文档不是越多越好，过期文档反而是负资产。