一句话看懂: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 工具链以及文档站点的默认模板设计。若”面向代理的文档”成为标配,开源项目的维护者需要在机器可读的格式、权限和版本一致性上投入更多精力。
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
对创作者和内容团队,这条规则提供的是一个判断标准而非工具推荐:面向公众的内容值得保留人工写作和叙事打磨,而流程性、检索性的内容可以交给大模型批量生成。真正被重新分配的是时间,而不是内容总量。
值得关注的后续
一是该项目何时公开以及是否会把”手写 README + AI 内部文档”的做法沉淀为可复用的工具或规范。二是主流代码托管平台和文档工具是否会推出面向 AI 代理的专门输出格式。三是当代理消费的内容规模持续扩大,社区是否会形成关于人类可读版本的共识标准,避免开发者被两套内容长期维护的成本拖累。


