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

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

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

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

相关推荐
Csvn7 小时前
换供应商要改一遍代码?把模型接入收进一层网关(C04)
人工智能·aigc·agent
七夜zippoe8 小时前
多 Agent 通信灾难:状态不一致导致雪崩故障的排查与防护
ai·agent·通信灾难·雪崩故障·排查与防护
谙弆悕博士9 小时前
多智能体架构详解:层级树状架构(分级主从型)
运维·架构·大模型·agent·多智能体·langgraph·层级树状
学无止境小袁同学10 小时前
Google ADK 学习指南
python·llm·agent·多agent·google adk·llmagent·agent cli
塑料铲子11 小时前
你的 Skill 越多越蠢?Token 上下文爆炸的求生指南
机器学习·agent
qinglongcn11 小时前
四面统一:记忆/Session/观测/Cron
agent·ai编程
货拉拉技术11 小时前
AI Agent 如何进入实时交易系统:货拉拉的三个实践与一套工程方法论
后端·架构·agent
qinglongcn11 小时前
从 metadata 键到独立列
agent·ai编程
小龙666612 小时前
给 Agent 一张地图,而不是一座迷宫:前端 monorepo 目录结构重构实录
前端·agent
樊小肆12 小时前
agent 不报错才最吓人:自研编码工具半年,我踩了 10 个"看着正常"的运行时坑
前端·人工智能·agent