Working on a new little project. The 𝚁𝙴𝙰𝙳𝙼𝙴 is fully written by hand, because it’s for human consumption. The documentation internals are AI English, because they’re for agents. This little rule of thumb can make the…

Vercel CEO Guillermo Rauch 透露,他的新项目把文档拆成两套:写给人的 README 坚持手写,给 AI 代理读的内部文档则用"AI 英语"生成。他提出的判断是,面向人的表达仍是内容质量的关键分界线。

一句话看懂:Vercel CEO Guillermo Rauch 透露,他的新项目把文档拆成两套:写给人的 README 坚持手写,给 AI 代理读的内部文档则用”AI 英语”生成。他提出的判断是,面向人的表达仍是内容质量的关键分界线。

事件核心:发生了什么

Guillermo Rauch 在 X 上发帖称,自己正在做一个新项目,并给出了一条简单的写作规则:README 完全手写,因为它的读者是人;而文档的内部部分交给 AI 生成的”AI 英语”,因为这些内容主要服务于软件代理(agents)。这条帖子的发布时间为 2026 年 10 月 4 日,获得约 6.38 万次浏览和上千次点赞。

他强调的重点不在”破折号”这类文风细节,而在于:博客、推文、README 属于人类沟通场景,是需要用文字与其他人建立连接的叙事时刻。目前公开信息显示,他并未披露该项目的名称、具体产品形态或上线时间。

为什么重要

这条表态触及一个正在被验证的行业趋势:当代码仓库、API 文档、工具说明越来越多被 AI 代理直接消费时,”文档”的读者结构正在分裂。过去文档默认读者是人,如今相当一部分读取请求来自编码代理、自动化流水线和智能体工具调用。

把两种内容明确分层,意味着团队可以在内部文档上优先追求机器可解析性、结构化和低成本生成,而把人的注意力集中在少数关键入口上。这对依赖 SDK、API 和开源仓库获客的开发者工具公司而言,是一种可复制的工程与内容策略。

对用户/开发者/创作者的影响

对开发者,README 与内部文档的分工,可能逐步影响代码托管平台、Agent 工具链以及文档站点的默认模板设计。若”面向代理的文档”成为标配,开源项目的维护者需要在机器可读的格式、权限和版本一致性上投入更多精力。

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

对创作者和内容团队,这条规则提供的是一个判断标准而非工具推荐:面向公众的内容值得保留人工写作和叙事打磨,而流程性、检索性的内容可以交给大模型批量生成。真正被重新分配的是时间,而不是内容总量。

值得关注的后续

一是该项目何时公开以及是否会把”手写 README + AI 内部文档”的做法沉淀为可复用的工具或规范。二是主流代码托管平台和文档工具是否会推出面向 AI 代理的专门输出格式。三是当代理消费的内容规模持续扩大,社区是否会形成关于人类可读版本的共识标准,避免开发者被两套内容长期维护的成本拖累。

来源:Follow Builders · X · Guillermo Rauch

celebrityanime
celebrityanime
文章: 27358

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注