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

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

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

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

相关推荐
玉鸯2 小时前
多 Agent 系统通信的实现原理与最佳实践
llm·agent·mcp
KaneLogger2 小时前
一套系统,让 AI 写代码的速度变成生产力
人工智能·程序员·代码规范
Tsonglew3 小时前
OpenWorker 代码解剖:一个 AI 同事"敢让它干活"的工程学
agent·ai编程
测试开发技术5 小时前
AI 测试提效 | 告别手工写脚本,分享我的 Playwright + Skill 批量生成 UI 自动化脚本方案
自动化测试·人工智能·ui·自动化·agent·skill·ai测试
喜欢的名字被抢了5 小时前
langgraph教程系列-06-让流程可暂停 - 持久化与 checkpoint
agent·langgraph
喜欢的名字被抢了5 小时前
langgraph教程系列-05-给 agent 装上手脚 - 工具调用
agent·教程·langgraph
leeyi5 小时前
Embedder 接口 + 缓存层源码:一个把 key 撑大 3 倍的实现(第71篇-E57)
aigc·agent·ai编程
JaydenAI5 小时前
[Agent的评估-07]整合MEAI针对自然语言处理相关的评估器
ai·nlp·agent·evaluation·maf
CZW6 小时前
RAG系统核心解析:文档向量化与检索的实践探索
agent
code_371496 小时前
Agent 设计及实现 demo
agent