
开发者反思:AI agent 的命名决定架构设计
来源标题:The Name Is the Spec
开发者在构建新版 AI agent 时发现,组件名称会直接改变架构本身,命名一变,状态归属和组件边界随之重排。他认为命名之所以困难,是因为名称就是设计本身,精确命名会暴露此前被容忍的模糊之处,例如该叫 escalation 还是 handover 会决定 agent 是否保留所有权。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Gzim Helshani 2026年9月2日 分享 “我的语言的界限意味着我的世界的界限。” ——路德维希·维特根斯坦 我最近正在深入设计一个新版本的 AI agent 架构,反复遇到同一件事:我给它各个部分取的名字不同,设计就会呈现出不同的形态。 不是文档层面,而是架构本身:哪些组件存在、边界划在哪里、哪个组件拥有某份状态、哪个只能读取。我改了个名字,往后做几个决策,整个设计就悄悄围绕这个新词重新排列了。 “计算机科学里只有两件难事:缓存失效和命名。” ——Phil Karlton 这句话大家都听过,但为什么,为什么命名难? 难,是因为名字不是活干完之后刷上去的那层漆。名字就是设计。思考发生在命名里。 当你试着给一个组件取一个精确的名字时,你一直舒服地揣着的那份模糊就无处可藏了。这周我碰到一个:这东西到底叫 escalation 还是 handover?结果发现,这里的命名很关键。escalation 意味着 agent 保留所有权,拉人进来帮忙:有队列、有紧迫性、有人欠一个答复。handover 意味着 agent 交出所有权、退场。不同的状态、不同的失败模式、对客户不同的承诺。我那个模糊的设计可以是两者之一,这意味着两者都不是,也就意味着它还不是一个设计。名字逼出了决策。 跳过这一步的代价会复利累积,因为你在命名决策之后做的每一个决策,都把名字当作约束继承下来。把某个东西叫 Queue,六周后有人给它加上重试逻辑,因为队列就该这么用。但那东西其实是个 ledger,现在每次重试都会把同一条记录写两遍。一个含糊的名字,你不是只付一次钱。之后每一个建立在从未牢固的地基上的决策,都在为它付利息。 这些都不新鲜。领域驱动设计二十年来一直在说,用领域自己的语言去命名事物的这场斗争,本身就是建模。Peter Naur 在 1985 年说过更深一层的版本: “编程理应被视为这样一种活动:程序员借此形成或获得关于手头事务的某种洞见、一种理论。” 名字就是这套理论写就所用的语言。但请注意,在这整个传统里,名字从来只作用于人。它让设计者更敏锐,让团队对齐,系统在人的提升的下游得到改善。 如果你用编码 agent 来设计系统,你已经能感觉到这一点。名字塑造人的理解,是一个缓慢、宽容的过程。模型对你的名字所做的事,既不缓慢,也不宽容。 当我把一个设计交给编码 agent 时,它把我的名字读作 spec。不是指向 spec 的提示,就是 spec。对一个在数百万个代码库上训练过的模型来说,名字是一个检索键:它指向每一个曾经用过这个词的系统。 同事拿到一个含糊的名字,要么来问你,要么挑一种解释继续干。不管哪种,那道缝隙还在,迟早有人要为它买单。而 agent 直接采用你的词在它见过的所有代码库里通常意味着的东西,照着建出来,几秒钟就交回来。代码能编译,测试能通过,看起来像进展,三轮之后你们俩就都建立在一个没人做过的决策上了。 一个坏名字遇到人,代价是现在的时间,以及之后被妥协的决策——名字会硬化成对后续一切的约束。一个坏名字遇到 agent,代价是你的方向。 这现在是可以测量的。2026 年 6 月的一项近期研究跑了 46,535 次受控代码生成实验,覆盖 19 种线索类型,其中就包括变量命名: “附带提示线索,即任务规范之外的上下文词汇或元数据,可以左右模型选择哪种算法,即使所有输出都通过相同的测试。” 他们观察到,最终构建出的算法族出现了高达 100 个百分点的波动。即便是被设计为无意义安慰剂的线索——团队名和项目代号——也平均让分布偏移了 26 个百分点。你的词自带货物,不管你有没有装货。 同样的机制,在名字取得对的时候也会帮你。把一个组件命名为 Orchestrator,agent 就会去够真正的 orchestrator 所用的东西:saga、重试、补偿逻辑。命名为 Gateway,代码就停在边界上,把业务逻辑挡在外面。这些你一个字都没写下来。是那个词带进来的。 所以选名字,也是在选你希望模型替你做多少假设。一个标准词(Orchestrator、Ledger)满载着模型见过的、在这个词之下建起来的一切,大部分是你想要的,有些不是。一个生造词什么都不带,所以每一种行为你都得自己讲清楚。两者都行得通。行不通的是中间地带:用一个标准词去表示略微不同的意思。模型建的是标准含义,不是你的含义。 当我找不到合适的名字时,我就停下写作,去找那个我还没做的决策。到目前为止,每次都有一个。这是我一天里最便宜的警告,而且它在模型把半个功能建在那份模糊之上以前就会响起。 名字现在是一条指令。你选的每一个名字,都是在赌你要把哪一千个系统请进你自己的系统里。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。