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

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

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

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

相关推荐
用户2832096793716 分钟前
上下文工程:决定 Agent 跑到第 50 轮还能不能干活
agent
parksben16 分钟前
OpenSider:让浏览器驱动 Agent
开源·github·agent
桃西西呀20 分钟前
文件监控 Agent 为什么总在关键时刻掉链子
人工智能·llm·agent
半糖程序员36 分钟前
从零构建 Agent(6):让 Agent 完成一次问答
agent
无限压榨切图仔38 分钟前
向量库能搜到内容,为什么还不算学会 RAG
前端·agent
夫子39638 分钟前
【第三部分:第一个 Agent 应用】13. 为 Agent 增加记忆能力:不是记住一切,而是在需要时想起正确的信息
llm·agent
PPPCODE43 分钟前
从零手写一个MCP Agent服务:stdio与SSE两种连接模式的踩坑实录
llm·agent·mcp
Java的搬运工1 小时前
Agent 记忆系统难在取舍
agent
YDS8291 小时前
AI Agent 脚手架 —— Service层和Trigger层接口实现
ai·agent·spring ai
能不能静下心来看1 小时前
手搓三种 Agent 范式后,一次翻车让我看穿了它的本质
agent