先把两种文档分开看：一种会变便宜，一种会变成底盘

文档在这轮 AI 变化里经常被看作最危险的一层。原因同样不复杂：总结说明、整理 FAQ、改写帮助中心、压缩手册、生成 onboarding 文本，这些都是大模型的强项。只要团队过去本来就把文档当成一个收尾动作，或者当成“功能上线后补一份说明”，那这部分工作确实很容易被快速商品化。

但这并不等于文档会整体失去价值。真正发生的，更像是文档被重新分层了。那些弱结构、弱维护、弱责任链的说明性文档会越来越便宜；而那些真正决定系统能不能被正确理解、正确调用、正确接管的文档，反而会因为 Agent 普及而更重要。

为什么 Agent 时代反而更依赖好文档

OpenAI 在 agent 指南里明确强调工具的可发现性和可复用性，Anthropic 在写工具的文章里则反复提醒，工具描述不能只为人写，也要为 agent 写。Claude Agent SDK 的实践文章甚至直接把文件夹结构、README、脚本入口和环境约束都放进上下文工程里。MCP 这类协议则更进一步，把工具、资源和提示词的边界协议化。

这些信号拼起来，其实在说一件事：未来很多文档已经不只是“给人看”，而是“给人和 Agent 一起消费”。只要一个系统希望让 AI 正确调用工具、理解目录、遵守流程、找到合适的知识源，它就必须把这些信息写得更结构化、更稳定、更可引用。

哪类文档会先变得便宜

先被吞掉的，往往是下面这类文档。

  • 为了交付而交付的功能说明，主要作用是上线后“补一页材料”。
  • 大量重复、更新缓慢、没人维护的内部 wiki。
  • 只堆背景、不写边界、不写输入输出样例的空泛手册。
  • 一旦系统变了就立刻过时，却没人负责维护的“静态说明”。

这类文档本来就缺乏真正的产品价值，AI 只是在更快地暴露它们的低含金量。

更会上移的，是把文档做成上下文的人

更值钱的新文档，会越来越像运行时上下文，而不是传统说明书。它们的共同特点很清楚。

  • 写清楚工具怎么用、输入输出长什么样、失败会怎么返回。
  • 写清楚流程的边界条件、人工接管点和不可自动化的步骤。
  • 写清楚目录职责、脚本入口、环境要求和变更影响。
  • 写清楚术语、规则、版本差异和真正不能误解的约束。

这种文档的价值，不在于字数多，而在于它能直接减少误调工具、误读规则、误解系统边界的概率。写这类文档的人，已经不只是 technical writer，更像“上下文工程师”。

结尾：文档不会退场，只会更像系统上下文层

我的倾向判断是：文档不会被 AI 吞掉，但文档工作会被强行重排。低价值、低维护、低结构的说明性文档会更快商品化；高价值、强结构、可执行、可验证的文档会明显上移，甚至变成系统基础设施的一部分。

所以真正值得担心的，不是“AI 会不会帮你写文档”，而是团队会不会继续把文档当成上线后的附属品。只要 Agent 越来越多地直接消费上下文，文档就越不再是可有可无的材料，而会变成系统能不能稳定运行的一层底盘。

更新附注

  • 版本：v1.1

更新日期：2026-04-01 更新原因：重写标题、首屏判断与结尾收束，把文章焦点进一步收拢到“文档作为运行时上下文”。