最好用的文档，不该像摆在前台的画册，而该像后厨墙上的出单纸：油渍斑斑，但谁看谁能开工。我判断，Agent（能自己调工具干活的智能助手）时代，最好用的文档先服务机器。字节跳动做 DeerFlow，最值钱的不是又堆了一套能力，而是先把这件事写明白了。
多数人对文档还有旧时代的迷信：以为它首先是讲解员，是给人看的说明书。错了。到了 Agent 时代，人越来越像甲方，负责提意图、按确认；真正趴在文档上逐行啃的，是代理。人说一句“帮我装起来”，机器去找路径、命令、密钥、失败条件。前台是人话，后台是机器话，可后台才决定菜能不能端上桌。
所以 DeerFlow 最见功夫的，不是它会拉起多少子代理，不是它会不会做播客，而是它在说明文件里，干脆给了编程代理一条能直接照办的安装路数：没拉仓库就先拉，照安装说明把本地环境起好，做不动了再回来问人。你看，这已经不是“教人使用产品”，这是“指挥机器替人动手”。文档从说明书，变成了调度书。
周三晚上十一点，一个刚进组三天的后端，把那句安装话丢给 Claude Code（Anthropic 的命令行编程助手）。他没读完文档，代理却读得比他认真：仓库拉了，依赖装了，能自动配的全配了，最后只回来问两件事，模型选哪个，密钥放哪里。旧文档喜欢考人，新文档该让机器替人做题。
过去用户读文档是为了理解，现在代理读文档是为了执行。
第二个场景在微信。晚高峰里，一个运营把投诉表甩给机器人：把昨天退款原因分三层，先看情绪，再看品类，再看触发话术。她不会去翻登录方式、通道配置、文件大小上限，她只会发一句话。可那一句话能不能落地，全看背后的文档有没有把二维码登录、权限白名单、状态目录、文件路径写成机器能照抄的句子。微信对文档最不客气：它不给你“慢慢阅读”的体面，只问你“现在能不能办”。
机器不怕难，机器只怕含糊。
第三个场景在凌晨两点。值班工程师看到消息流断了，第一反应是把网关多开几个进程。要是文档只会写“支持扩展”，今晚就等于给事故敬酒。可 DeerFlow 把边界写得很绝：这个地方别乱加，因为任务取消、流式回连、请求去重都会一起坏。真正救命的文档，从来不是文采好，而是肯把丑话写前头。
对机器不诚实的文档，迟早也会对人不诚实。
这件事最反常识的地方在于：机器越会做事，文档越不能写成散文。过去一句“请按需配置环境”还能糊弄过去，现在不行。现在你得把命令写出来，把默认值写出来，把缺哪一项会卡住也写出来。因为会聊天的模型可以替你粉饰暧昧，会干活的代理却会把每一个暧昧放大成故障。
文档一旦先喂机器，形容词就开始失业。
DeerFlow 连技能都不是写成励志手册，而是写成 Markdown（带标题和步骤的轻量文本）文件：什么时候触发，先做什么，再查什么，最后产出什么。代理不是来欣赏作者的，它是来领工单的。一个产品如果真想被代理接住，最重要的设计往往不在界面，而在文档里那些看似枯燥的坐标。
更深一层看，这不是文档格式的小修小补，这是劳动方式在变。过去软件默认服务一个坐在电脑前、愿意抽半小时看说明的人；现在软件服务的是一个被会议切碎、在微信里下命令的人，再加一个替他奔跑的代理。人负责发愿，机器负责跑腿。于是文档也改了命：它不再是知识陈列柜，而是劳动分发系统。
谁把文档写成动作，谁就把产品变成劳动力。
所以今天不少公司的文档，其实还活在前朝。标题做得像牌坊，段落写得像贺词，真正要紧的命令、权限、边界、失败条件却东躲西藏。那不是文档，那是广告投放。有些文档像穿西装的门童，点头如捣蒜，真问路却只会把你送回大厅。给人看，耽误人；给机器看，害死人。
我觉得，字节跳动做 DeerFlow，真正先进的地方不是又造出一个会说话的东西，而是承认了一件很朴素的事实：在 Agent 时代，产品的第一用户，常常不是人，而是替人做事的机器。谁先接受这件事，谁的产品就先从“能演示”变成“能交付”。菜单写得再风雅，后厨也不会因此多出一道菜。先让机器开工，人才有空谈体验。
别人聊 AI，我们测 AI——每个结论都能下载原始数据自己复算。 更多 AI 深度测评 👉 https://crawdpad.com