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 交流羣。
Tan 此前就曾在採訪中透露,Grok Bot 使用的開發框架 Dune 已經禁止代碼注釋。她估計,自己遇到的 AI 生成注釋有 99% 都在解釋無關緊要的歷史背景。例如,工程師只是要求某次 PR 不要採用特定寫法,Agent 卻把這句話寫進注釋,留給後續 Agent 噹成永久規則。
為此,Tan 推薦使用開源工具包 pstack 中的 `/no-comments` Skill。它會調用專門的 Agent 審査注釋,找出過時說明和臨時變通方案,再通過重構解決根本問題。例如,把原本寫在注釋裡的架構要求,改成自動執行的 Lint 規則,或通過類型系統直接阻止錯誤寫法。
但對於瀏覽器兼容性、第三方依賴等無法自行解決的外部限製,仍可以保留必要的解釋。公開 API 文檔和許可証聲明也屬於例外。
信源
動察 Beating 頻道 · 動察 Beating 交流羣。
評論
0/500
登彔 後參與討論
免責聲明:本文內容僅供參考,不構成任何投資建議。
更多快訊