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

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

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

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

相关推荐
ryan_99622 分钟前
一次讲清大模型应用评测:从 Recall@k、LLM Judge 到 Agent 上线门禁
agent·trace·eval·召回率·大模型评测·evaluation
AI绘画哇哒哒3 小时前
【建议收藏!】35岁后端血泪忠告,这3类人别硬转Agent(过来人亲述)
java·人工智能·后端·ai·程序员·大模型·agent
NeilCarmack4 小时前
Deepseek-harness增加桌面版端序列:第 1 讲 · 命令解析:`pnpm dsh desktop` 的第一步
人工智能·agent·ai agent
你是一个铁憨憨5 小时前
从 GIS 到 Spatial Agent:MCP 如何重新定义 GIS 的 AI 入口
arcgis·ai·agent·mcp·spatial
星野云联AIoT技术洞察5 小时前
Dify 适合什么 AI 应用项目:Workflow、RAG、Agent 与自研系统的边界
agent·workflow·llmops·dify·rag·ai agent·ai应用开发
闲猫9 小时前
LangGraph / Capabilities / Fault tolerance
python·agent·langgraph
ryan_99610 小时前
一次讲清 A2A 协议与 MCP 边界:从 Agent Card 到 Task 生命周期
agent·mcp·a2a·json-rpc·agent通信
安逸sgr10 小时前
AI 应用怎么评测?离线评测、人工评估和线上反馈如何结合?
人工智能·ai·大模型·agent·智能体
demo007x11 小时前
DSH harness 中的上下文管理探秘
程序员·agent·deepseek
MicrosoftReactor13 小时前
技术速递|GitHub Copilot App 入门指南:管理你的工作
ai·github·copilot·agent