简而言之:"Vibe Coding"——随意引导 AI 构建软件的做法正在流行。但没有结构,它不可避免地导致 "上下文漂移" 和意大利面代码。要用 AI 构建企业级软件,你需要一个严格的上下文架构。在水星公司,我们称之为"The Codex Protocol."这将你的文档视为不可改变的法则,AI 必须在编写任何代码之前咨询它。
我是水星科技解决方案的首席执行官 James。
互联网正在热议 "Vibe Coding." 这个承诺很诱人:你随意("vibes")与 AI 交谈,它就构建一个应用程序。
我已经审查了在开发圈中流传的流行工作流程。它们对于原型来说非常出色,但对于严肃的工程来说有一个致命缺陷:它们假设 AI 记得 "大局"。但实际上并不是。
大型语言模型(LLMs)会受到熵的影响。随着对话的延续,AI 会忘记你在 40 条消息之前达成的数据库架构。它开始发明新的模式。"Vibe" 变成了混乱。
在水星公司,我们将其精炼为一个严格的工作流程。我们不称之为 Vibe Coding。我们称之为上下文工程。
这是我们使用我们称之为The Codex 的单一真实来源与 AI 一起构建软件的 "水星协议"。核心理念:"The Codex"
秘密不在于模型(Claude 与 GPT-5)。秘密在于
外部化记忆。你必须将你的项目文件夹视为不仅仅是代码的地方,而是 AI 的 "大脑"。我们强制执行一个严格的文件夹结构,称为
/codex。为什么叫 "Codex"?因为它暗示了权威。这些不是笔记;它们是法律。
在 AI 写下任何代码之前,它必须咨询 The Codex。结构在你的根目录中创建一个名为 /codex 的文件夹。它包含五个不可改变的文件:
product-vision.md(目标):
高层目标。(例如,"使用 ThreeJS 的 3D 多人空战游戏")。
- tech-stack.md(方法): 具体工具。(例如,"用于网络的 WebSockets,物理的 Rapier。没有 React,仅使用原生 JS")。
- architecture.md(地图): 文件结构和数据库架构。
- 这是最关键的文件。implementation-plan.md(路径): 一步一步的任务列表。每一步
- 必须有一个验证测试。progress.md(日志): 已完成的内容,待处理的内容。
- 工作流程:架构 --> 执行 --> 验证不要仅仅打开聊天并开始编码。遵循这个循环。
阶段 1:架构师(模型:Claude Opus 4.5)
我们使用最聪明、最慢的模型来编写法律。
行动:你充当产品经理。你将你的想法倾倒到聊天中。
We use the smartest, slowest model to write the law.
Action: You act as the Product Manager. You dump your brain into the chat.
提示:"充当系统架构师。根据我的想法创建 product-vision.md 和 tech-stack.md 的条目。然后,提出 architecture.md。暂时不要写代码。这些文件将放入 The Codex。"
结果:你锁定设计。你明确禁止 AI 以后做出架构决策。
阶段 2:抄写者(模型:Claude Sonnet 4.5 / Codex)
我们使用快速的“代理”模型来执行法律。
黄金法则:每个新的聊天会话必须以 AI 咨询 The Codex 开始。
提示:"咨询 /codex/@architecture.md 和 /codex/@implementation-plan.md。我们目前处于第 3 步。严格按照 The Codex 中定义的架构实施第 3 步。不要继续到第 4 步。"
通过强迫 AI 每次都阅读 /codex,你消除了 "上下文漂移"。无论你是在提示 #1 还是提示 #100,AI 都是基于同样的真相。
阶段 3:验证者(模型:人类 + 浏览器工具)
这是你的工作。
流行指南建议使用自动化,但我坚持人类验证。
行动:AI 说 "第 3 步完成。"
你:运行代码。检查日志。3D 平面真的能飞吗?
关键步骤:如果有效,你命令 AI:"更新 /codex/@progress.md 以标记第 3 步完成。如果你添加了新文件,请更新 /codex/@architecture.md。"
只有这样你才能提交到 Git。Git 是你的保存点。如果 AI 在第 4 步中出现幻觉,你 git reset --hard 再试一次。
“反重力”优势:模型套利
原始指南建议选择一个工具。我不同意。
使用模型套利:
- 规划(架构师):使用Opus 4.5。它深入思考边缘案例并编写稳健的 Codex。编码(抄写者):
- 使用Sonnet 4.5。它遵循指令且成本更低。重构(图书管理员):使用
- Gemini 3 Pro。它拥有巨大的上下文窗口,可以一次读取整个代码库,如果事情变得混乱。结论:从 "氛围" 到 "愿景""氛围编码" 意味着你可以在 AI 工作时放松。这是错误的。这个工作流程将你的努力从输入转移到管理。
你不再是砖瓦工。
你是
Codex 的守护者。
- 你的工作是确保
- Codex保持整洁。如果 architecture.md 变得混乱,代码就会变得混乱。如果 implementation-plan.md 模糊,AI 将会卡住。掌握 Codex,你就可以独自构建企业级软件。忽视它,你只会拥有一个满是破损脚本的文件夹。
水星科技解决方案:加速数字化。Codex stays clean. If the architecture.md gets messy, the code gets messy. If the implementation-plan.md is vague, the AI will get stuck.
Master the Codex, and you can build enterprise-grade software alone. Ignore it, and you’ll just have a folder full of broken scripts.
Mercury Technology Solutions: Accelerate Digitality.

