AI一天写500页文档,技术写作还有明天吗?

如果你关注技术写作领域，一定对 Tom Johnson 和他的博客 I'd Rather Be Writing 不陌生。

最近，沉寂了一段时间的 Tom 终于更新了。他没有聊行业八卦，也没有发什么"AI 工具推荐清单"，而是坦诚地分享了自己正在做的事情——以及他对自己坚持多年的理念的一次"推翻重来"。

这篇文章值得每一个技术写作者认真读一读。因为它触及了一个我们都在回避、却又不得不面对的问题：

AI 时代，文档人的价值到底在哪里？

一、从"产品技能"到"文档优先"：一次被数据打脸的转向

几个月前，技术写作圈子里流行一个新概念：Product Skills（产品技能）。

简单说，就是给 AI 代理（Agent）专门编写一套"技能包"，让它更懂你的产品——知道怎么搜索你的文档、用什么术语、按什么流程操作。

当时，几乎所有人都觉得这是技术写作者的新战场：终于，我们的专业知识可以直接"编程"进 AI 了！

Tom 也是这么想的。他甚至为此专门开了一门课——Agent Skills Course，还花大力气写了一整个章节讲产品技能。

然后，他看到了日志数据。

数据说了什么？

• • 产品技能实际被 AI 触发的频率极低
• • 即便触发了，也很少真正帮到用户
• • 大量产品技能的内容，本质上只是重复文档里已有的信息，甚至重复模型已经训练过的内容

Tom 的原话很直白：

"我改变了对产品技能价值的看法……现在我是'文档优先'的人了。因为我想不出有什么内容应该放进产品技能里、却不该已经在文档中。"

这不是否定产品技能的存在意义，而是一个清醒的判断：

与其花大量时间给 AI 写"技能包"，不如把同样的精力投入文档本身。

因为——文档才是那个被反复检索、被真正消费的东西。

二、AI 写作：从"作者"到"导演/编辑"

如果说观点转向是认知层面的变化，那么 Tom 在写作方式上的转变，可能更让文档人感同身受。

他在写课程第一章时，还是老习惯——自己先写草稿，再让 AI 辅助。

但写到后面几章，画风变了：

"我越来越多地扮演导演/编辑的角色，告诉 AI 写什么。"

这不是偷懒。Tom 给出了两个非常务实的理由：

理由一：这是教学/信息类内容，不是文学作品

课程材料、文档、知识库——这些内容的核心价值是信息准确、结构清晰、持续可用，而不是文采飞扬。

AI 完全胜任这类内容的初稿撰写。

理由二：内容保质期太短了

Tom 算了一笔账：

"试着定期更新几百页的材料——还是在下班后、周末抽空做——这是一场必输的战斗。"

如果你也维护过大型文档项目，这段话一定让你心头一紧。

AI 不是来抢你饭碗的，是来帮你打这场"必输的战斗"的。

三、AI 的真正价值：不是替你写，而是逼你想

这是整篇文章最打动我的部分。

Tom 说，纯知识倾倒式的写作很无聊——因为你只是在复述已知的东西。但有了 AI 之后，一切都变了：

"AI 能把推向我未曾考虑过的方向，帮我思考新的或不同的想法。"

他坦诚地承认：AI 经常是错的，很容易被带偏。

但重点不是 AI 对不对，而是——

AI 是一面镜子，也是一个"思维碰撞器"。它逼着你思考那些你以为自己已经想清楚的问题。

Tom 的原话：

"我一直把写作当作学习的手段……如果我能用 AI 边写边学——"

这句话没写完，但意思已经完整了。

AI 时代，文档人的核心竞争力不是"写得多快"，而是"想得多深"。

四、文档人的新定位：从"内容生产者"到"信息架构师 + AI 训练师"

把 Tom 的经历和思考串起来，一个清晰的路径浮现出来：

🔄 旧范式 → 新范式

具体可以做什么？

1. 深耕"文档优先"策略

• • 确保文档结构清晰、机器可读
• • 为 AI 代理优化内容（schema、metadata、结构化标记）
• • 让文档成为 AI 的"第一信息源"

2. 学会用 AI 加速内容迭代

• • 让 AI 写初稿，你做编辑和把关
• • 用 AI 挖掘用户日志中的"信息缺口"
• • 用 AI 辅助多语言翻译、格式转换、内容重组

3. 从日志中发现机会

• • 分析用户和 AI 的聊天记录，找到文档盲区
• • 把高频问题转化为文档条目
• • 用数据驱动文档优先级

4. 把自己定位为"领域知识守门人"

• • AI 不懂你的业务，你懂
• • AI 写不出你没有的经验，你有
• • 你的判断力、审美、领域深度，才是不可替代的

五、写在最后：不是终局，是开始

Tom 在文章最后说，他的课程章节更像一份蓝图——不断演变、不断修正、不断被新数据推翻重来。

他在每页顶部都放了一个黄色大提示，告诉读者：这东西还在变，别当终极真理。

这本身就是一种值得学习的态度。

AI 时代，文档人不需要恐慌，也不需要盲目拥抱。我们需要的是：

• • 像 Tom 一样，敢于被数据打脸、敢于推翻自己
• • 像 Tom 一样，把 AI 当学习工具而不是威胁
• • 像 Tom 一样，在变化中找到自己的新位置

文档不会消失。消失的，只是旧的写法。

参考原文：Tom Johnson, "Building out my agent skills course and rethinking product skills", I'd Rather Be Writing（https://idratherbewriting.com/blog/building-out-agent-skills-course）, 2026-10-08

作者注：本文基于 Tom Johnson 的博文进行解读与延伸，部分内容为作者观点补充。欢迎在评论区聊聊你的看法。

📌 你觉得 AI 时代技术写作最大的变化是什么？欢迎留言讨论。