Grok Bot工程负责人呼吁删除绝大多数代码注释:AI会把临时补丁变成祖传规则

BiRun 讯,Grok Bot 工程负责人 Lauren Tan 呼吁删除代码库中绝大多数注释。她认为,Coding Agent 喜欢模仿现有代码。一条解释临时修复方案的注释,可能被后续 Agent 当成正确做法反复照抄,最终让过时的补丁和变通方案蔓延到整个项目。

Tan 此前就曾在采访中透露,Grok Bot 使用的开发框架 Dune 已经禁止代码注释。她估计,自己遇到的 AI 生成注释有 99% 都在解释无关紧要的历史背景。例如,工程师只是要求某次 PR 不要采用特定写法,Agent 却把这句话写进注释,留给后续 Agent 当成永久规则。

为此,Tan 推荐使用开源工具包 pstack 中的 `/no-comments` Skill。它会调用专门的 Agent 审查注释,找出过时说明和临时变通方案,再通过重构解决根本问题。例如,把原本写在注释里的架构要求,改成自动执行的 Lint 规则,或通过类型系统直接阻止错误写法。

但对于浏览器兼容性、第三方依赖等无法自行解决的外部限制,仍可以保留必要的解释。公开 API 文档和许可证声明也属于例外。

信源

动察 Beating 频道 · 动察 Beating 交流群。
利多 查看原文
你怎么看这条消息?来投第一票

评论

0/500
免责声明:本文内容仅供参考,不构成任何投资建议。
更多快讯