别给烂代码写注释——重写它

观点来自于: 《人月神话》这本书中陈述的原则现在还实用吗?,结合日常经验,觉得很有道理,先给 AGETNS.md 添加上了。

注释应该用来解释「为什么」,而不是弥补代码本身的晦涩。

当你想用注释解释一段代码在做什么时,真正该做的往往是重写它,让代码自解释。

相关推荐
寻道码路1 小时前
大模型工程化实战(十六):政企国产化避坑——合规/信创名录/私有化运维/国产硬件适配/原厂支持这五道关怎么过
大模型·agent·信创·rag·ai工程化·国产化替代·政企ai落地
张忠琳4 小时前
【hermes-agent】Hermes Agent 自我进化原理之一
ai·agent·hermes
Bug收容所5 小时前
学习LangChain day1
学习·langchain·llm·agent
流浪0016 小时前
大模型技术全景(十一):智能体通信协议 MCP、A2A 与 ANP
llm·agent·通信协议·mcp·a2a·anp
半糖程序员7 小时前
从零构建 Agent(10):保存并恢复会话
agent
熊猫钓鱼>_>7 小时前
越顺,越空:当 AI 把学习 “优化“ 到消失
人工智能·学习·ai·llm·agent·ai编程·metaai
每天都要写算法(努力版)8 小时前
【行业前沿报告】给智能体写工具:从接口能调用,到任务能完成
llm·agent
网络毒刘8 小时前
GPT-6.1 Sol 定位速读:成本效率型编码模型与「何时该换本地 Agent」
人工智能·gpt·openai·agent·cursor
后端小肥肠8 小时前
Claude Opus 5.5 做视频:从口播稿到成片,全流程跑通
人工智能·aigc·agent
网络毒刘8 小时前
Manual 模式精修补丁:在 Agent 提案后用最小编辑完成高风险改动
安全·agent·ai编程·cursor