看你文档的，已经不全是人了
先说结论：现在看你的文档的，已经不全是人了。编码助手、企业 AI 搜索、聊天机器人——Agent 正在成为一类全新读者。海外一项千人规模的行业调研里，有位资深文档负责人的判断一针见血：Agent 是一种新用户，对人好的写法，未必对它好。
先说结论：现在看你的文档的，已经不全是人了。编码助手、企业 AI 搜索、聊天机器人——Agent 正在成为一类全新读者。海外一项千人规模的行业调研里，有位资深文档负责人的判断一针见血：Agent 是一种新用户，对人好的写法，未必对它好。作为 Baklib 的产品运营，这个变化我跟踪了两年，今天把几个反常识的发现讲给你听。
第一个反常识：llms.txt 靠不住。很多团队以为给 AI 单独维护一份说明文件就万事大吉——实际用下来，智能体们并不怎么认真读它，渠道一多，这份文件就成了自欺欺人。
第二个反常识：长页会被静默截断。你精心组织的万字长文档，智能体拉取的时候可能只读了前半段——你不知道它没读完，它也不告诉你。这比不读更危险，因为它会拿着半截理解去回答用户。
第三个最有意思：FAQ，这个被嫌弃了十年的老格式，反而重新赢了。一问一答、自包含、直接了当——机器最爱的三件事，FAQ 全占了。谁也没想到，最「土」的格式成了最潮的。
这说明什么？AI 消费内容的逻辑，和人类浏览的逻辑不一样。人类喜欢有叙事、有铺垫、有上下文；Agent 要的是原子化、自包含、结构清晰的知识单元。调研里团队的实际应对也印证了方向：30% 在为内容补充显式上下文，30% 在让页面自包含，26% 在投资结构化数据——全是往「机器可读」走。
那文档人要改什么？我这些年的经验就三件事。第一，一页解决一个问题：别再写「关于 X 的一切」，写成「X 的 20 个具体问题」，标题即问题，开头即答案——人搜得到，机器也拉得动。第二，结构化存储：内容底层用结构化的方式组织，分类、标签、关联关系，这些是机器能直接消化的养分——Baklib 的设计出发点就是这个：知识以结构化的形式存在底座里，发布成什么样子、接什么 AI 出口，都灵活。第三，别为 Agent 另建一份内容：单一真源，人类界面和机器接口只是同一份知识的两个发布面——维护两份内容的公司，最后一定死于版本打架。
还有一层想跟你分享：为 Agent 优化，对人也是有益的。自包含、结构清晰、直给答案——人类读者难道不喜欢吗？只是要小心一个平衡点：原子化到什么程度，碎得太细，人类就看不了了。这个平衡，就是 AI 时代文档人的新功力。
回到开头：Agent 是新用户，而且这个用户群的增长速度，比任何人类细分市场都快。
写得让人看得懂，也写得让机器读得动。一份知识，两类读者。
我是 Baklib 的产品运营，我们下期见。
