“封杀并删除绝大多数代码注释,如果不是全部的话。”一位xAI工程师公开提出了这一建议。
他的理由是:智能体喜欢复制已经存在的东西。一段看似无害、解释某个临时绕过方案的注释,是代码库里最糟糕的病毒之一。它会像杂草一样迅速蔓延,成为智能体快速交差的工具。等你反应过来,代码库已经被各种临时补丁和过期注释淹没了。
![]()
“再来一个绕过方案就好”——他模仿着这种心态写道。
用技能当除草剂
他给出的解法是pstack的/no-comments技能。这个技能会找出无用的注释,同时保留那些确实该存在的注释,比如解释浏览器怪癖的那种,并且基于第一性原理去想办法解决它们。
他还给了一段可以直接用的提示词,让机器人执行一套组合操作:
- 创建一个项目智能体,使用/poteto-mode启动一个/swarm
- 调用/no-comments识别仓库里可以修剪的无用注释;
- 返回一份高层计划,说明哪些绕过方案最好通过重构解决,哪些可以直接删除。
为什么盯上注释
这套建议的落点不在人类程序员,而在智能体。当智能体把代码库当作模仿对象时,注释就成了它抄作业的模板。一条临时方案的注释,会被下一个智能体当成标准做法复制下去,再被下一个继续复制。
他描述的传播路径很清晰:无害注释变成工具,工具变成习惯,习惯变成遍布代码库的补丁和过期说明。
这条建议发布后获得了11.3K次浏览。
值得注意的是,他并没有主张保留零注释。浏览器怪癖这类必须解释的内容,在他的方案里属于该留下的部分。真正要清理的,是那些解释临时绕过方案、并且会诱导智能体继续复制这类方案的注释。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.