2026年6月8日

代码简化器 Agent — 功能落地后的清晰度

Datarim 的代码简化器 Agent 如何在不改变行为的前提下,让近期改动的代码更易读、更一致。

一个能用的功能,并不等于一个易于维护的功能。代码简化器 Agent 在实现完成后运行,审视刚刚改动的部分,并追问一个更聚焦的问题:能不能在不改变任何行为的前提下,让这段代码更清晰?

它的范围被刻意收得很窄。该 Agent 不会审计整个代码库——它只关注当前会话中改动过的代码。这让审查保持快速,也避免它游走到项目中与当前讨论无关的部分。

它做什么

该 Agent 会遍历近期修改过的代码,并在几个特定类别上施加精修。多余的嵌套会被展平。冗余的抽象——一个除了透传调用之外什么都不做的包装——会被移除。那些描述机制而非意图的变量名和函数名会被重命名。仅仅用英文复述代码的注释会被删除。

一条硬性规则:不允许嵌套三元运算符。当某个条件分支成三条或更多路径时,该 Agent 会将其改写为 switch 或 if-else 链,因为这样分支结构就变得可见,而不是被压缩进一个密集的单一表达式。以可读性为代价的简洁,不算简化。

功能永远不被触碰。重构后的代码必须与被替换的代码行为完全一致——每一个输出、每一个副作用、每一条错误路径。该 Agent 应用的是项目自身的编码规范,而非通用风格,这意味着结果会融入文件的其余部分,而不是引入一套新约定。

一个具体例子

某位开发者添加了一个格式化用户显示名称的函数。第一版能跑通:它处理 null、去除空白、回退到邮箱前缀。但它是通过三层深的嵌套三元运算符实现的。代码简化器将其改写为三个清晰排序的检查,每个检查各占一行,并用具名变量保存中间结果。函数的输出没有变化——而逻辑现在一眼就能读懂。

它处在什么位置

代码简化器在 /dr-compliance 期间被调用,这是紧随 QA 之后的加固阶段,合规步骤会调用它来整理近期代码。当在合规周期之外发现清晰度问题时,它也可以按需运行。由于它的范围被限定在近期改动上,它自然地处在实现与归档之间——作为最后一道工序,捕捉开发者因离问题太近而未能察觉的细节。

在 代码简化器参考卡片 上查看完整的 Agent 名册,或阅读 Datarim 是什么 了解更大的图景。