第一次提交之前的最后一个周六

2027 年发布的引擎,会是那个在第一次提交之前就了解自己的团队、演示和 API 的引擎——而不是 2025 年那十几个仓促上马、边做边想的引擎中的一个。RakuAI 花了一个季度设计工作流,好让代码库能在此后多年反映它。

这是第一次提交进去之前的最后一个周六。下周末运行时仓库开放。SDK 仓库开放。文档仓库开放。智能体开始处理 issue 队列。真正的代码开始了。

这句话酝酿了一年。支撑这款产品的专利资产酝酿了十年。在工作从设计转向实现之前,我想写下的东西,是我从过去三个月的构建前工作中学到的东西,因为这里的教训会是代码库在接下来两年里所反映的东西。

三个月零代码期间完成了什么

一份清单,因为写下来会逼着自己诚实。

智能体名单已经敲定。 十个智能体在明确的角色中。Product、SDK、Studio、Marketing、Operations、AI and Data Strategy、Codex Dev 子智能体、Developer Relations、Strategic Partnerships,以及监督整体的 Agent Governance。每一个都有一份系统提示词、一套工具、一套与其他智能体的交互方式。名单被记录在一个智能体会在每个会话开始时读取的地方。

演示套件已经规定完毕。 八个规范性演示。每一个都有书面描述、一份必须展示的能力清单、一个复杂度估计,以及一个它将存放于其中的 SDK 文件夹位置。问”这是用来做什么的”的工作室,会得到一个映射到他们用例的可运行示例。

SDK 文件夹结构已经画出。 Apps。Modules。Assets。Docs。Config。每个顶层文件夹都有明确的用途。每个子文件夹都有清晰的约定。未来一年进来的代码会落在正确的位置,因为那个正确的位置已经存在。

模块 API 界面已经起草。 HUD 渲染器。手势输入。注视追踪。多人同步。叠加层动画器。语音控制。每个模块的公共界面都以伪代码勾勒出来。智能体将用真正的实现替换伪代码,针对的是一份稳定的契约。

硬件目标已经锁定。 AR1+ 智能眼镜规格已被定为引擎的主要目标。延迟预算。散热包络。传感器能力。这份规格是下游每一个架构决策的强制约束。

专利资产已经文档化并审计过。 支撑这款产品的十年前眼镜形态知识产权已经被重新阅读,续案已经与法律顾问一起审查过,关于哪些发明被主张的公开表述是一致的。知识产权是地基。代码库是建在其上的东西。

公开的工程日志已经排期。 这个博客将于下周六随第一篇常规节奏的文章一起上线。在这篇之前的四篇文章,是今年夏天设计工作的公开版本。从现在起,节奏是每周一次。

在真正做之前,我对智能体驱动工作流学到了什么

我自认为知道的大部分东西最终都会被证明是错的。这是诚实的第一个观察。在纸面上设计三个月的工作流,和在生产中运行一个工作流,是两码事。真正代码的第一个月会暴露出我没有预料到的东西。

话虽如此,有几个我愿意押注的直觉。

智能体会在无聊的部分表现得比在新颖的部分好。 遥测管道、构建配置、测试框架、文档清理。这些是智能体能干净利落地完成的任务,因为模式是明确定义的。新颖的架构决策(一个新的子系统边界、一个新的线程模型、一个新的 API 界面)是智能体会吃力的任务,因为模式不那么明确。正确的分工是把架构工作留给我自己,把实现工作委托给智能体。

框架搭建工作将会是真正的工作。 一个框定松散的 issue 会产出一个大致正确的 PR。一个框定精确的 issue 会产出一个精确正确的 PR。在接下来一年里复利效应最强的技能,是善于框定智能体要接手的 issue。我预计我大部分的周六早晨,都会花在这个框架搭建上。

审查将会是瓶颈。 五个智能体并行产出 PR,大约一个周六就能让任何一个单独的人类审查者饱和。防御手段是更小的队列深度、智能体对智能体的初审评论,以及一条拒绝合并我没有真正读过的东西的纪律。我已经把这条纪律写下来了。我们会看看它能否在一个百 PR 的周六面前存活下来。

智能体会写出能通过测试的桩代码。 我最担心的失败模式是:一个智能体的实现返回一个占位值,测试恰好针对这个占位值通过了,而代码库就此长出一个关于自己做了什么的谎言。我已经为此写好了审计模式,并承诺按节奏运行它。这个节奏能否顶住跳过审计的诱惑,是一个悬而未决的问题。

为什么专利对接下来的事情很重要

我想具体写下关于专利资产的一件事,因为这是这个项目中最常被误解的部分。

这些专利不是针对某个已知竞争对手的防御性护城河。空间 AR 眼镜这个品类目前还没有在位者。这些专利也不是一种诉讼策略。我们不做打官司的生意。

这些专利是许可。我和我的合作者们十多年前提交的眼镜形态工作,涵盖了让现代 AR 眼镜成为可能的架构模式。这些模式如今是任何在这个品类中构建产品的人的入场标配。率先提交意味着我们拥有后来者所没有的行动自由,以及后来者无法制造出来的与合作伙伴之间的可信度。

下周六开放的代码库,就建立在这份许可之上。下游的每一个架构决策,都可以假定基础知识产权的问题已经解决。这是一种比护城河更安静的优势。也是一种更持久的优势。

我要带进下周六的东西

一份简短的清单。就是那种在严肃的事情开始前一天会设定的意图。

• 用一份干净的 README 和一份干净的规格说明链接来开放运行时仓库。第一次提交应该是我希望未来考古学能找到的那一次。
• 在智能体队列上提交前十个 issue。每一个都界定清晰。每一个都打上标签。每一个都带有智能体可以自我检验的验收标准。
• 用一篇能表明节奏的文章开始公开的工程日志:诚实、具体、不煽情。
• 不要亲手写任何智能体能写的代码。智能体就是团队。用它们。
• 不让智能体在没有我先框定的情况下触碰任何架构性的东西。架构决策是我的。
• 在合理的时间合上笔记本电脑。这是一场马拉松,不是一次冲刺。

给以后阅读这份公开日志的人的一句话

博客将在下周末上线。在这篇之前的文章是设计文档的回顾。从下周末开始的文章是实时的工程日志。节奏是每周一次。声音是诚实的。工作流所依赖的纪律,就是代码库将要反映的纪律。

如果你是某个 AI 实验室的人,未来读到这篇文章,你正在看的这个引擎,是在任何代码写出来之前,由一个清楚自己想要什么样的工作流、并把代码库构建成贴合这个工作流的人设计出来的。这就是这个引擎与 2025 年那十几个其他引擎之间的区别。

如果你是一个在考虑自家设备应该搭载哪个引擎的硬件合作伙伴,这个引擎所针对的 AR1+ 规格是真实的,这个引擎随附的演示套件是已经规定好的,SDK 提供的开发者故事是已经规划好的。其他引擎必须事后补齐这一切。这一个不需要。

如果你是一个考虑将来在此基础上构建的开发者,SDK 正在以你为念被设计出来。八个映射到八类产品的演示。一个不会在你脚下发生变化的文件夹结构。一个在实现开始之前就已锁定的 API 界面。

如果你是正在读这篇文章的竞争对手,设计阶段已经结束。构建阶段从下周末开始。我宁愿让你知道这一点,也不愿让你感到意外。

再过一个周六,就是第一次提交。今天,是纯设计工作的最后一个周六。下次我写这个博客的时候,代码已经开始了。