深度解析塑造未来的技术文章。

Developer vs Architect:各自何时更占优

开发者与架构师的区别不在头衔,而在谁拥有架构决策。聊聊ADR、耦合、可逆性,以及那次突如其来的“晋升”。

书桌的俯视插画,两条发散的光路,一条纠缠,一条整洁。
敲代码的部分变快了,决策才是现在的核心工作。

上个月我审查了一个 diff,AI 编程助手为浏览器插件的安装记录写了一长串 try/catch。它先尝试获取用户邮箱;如果这里抛错,就退回到用户 ID;如果那里也抛错,就记一条无奈的日志:有人安装了,但我们不知道是谁。代码能跑,但它是错的,因为平台最近收紧了插件能请求的身份数据。“开发者还是架构师”这个问题就藏在这样的 diff 里,而没人告诉你,现在你站在哪一边。

正确的答案不是更好的 catch 块,而是记录一个时间戳,展示一个欢迎页,并告诉市场部:除非用户主动提供,否则安装时别想拿到邮箱。这个决定没有模型能替你做,因为模型不了解你的用户、平台政策,也不知道市场团队这个季度的目标。它只会按你说的去做,而且快得吓人。这意味着提问的人(也就是你)已经要为比代码更大的事负责了。恭喜升职,只是没人提前告诉你。

有个合理的反方观点:很多工程师会告诉你,他们以前的每份工作都要求他们质疑需求,并为接手的工单设计数据模型。没错,在好的团队里,这一直是工作本身。但确实有些东西变了。打字速度曾经是对糟糕想法的天然节流阀:一个平庸的方案要花三天实现,你会先想清楚。如今只要九十秒,方案还没人细想就已经做出来了。过去逼着人做架构思考的摩擦力消失了,而取代它的,只有你自己。

开发者与架构师:两种不同的工作

最简洁的说法是这样的。开发者拿到工单,问的是怎么做。架构师看着同一张工单,问的是它该不该存在,以什么形态存在。开发者在约束之内做优化,架构师则选择约束本身,并且关键在于,要为这个选择在未来两年的后果负责。两者都是真正的工程工作,只是性质不同,失败方式也不同。开发者的失败是一个 bug;架构师的失败,则是等有人发现时,三个团队已经在一堆冗余表的数据模型上开始开发了。

AI 编程工具已经悄悄坐进了开发者的位置。它们是你招过的最快的初级工程师:不知疲倦、表达流畅,却从不肯告诉你,你的需求本身才是真正的问题。你要求按用户记录安装日志,它就给你按用户记录安装日志,并附上一连串回退逻辑,确保它“能跑”,哪怕平台根本不想让你这么做。模型不关心你应用的延迟预算、隐私立场或值班轮换。这不是工具的缺陷,而是它占据的那个位置的职责说明。这意味着,那个会说“不”的位置如果你不坐,就空着。

那么真正坐在那里是什么样子?主要是三件事。足够了解你的用户,能发现某个需求何时与他们的利益相悖。足够了解你系统的耦合关系,能看出一行改动的影响范围。还有,愿意去和写需求的人进行那场尴尬的谈话,而且是在代码写出来之前,而不是在复盘会上。这些都不需要在没人读的 wiki 里画方框加箭头的图。它们全都依赖判断力,而这种判断力无法交给一个从不反驳你的工具。

你已经在做的架构决策

你不需要头衔才能做架构决策,你每周都在日常工单里做这些决定。验证逻辑放在哪里(客户端、API 还是数据库)。调用是同步还是排队。记录什么,刻意不记录什么。新表的结构,以及它和哪些表建立外键。这些每一项都是对未来的一次押注,每一项都会限制或赋能接下来的十个工单。那个安装日志的 diff 看起来像是监控任务,实际上它是一个隐私决策、一个安全决策,也是一个产品决策,只是伪装成了一行代码。

这是改之前的版本,也就是助手忠实实现“记录谁安装了”的结果:

async function logInstall(req, res) {
let identity = null;
try {
identity = { email: await getUserEmail(req) };
} catch {
try {
identity = { userId: await getUserId(req) };
} catch {
identity = { note: "install without identity" };
}
}
await db.installs.insert({ ...identity, at: new Date() });
res.redirect("/welcome");
}

十五行代码,三种失败模式,还有一个必须永远兼容“邮箱、用户 ID 或两者皆无”的 schema。每一层回退都在悄悄把安装路径耦合到身份 API 上,于是一个受同意机制管控的服务出现故障,就可能拖慢甚至打断你的新用户引导流程。而那条写着“有人安装了,但我们不知道是谁”的记录,在分析上毫无价值,市场部拿它什么也做不了。需求从字面上被满足了,精神上却被彻底破坏。

async function logInstall(req, res) {
await db.installs.insert({ at: new Date() });
res.redirect("/welcome");
// Email is collected on the welcome screen, with consent,
// posted asynchronously — and never gates the install path.
}

改之后只有四行。但注意真正变了的是什么:不是代码,而是需求。目标从来不是“获取邮箱”,而是“衡量安装量,并跟进新用户”。时间戳就能衡量安装量。欢迎页则是正确的位置:用户本来就在看一个同意界面,在这里异步请求邮箱,失败也不会带来任何代价。架构师的动作不是少写代码,而是重新协商代码到底是为了什么。

值得养成的一个习惯:在任何非琐碎的改动之前,花两分钟做一次耦合盘点。问问这段代码会调用什么,什么会调用它,以及当这些依赖变慢、宕机或被弃用时会出什么问题。改之前的版本,安装路径依赖了两个它本不该知道的身份服务;改之后,它只依赖一张表。决定你未来事故数量的,是这个依赖数量,而不是行数,也不是圈复杂度。我们在AI 编程助手如何以可预测、可测试的方式失败中也看到了同样的模式:输出在局部看起来合理,在全局却高度耦合。

ADR 与部落知识:各自何时更占优

架构决策记录(ADR)的设计刻意很朴素:一页纸,写清背景、决定、考虑过的备选方案,以及接受的后果。就这些。没有繁文缛节,除非你想要审批流程。ADR 在 AI 时代从“锦上添花”变成“必需品”,原因在于记忆。模型没有记忆。六个月后,有人会把助手指向安装模块,要求做一个改动,而关于同意机制和平台政策的审慎推理就会消失,除非它被写在人类和工具都能找到的地方。仓库里的 ADR,会被下一个碰这段代码的人(或东西)读到。

部落知识在某些情况下确实更占优,假装不是这样,正是 ADR 背上官僚名声的原因。一个两人小团队做原型,寿命只有几周,就不需要决策记录;做决定的人就坐在彼此旁边,代码反正也会被重写。在这个规模下,口头沟通更快、信息更丰富,成本也更低。问题在于,团队很少意识到自己已经跨过了那个临界点:第一个新人入职,第一个团队开始调用你的 API,第一次事故中有人问“我们当初为什么这么做?”却没有答案。

  • 这个决定很难撤回:比如线上数据的 schema 变更、公开的 API 契约、供应商锁定。
  • 这个决定跨越了团队边界,受影响的人在决策时并不在场。
  • 你已经能听见未来的那个问题:“我们当初到底为什么要这样做?”
  • 实现是 AI 工具生成的,因此从来没有人需要把推理过程说出口。
  • 取舍并不显而易见,你是在有意识地接受某种真实成本(延迟、隐私暴露面、运维负担)。

第四条是新出现的情况。人类写代码时,推理会留下痕迹:提交信息、PR 讨论、尝试本身的形态。而助手写代码时,推理只短暂地存在于你的脑子里,然后就消失了。ADR 正是让评审成为可能的产物,因为它给评审者一个可以对照代码去检查的依据。没有它,评审就会退化为挑剔格式,而架构却在悄悄漂移。

带有手绘方框与箭头示意图的笔记本,旁边是钢笔,柔和的窗光下。
ADR 就是那一页纸,它会比代码差异更长久地留存。

系统设计中的可逆与不可逆决策

架构师工具箱里最有用的问题只有一个:我改主意的成本有多高?有些决定是双向门。日志格式、内部函数签名、缓存 TTL,任何一个下午都能回头改。另一些则是单向门。外部客户端集成依赖的公开 API 契约;积累了六个月生产数据的数据库 schema;法律立场已经依赖其上的同意流程。一旦你穿过了单向门,重新考虑的代价就不再是重构,而是一次迁移、一份废弃计划,外加一句道歉。

在动手之前先给门分类,因为 AI 让构建变得便宜,但推倒重来依然昂贵。如果放任不管,助手会非常乐意替你设计数据模型,而失败模式往往是冗余表、重复列,以及一层层堆叠的迁移代码,因为每次提示都是新增一张表,而不是重新审视模型。删除一张有线上数据、被三个服务读取的表,是我们这个行业里最痛苦的操作之一。生成 schema 变得廉价,正是 schema 更值得深思熟虑的原因。把你的思考预算按不可逆程度分配,而不是按代码写起来要多久分配,这个比例已经颠倒了。

我的工作准则是:如果一个决定涉及你无法重新生成的数据,或者团队外的人会依赖的接口,那么在实现开始前,它必须有一份 ADR,并且需要第二双眼睛审视。其他一切都先发布,再迭代。这条规则从个人项目到平台团队都无需修改即可适用,它也正是“快速前进”与“朝着一个你无法回头的方向快速前进”之间的区别。

像架构师一样质疑需求

架构师工作中最让人不舒服的核心,是对地位高于你的人说不。“记录谁安装了”听起来像一个需求,实际上它是某人为“衡量安装量并跟进新用户”这个目标预先想好的解决方案。架构师要把解决方案翻译回目标,再提供一条成本更低的通往目标的路径。这种翻译才是全部诀窍,而没有任何工具能做到,因为工具的全部设计就是服从。有些工程师会给助手加载用户上下文,从中得到还不错的判断,这在边缘情况下确实有帮助,但模型仍然不会走进会议室,告诉市场部他们的跟进邮件不会在安装时发出。

  1. 把目标复述回去,而不是复述解决方案:“我们想衡量安装量,并触达新用户。”
  2. 提供更便宜的路径,并说明它能交付什么:时间戳日志可以完美衡量安装量。
  3. 说清昂贵路径的真实代价:同意摩擦、耦合的安装路径、市场部用不上的数据行。
  4. 给他们一个真正的选择:“如果邮箱很重要,我们就在欢迎页请求,这是它的一天版本。”
  5. 把最终的决定写下来,这样下一个人就不必从头重新争论。

现在说说那个诚实的反对意见,因为它值得被认真对待:没有人因此升职。更可能的情况是,你正在成为模型所做决定的责任承担者,薪水不变,有趣的部分却更少。我不认为这说法有错,我认为这恰恰是你应该认真对待文档习惯、而不是跳过它的理由。ADR 记录也是一份纸面证据。只有当你无法展示自己的推理时,作为做决定的人才会承担责任。写下“因为平台限制身份数据,我们选择时间戳而非邮箱采集”的人,是有保障的。而只把助手生成的东西合并进去的人,则没有。

开发者与架构师:各自何时更占优

这不是排名,而是一种模式切换,关键在于知道眼前的工作需要哪种模式。以下是我自己待办列表中的一些具体情况:

  • 范围明确的 bug 修复,爆炸半径已知:开发者模式更占优。复现、修复、测试、发布。在这里做架构推演就是拖延,只是穿上了西装。
  • 验证需求的原型:开发者模式。如果它成功,代码会被重写;如果失败,代码会被删掉。给一次性的东西写 ADR 是浪费。
  • 需求模糊的全新功能:先切到架构师模式,哪怕只用一小时。模糊之处正是 AI 生成的动能造成最大破坏的地方。
  • 涉及资金、身份或同意的任何事情:无例外,使用架构师模式。构建与推倒重来之间的成本不对称在这里最为严重。
  • 线上数据的 schema 变更或公开 API 变更:架构师模式,并附上 ADR,依据可逆性规则执行。
  • 两人团队,代码库不到六个月:开发者模式,配一份持续更新的笔记文件。完整的流程现在还换不来什么。
  • 受监管领域或有多个消费方团队:架构师模式,并保留记录,因为“为什么”会被审计人员和陌生人问到,而不是朋友。

两个方向的失败模式都是只停留在一种模式里。从不切换到上面的开发者,会交付优雅地实现了错误东西的代码;从不切换到下面的架构师,会画出并不存在的系统的图。我最不想在团队里失去的人,是那些在同一个下午两种模式都能做到的人:上午十点还在争论数据模型,下午两点就去修 off-by-one 错误,而且不会抱怨这种事太低级。如果你正在围绕 AI 产出来构建评审流程,值得读一读智能体编程工具如何组织循环、上下文与权限,因为模式切换必须发生在那个循环之内,而不是之后。

AI 会永远乐此不疲地以高速构建错误的东西。架构师的工作,是判断什么才是正确的东西,并在推理消失之前把原因写下来。

蓝图上绘有相连的发光线条,旁边摊开着一台笔记本电脑。
架构,就是在有人画线之前,先决定哪些线允许存在。

结论:接受这次晋升

我的立场很明确,不是“视情况而定”:凡是涉及数据模型、外部契约或安全态势的事情,默认使用架构师模式;对于范围可控的内容,则留在开发者模式。比例不会是五五开,对大多数工程师来说,仍然是两成架构、八成构建,一如既往。变化在于,构建变快了,而跳过那两成的代价,则按同样的速度倍数上涨。你把越多的敲码工作交给工具,你的价值就越集中在工具无法替代的那部分。

入门工具包只有三个习惯,这周你就能全部装上。第一,在仓库里放一份 ADR 模板,包含背景、决定、备选方案、后果,半页纸即可;下次你接受一个真正的取舍时,就写一份。第二,给每个史诗任务加上两分钟的耦合盘点:这会调用什么,什么会调用它,这些失败时会出什么问题。第三,把可逆性问题写进你的工单模板:“如果这个决定错了,改变主意要付出什么代价?”如果答案是“一次迁移加一句道歉”,就放慢脚步;如果只是“一个下午”,那就不用。

编码的工作不会消失,消失的是敲字的工作。两者从来不是一回事,那些悄悄慌张的人,往往是那些角色已经悄悄缩水、只剩把工单翻译成语法的人。如果你在读 diff 时会问“为什么这段代码和身份 API 耦合在一起”,那你早就在做架构师的工作了。真正的变化只是现在它变得正式了,有文档了,而且归你所有。接受这次晋升吧。