系列: 與 AI 一起學寫程式

第一個提交之前的最後一個週六

第一個提交之前的各個設計里程碑。

純設計的最後一個週六 三個月的紙上作業,匯聚到第一號提交 名單10 個代理人 展示8 個規格完成 資料夾結構畫好 API介面草擬完畢 專利十年之久的 IP 提交 #1 先設計工作流程。程式碼庫會反映它許多年。 AR1+ 規格鎖定——延遲預算、散熱包絡、感測器能力
三個月不寫程式碼,匯聚到那個未來的考古學應該挖出的唯一提交。

2027 年出貨的引擎,會是那個在第一號提交之前就了解自己的團隊、自己的展示、自己的 API 的引擎——而不是 2025 年匆匆起步、邊走邊即興的那十幾個。RakuAI 花了一整季設計工作流程,好讓程式碼庫能長年反映它。

這是第一個提交進版前的最後一個週六。下個週末,執行環境儲存庫開張。SDK 儲存庫開張。文件儲存庫開張。代理人開始消化議題佇列。真正的程式碼開始了。

這句話醞釀了一年。這個產品底下的專利資產醞釀了十年。在工作從設計轉向實作之前,我想寫下過去三個月前置設計工作教會我的事,因為這些教訓正是程式碼庫接下來兩年會反映出來的東西。

三個月不寫程式碼,完成了什麼

列一份清單,因為寫下來才誠實。

代理人名單底定。 十個代理人,角色明確。產品、SDK、工作室、行銷、營運、AI 與資料策略、Codex 開發子代理人、開發者關係、策略合作夥伴,再加上覆蓋全局的代理人治理。每一個都有系統提示詞、一組工具,以及與其他代理人的互動方式。名單記錄在代理人每次工作階段開始時都會讀到的地方。

展示套件規格完成。 八個正典展示。每一個都有書面描述、必須展現的能力清單、預估複雜度,以及在 SDK 資料夾中的落腳處。問「這是用來做什麼的」的工作室,會得到一個對應其用例的可運作範例。

SDK 資料夾結構畫好。 Apps。Modules。Assets。Docs。Config。每個頂層資料夾都有明確用途。每個子資料夾都有清楚的慣例。未來一年進來的程式碼會落在正確的位置,因為正確的位置已經存在。

模組 API 介面草擬完畢。 HUD 渲染器。手勢輸入。視線追蹤。多人同步。疊加層動畫器。語音控制。每個模組的公開介面都以偽程式碼勾勒完成。代理人會依循穩定的契約,把偽程式碼換成真正的實作。

硬體目標鎖定。 AR1+ 智慧眼鏡規格定案,成為引擎的主要目標。延遲預算。散熱包絡。感測器能力。這份規格是下游每個架構決策的約束力量。

專利資產已文件化並完成稽核。 支撐這個產品、十年之久的眼鏡形態 IP 已重新細讀,延續案已與法律顧問一同審視,對外聲明哪些發明被主張的說法也已一致。IP 是地基。程式碼庫是蓋在上面的東西。

公開工程日誌已排定。 這個部落格下週六上線,發出第一篇固定節奏的文章。本文之前的四篇,是今年夏天設計工作的公開版本。從此以後,節奏是每週一篇。

在實際動手之前,我對代理人驅動工作流程學到了什麼

我自以為知道的大部分事情,最後都會被證明是錯的。這是誠實的第一個觀察。花三個月在紙上設計工作流程,和在生產環境跑一套工作流程不是同一回事。真正寫程式的第一個月會暴露我沒預料到的事。

儘管如此,還是有幾個我願意押注的直覺。

代理人擅長無聊的部分,勝過新穎的部分。 遙測管線、建置設定、測試工具、文件掃查。這些是代理人能乾淨落地的任務,因為模式定義得很清楚。新穎的架構判斷(新的子系統邊界、新的執行緒模型、新的 API 介面)是代理人會吃力的任務,因為模式比較模糊。正確的分工是架構工作留給我,實作工作交給代理人。

定框架的工作才是真正的工作。 框得鬆散的議題產出鬆散正確的 PR。框得精確的議題產出精確正確的 PR。未來一年複利效應最大的技能,就是把代理人要接手的議題框好。我預期我大多數的週六早晨都會花在這件事上。

審查會是瓶頸。 五個代理人平行產出 PR,大約一個週六就能讓任何單一人類審查者飽和。防線是更小的佇列深度、代理人互審做第一輪意見,以及「沒真正讀過就不合併」的紀律。這條紀律我已經寫下來了。且看它撞上一個一百個 PR 的週六之後還剩多少。

代理人會寫出能通過測試的樁。 我最擔心的失敗模式是:代理人的實作回傳一個佔位值,測試恰好對著佔位值通過,於是程式碼庫長出一個關於自己能做什麼的謊言。我已經為此寫好稽核模式,並承諾按節奏執行。這個節奏能不能扛住「跳過稽核」的誘惑,是懸而未決的問題。

為什麼專利對接下來的事很重要

關於專利資產我想具體寫幾句,因為這是這個專案最常被誤解的部分。

這些專利不是針對某個已知競爭者的防禦性護城河。空間 AR 眼鏡這個類別還沒有在位者。這些專利不是訴訟策略。我們不做興訟的生意。

這些專利是許可。我和合作者十多年前申請的眼鏡形態研究成果,涵蓋了讓現代 AR 眼鏡成為可能的架構模式。這些模式如今是任何在這個類別裡打造產品的人的基本門檻。先申請意味著我們擁有後來者沒有的營運自由,以及後來者無法憑空製造的合作夥伴信任。

下週六開張的程式碼庫就建立在這份許可之上。下游每個架構決策都可以假設基礎 IP 問題已經底定。這是一種比護城河安靜的優勢。也是一種更持久的優勢。

我要帶進下週六的東西

一份短清單。就是在正經事開始前一天會立下的那種心願。

  • 用乾淨的 README 和乾淨的規格連結開張執行環境儲存庫。第一個提交應該是我希望未來的考古學挖出來的那一個。
  • 在代理人佇列上開出前十個議題。每一個範圍鋒利。每一個都打上標籤。每一個都附上代理人可以自我檢核的驗收標準。
  • 用能定調節奏的那種文章開啟公開工程日誌:誠實、具體、不濫情。
  • 凡是代理人能寫的程式碼,不親手寫。代理人就是團隊。用他們。
  • 沒有我先定框架,不讓代理人碰任何架構性的東西。架構判斷是我的。
  • 在合理的時間闔上筆電。這是馬拉松,不是單次衝刺。

給日後閱讀這份公開日誌的人的一段話

部落格下週末上線。本文之前的文章是設計文件的回顧。下週末起的文章是即時的工程日誌。節奏是每週一篇。語氣是誠實的。工作流程賴以運行的紀律,就是程式碼庫將會反映的紀律。

如果你在某個 AI 實驗室、在未來讀到這篇文章:你眼前的這個引擎,是在寫下任何程式碼之前就設計好的,出自一個清楚知道自己想要什麼工作流程、並讓程式碼庫貼合該工作流程的人之手。這就是這個引擎和 2025 年起步的其他十幾個引擎的差別。

如果你是正在考慮自家裝置該搭載哪個引擎的硬體夥伴:這個引擎瞄準的 AR1+ 規格是真的,引擎隨附的展示套件規格已完成,SDK 提供的開發者方案已經畫好。其他引擎得事後補做這些。這一個不用。

如果你是將來考慮在這上面開發的開發者:這套 SDK 在設計時就把你放在心上。八個展示對應八種產品類別。一個不會在你腳下改變的資料夾結構。一個在實作開始之前就鎖定的 API 介面。

如果你是讀到這裡的競爭者:設計階段結束了。建造階段下週末開始。我寧願你知道,也不想讓你被嚇一跳。

一個週六之後,第一個提交。今天,是純設計工作的最後一個週六。下次我再寫這個部落格時,程式碼已經開始了。

你的模型注定要指揮的引擎

在寫下一行程式碼之前、於十年之久的專利基石上打造——RakuAI 是 LLM 廠商與硬體夥伴可以放心建立於其上的空間運算執行環境。

← 所有文章