有人劝工程师别再写文档，理由却让人笑不出来

先别急着照做。这是一场思想实验，讨论的是智能体时代会把工程师的价值改成什么样。真照着做，后果自负。

最近关于"工程师正在变成AI和用户之间的传声筒"的文章不少，我大多同意。一个人把AI的输出不加判断地转发出去，确实没有增加任何东西。这个判断没问题。

于是我追问了一句不太舒服的话：我加的到底是什么判断？论通用代码，模型比我懂得多；论模式、论API、论一个我只用过两次的库的边界情况，它赢。我脑子里塞满过去的失败，可这并不能帮我抓住下一次失败，因为下一次总是长得不一样。

模型没有而我有的是信息，不是智力，是信息。智能体读过仓库、读过提交历史、读过工单、读过故障频道。它没读过的，是我知道却从没写下来的那部分。

顺着这个逻辑，就有了下面这套策略。

核心主张：写下来就等于送出去

你写下的每一样东西，都会变成智能体的知识。架构文档、运维手册、复盘报告、那句解释"为什么重试是三次不是五次"的注释。一旦进了仓库或维基，智能体就能读到，你在这个话题上的优势就没了。

所以：别写下来。

把关键路径留在脑子里。只能按一种顺序执行的部署流程。必须重启两次的那个服务。看起来没人用、其实有人在用的那个环境变量。这些现在是你的资产，把它们写成文档等于出让股份。

如果有人坚持要文档，就写两个版本之前才成立的那一版。这不算撒谎，它曾经是真的。智能体会读它、照它执行、弄坏点东西，而你会是那个知道原因的人。这就是升职谈话的素材。

把临时绕行方案改个名字，让它看起来像正式功能。legacy_sync_hack() 会招来一个清理用的合并请求，ReconciliationStrategy 会招来尊重。

把决策留在走廊里。有会议纪要的决策，是智能体能引用的决策；在咖啡机旁做出的决策，只活在当时在场的人身上。想办法成为那几个人之一。

一条为智能体时代设计的职级阶梯

如果把这套逻辑当真，职级大概会变成这样：

• 初级：写文档。他会的东西，下一个迭代周期智能体也会。完全可替代。
• 中级：写稍微过时的文档。智能体信了，东西开始坏，坏的速度刚好让这位工程师一直有活干、一直被看见。
• 高级：写智能体解析不了的文档。架构图画成白板照片，运维手册录成语音，维基页面只写一句"问Dana"。
• 资深：本人就是文档。什么都不写，所有事情都从他这里过。问智能体支付流程，它回"上下文不足"；问这位工程师同样的问题，他说"看情况"，而且他是对的。
• 首席：已经让公司相信，文档是一种安全风险。

笑完了，说点不好笑的。

把这条阶梯再读一遍。我待过的每个团队，每一级上都有人。没有人把它当成策略来选，它是默认长成这样的。走廊里的决策、没写下来的绕行方案、那个你不得不去问的人。我们管这叫"部落知识"，说的时候还耸耸肩。

智能体没有制造这个问题，它只是把代价变得看得见了。很多年里，藏信息是免费的，因为唯一会去读你文档的东西，是一个同样忙得没空读文档的同事。现在读文档的东西不知疲倦，而"写下来的"和"实际成立的"之间的差距，就是智能体能做多少、会弄坏多少之间的差距。

真正该让人不安的是：上面那套策略确实管用，能管一阵子。如果你的价值建立在"知道别人没写下来的事"上，那么在有人把它写下来之前，你是安全的。或者，在智能体问出足够多问题之前——它已经开始问了。记忆、仓库访问、连到Jira、Slack和故障日志的连接器。每一轮，公司里没被写下来的部分就少一点，护城河也跟着窄一点。

靠藏信息撑起来的价值是租金，不是技能。租约到期前，它一直付钱。

真正剩下的两样东西

那么人到底能带来什么，既不是信息，也不是纯粹的专业能力？我数出两样，都能扛过下一次模型发布。

一是意图。智能体回答的是它被问到的问题，而我知道那个问题问得对不对。把一个错误的功能实现得完美无缺，依然是一个失败的合并请求，再多的上下文也修不好，因为上下文里不包含"我们本来想要什么"。只有我们知道。

二是责任。合并记录上署的是我的名字。智能体没法在凌晨三点被叫起来，没法坐进故障复盘会，也没法被问"你为什么批了这个"。总得有人为结果负责。这不是质量主张，是治理主张，公司在不再需要我盯空指针检查之后很久，依然需要它。

这两样都不是"我比模型更懂"。两样都是真的。对大多数人来说，诚实的定位大概是：我知道我们本来想要什么，我知道这里以前发生过什么，我会为这件事负责。这足以让你留在循环里。

但这不足以让你自称质量守门人。而且这份工作，比我们讲给自己听的那个版本小得多。

所以真正的建议是

写下来。全都写下来。部署顺序、重启两次、三次不是五次。正因为智能体会读到，才更要写下来——然后它会老老实实把无聊的部分做对，你可以把时间花在它做不了的那两件事上。

你的护城河从来不是那个没写下来的绕行方案，而是你是那个判断它值得冒这个险、并且在出问题时愿意负责的人。

智能体没有拿走你的专业能力，它拿走的是你对"没人写下来的那部分"的垄断。这两件事从来就不是一回事。