Vibe Coding 是個陷阱。您需要 「法典」。

TL;DR:「Vibe Coding」(隨意引導 AI 建置軟體的做法)已經成為趨勢。但是,如果沒有結構化,它將不可避免地導致 「上下文漂移」(context drift)和義大利語代碼(spaghetti code)。要使用 AI 建立企業級軟體,您需要一個嚴謹的 Context Architecture。在 Mercury,我們稱之為 "The Codex Protocol",這不是將您的文件視為建議,而是將其視為 AI 在編寫任何一行程式碼之前必須參考的永恆不變的法則。

James here,Mercury Technology Solutions 的執行長。

網際網路正熱烈討論「Vibe Coding」。這個承諾非常誘人:您對人工智慧隨意說話("Vibes"),它就會建立一個應用程式。

我檢視過開發圈子中流行的工作流程。它們對於原型來說非常出色,但對於嚴肅的工程來說卻有致命的缺點:它們假設 AI 記得「大圖畫」。但事实并非如此。

LLM 會受到熵的影響。當對話變得冗長時,AI 就會忘記您們在 40 個訊息前所同意的資料庫模式。它開始創造新的模式。Vibe" 變成了混亂。

在 Mercury,我們將此改進為嚴謹的工作流程。我們不稱之為 Vibe Coding。我們稱之為 情境工程。

以下是使用我們稱為 The Codex 的「單一真相來源」(Single Source of Truth)來建置人工智慧軟體的「Mercury 協定」。

核心理念:「法典」

秘訣不在於型號 (Claude 對 GPT-5)。秘訣在於 外部化記憶體。

您必須將專案資料夾視為 AI 的「大腦」,而不僅僅是放置程式碼的地方。我們執行嚴格的資料夾結構,稱為 /codex

為什麼是 "Codex"?因為這意味著權威性。這些不是筆記;它們是 法則。在 AI 寫下任何一行程式碼之前,它必須先參考 The Codex。

結構

在您的根目錄中建立一個名為 /codex 的資料夾。它包含五個不可變的檔案:

  1. product-vision.md(為什麼):高階目標。(例如,「使用 ThreeJS 的 3D 多人狗鬥遊戲」)。
  2. tech-stack.md (The How): 具體工具。(例如,「WebSockets 用於網路,Rapier 用於物理。不使用 React,僅使用 vanilla JS")。
  3. architecture.md(地圖):檔案結構和資料庫模式。這是最關鍵的檔案。
  4. implementation-plan.md(路徑):分步進行的任務清單。每個步驟必須有驗證測試。
  5. progress.md(日誌):哪些已經完成,哪些尚未完成。

工作流程:架構 -->  執行 -->  驗證

不要只是開啟聊天並開始編碼。遵循這個循環。

第 1 階段:建築師(模型:Claude Opus 4.5)

我們使用最聰明、最慢的模式來撰寫法律。

行動:您扮演產品經理。您將自己的腦袋放進聊天內容中。

提示:"扮演系統建築師。根據我的想法建立 product-vision.md 和 tech-stack.md 的項目。然後,提出 architecture.md。先不要寫程式碼。這些檔案將會放入 The Codex。"

結果:您鎖定了設計。您明確禁止 AI 稍後做出架構上的決定。

第二階段:抄寫員(模型:Claude Sonnet 4.5 / Codex)

我們使用快速的「代理人」模式來執行法律。

金科玉律:每個新的聊天會話都必須以 AI 諮詢 Codex 開始。

提示:"請諮詢 /codex/@architecture.md 和 /codex/@implementation-plan.md。我們目前正處於步驟 3。請嚴格遵照《法典》中定義的架構執行步驟 3。請勿進入步驟 4。

透過強制 AI 每次都閱讀 /codex,您可以消除「上下文漂移」。無論您是在提示 1 號或提示 100 號,AI 都會以相同的真理為基礎。

第 3 階段:驗證者(模型:人類 + BrowserTools)

這是你的工作。

流行的指南建議使用自動化,但我堅持使用人工驗證。

動作:AI 說「步驟 3 已完成」。

你執行程式碼。檢查記錄。3D 平面是否真的會飛?

關鍵步驟:如果成功,您可以命令 AI:"更新 /codex/@progress.md,標記步驟 3 完成。如果您新增檔案,請更新 /codex/@architecture.md。"

然後才提交到 Git。Git 是您的儲存點。如果 AI 在步驟 4 中產生幻覺,您可以 git reset --hard 再試一次。

反重力」優勢:模型套利

原始指南建議選擇一種工具。我不同意。

使用模型套利:

  1. Planning (The Architect): 使用 Opus 4.5。它能深入思考邊緣情況,並撰寫出強大的 Codex。
  2. 編碼 (The Scribe):使用 Sonnet 4.5。它遵循指示,而且比較便宜。
  3. Refactoring (The Librarian): 使用 Gemini 3 Pro。它有一個巨大的上下文視窗,如果事情變得混亂,可以一次讀取整個程式碼庫。

結論:從「氣氛」到「願景

"Vibe Coding "暗示您可以在 AI 工作時放鬆一下。這是錯誤的。

此工作流程將您的工作從「打字」轉移到「管理」。

  • 您不再是磚匠。
  • 您是法典的守護者

您的工作是確保 Codex 保持乾淨。如果 architecture.md 變得混亂,程式碼也會變得混亂。如果 implementation-plan.md 含糊不清,AI 就會卡住。

掌握 Codex,您就可以單獨建立企業級的軟體。忽略它,您只會擁有一個滿是破爛腳本的資料夾。

Mercury Technology Solution:加速數位化。

Vibe Coding 是個陷阱。您需要 「法典」。
James Huang 2025年12月26日
分享這個貼文
100 兆個代幣不會說謊:一半的人在編碼,另一半的人在玩角色扮演遊戲