给 AI 生成代码加上简洁性约束
文章将 DRY、KISS、YAGNI 等代码原则用于审视 Agent 生成的代码,重点防止重复逻辑、过度抽象和提前实现需求。核心问题是生成速度提升后,如何控制长期维护成本。
AI 深度解读
AI Agent 能迅速写出代码,也会迅速堆出重复逻辑、多余抽象和职责混乱的模块。作者的办法,是把五条整洁代码原则放进生成前的约束,再用审计技能检查生成结果,把人工审查的入口缩小到具体问题。
这篇值得看的地方,是如何把熟悉的工程原则接到 AI 编程流程里。不过,作者没有提供效果对照,安装命令还存在明显疑点。原则、工具设想和已经证实的收益,需要分开看。
五条原则,管的是以后改代码的成本
作者把整洁代码的判断标准放在六个月后:到时还能不能理解、修改这段代码?今天能跑通,只回答了其中一部分。
DRY 要求同一条业务逻辑有明确的唯一来源。例如,邮箱校验复制到五个文件里,规则变化时就需要同步修改五处。抽成 assertValidEmail,目的是集中维护规则。这里也有边界:看起来相似的代码,未必属于同一条业务规则,不能为了消灭重复而强行合并。
KISS 约束实现复杂度。判断用户是否活跃,user.status === "active" 已经能解决问题,就没有必要引入 UserActivityStatusManagerFactory。多出来的层次,每一层都要由后续维护者理解。
YAGNI 则约束需求范围。今天只需要发一封邮件,就先完成发邮件;多区域、AI 驱动、兼容区块链的通知系统,是作者用来讽刺过度预设的例子。
KISS 问的是实现是否过重,YAGNI 问的是需求是否真实存在。
另外两条容易混淆。关注点分离(Separation of Concerns)要求数据访问、业务规则、展示各有位置;单一职责原则(SRP)要求一个类或模块有清楚的工作边界。PaymentService 处理支付,就不该顺便生成 PDF 报表、发送营销邮件。
它们共同针对一种常见问题:一个函数同时获取数据、校验、处理业务、格式化响应、发邮件。代码集中在一起确实方便起步,但任何修改都可能波及其他行为。
把规则放进生成过程,再让审计指出具体问题
作者说,自己无法逐行检查 Agent 的所有产出,于是从生成前后两端介入。标题提到两个技能,正文实际给出了两组,共四个。
第一组处理整洁代码:
/clean_principles-first在生成代码时提供五条原则,减少重复逻辑、多余抽象和handleEverything()式函数。/clean_principles-audit在生成后逐条检查,报告问题位置及修复优先级。
第二组处理 SOLID。作者把它概括为关于类和模块依赖关系的五条设计原则,没有在这篇展开解释:
/solid-first用于新建或重组模块、接口,以及新增支付提供方等场景,强调新增变体可以通过扩展实现,业务逻辑避免硬编码基础设施。/solid-audit分别评价 S、O、L、I、D,提供file:line证据,并指出没有实际需要的抽象。
其中一个约束很实用:不要因为采用 SOLID,就为唯一实现强行增加接口。否则,防止复杂度的规则反而成了制造复杂度的理由。
作者称,-first 技能会在 Agent 写代码时自动加载,审计则按需运行。但原文没有展示技能内容、触发配置或适用工具范围,不能据此认定所有 Agent 都能自动识别。
安装示例有疑点,不能原样复制就算完成
原文给出的命令意图是克隆仓库,再把四个技能复制到项目的 .claude/skills:
git clone https://github.com/nrimen/clean-code-skills && mkdir -p .claude/skills && cp -r clean-code-skills/{clean-principles-first,clean-principles-audit,solid-first,solid-audit} .claude/skills/Source code: nrimen/clean-code-skills.
要注意最后一行的 .claude/skills/Source code::来源说明被粘进了命令,不能当成可靠的安装指令直接执行。作者说这条命令适用于 Git Bash 或 WSL,但这不消除文本自身的问题。
PowerShell 示例也原样保留,便于看清差异:
git clone https://github.com/nrimen/clean-code-skills; mkdir .claude\skills -Force; "clean_principles-first","clean_principles-audit" | ForEach-Object { Copy-Item -Recurse "clean-code-skills\$_" .claude\skills\ }
注意 ForEach-Object 前的数组:这里只列了两个技能,而且目录名用了下划线;上一条复制命令使用的是连字符。原文没有解释目录是否同时存在。因此,「一行安装四个」与这段 PowerShell 示例并不一致,需要先核对仓库实际结构。
我的判断
我认可把原则提前交给 Agent,再要求审计给出证据。比起只在任务末尾加一句「注意代码质量」,逐条检查、定位到 file:line、给出优先级,更容易让开发者采取行动。
但它仍然是经验方案。作者提到约一年的成长经历、数百个 bug 和大量工单,没有给出启用技能前后的缺陷率、审查耗时或误报率。「一小时审查变成两分钟阅读」也是作者的表述,缺少可复核的测量条件。
与 ESLint、类型检查、测试相比,这些技能更适合补充职责边界、需求必要性等判断;它们的报告仍需要人确认。代码重复可能是业务差异的合理保留,一个短函数也可能藏着错误规则。
审计报告可以帮助安排审查顺序,不能证明代码已经正确。
能拿来做什么
- 给前端或 Node Agent 下任务时,把「不增加未要求的功能、保持业务规则单一来源、避免无必要的抽象」写成明确约束,并结合项目现有结构说明边界。
- 审查生成代码时,先找同时承担数据访问、业务处理和展示职责的模块,要求 Agent 指出拆分理由及修改影响,再决定是否调整。
- 对新增接口、工厂和服务层,要求 Agent 解释当前有哪些实现与调用方。只有想象中的扩展需求时,优先考虑简单实现。
- 尝试这些技能前,先核对目录、命名和触发方式;使用后保留人工抽查与原有检查流程,观察报告是否确实帮助发现问题。