【AI Agent：那个不听潜规则的“死脑筋”同事】

AI 编程（Agentic coding）正在倒逼程序员重新学会写文档。François Chollet 提到了一个关键点：Agent 没有人类团队那种“心照不宣”的默契。它读不懂你脑子里的隐性模型，只能看见 API 契约和 Docstrings。

长期以来，很多团队靠“部落知识”维持运转——那些没写在文档里、全靠老员工口传心授的逻辑。人类开发者很聪明，能通过看代码逻辑自行补全文档的缺失。但 Agent 是极度死板的，如果接口定义模糊、边界条件不明，它就会根据错误信息瞎猜，最后让全团队买单。

这其实是一场技术债的清算。过去我们靠人力成本去对冲烂代码带来的理解障碍，人类开发者默默填补了那些没写出来的坑。现在 Agent 把这张账单直接甩到了桌面上，它不接受“看代码你就懂了”这种借口。它像是一个极其挑剔且毫无耐心的同事，逼着你把每一处假设都显性化。

当年亚马逊强制要求所有团队必须通过 API 交互，禁止任何私下沟通，奠定了其云服务的基石。现在的 Agent 扮演了同样的角色：它不是在增加你的工作量，而是在强制你回归软件工程的常识。如果一个系统连 Agent 都带不动，那它对新入职的人类开发者同样是一场灾难。

x.com/fchollet/status/2070148984002469917