Vibe Coding 工业级实战方法论与闭环执行协议 (Vibe Coding Master Protocol)

由 Andrej Karpathy 提出的 Vibe Coding（氛围感编程） 标志着软件工程范式的深刻跃迁——开发者从底层的语法键入者（Typist），上移为定义系统边界、编排智能体循环与管理验证门控的“导演与架构师”（参见 moving-up-the-stack 与 Andrej-Karpathy）。

然而，非受约束的 Vibe Coding 极易导致代码漂移、死循环报错与上下文污染。工业界高可靠 Vibe Coding 的核心在于将自然语言开发固化为**“受约束的确定性四步闭环（The Master Protocol）”**。

---

一、 核心闭环架构：Prompt $\to$ Plan $\to$ Execute $\to$ Verify

Source: codex-agent · loop-engineering · Claude-Code

flowchart TD
    A[1. 规格先行 Spec-First: 明确正负向约束] --> B[2. 计划驱动 Plan: 步进拆解与方案审查]
    B --> C[3. 原子执行 Execute: 读写文件与Shell命令]
    C --> D[4. 确定性验证 Verify: 运行测试与退出码门控]
    D -- 报错 Exit Code != 0 --> E[原始日志回灌, 驱动自愈循环]
    E --> C
    D -- 绿灯 Exit Code == 0 --> F[物理存档 Git Commit & 会话重置]

---

二、 四大核心操作规约

1. 规格先行（Spec-First）

• 边界定义：在工程根目录维护轻量级的 SPEC.md 或在提示词头部明确界定三要素：
  1. 输入/输出接口与技术栈；
  2. 核心业务场景；
  3. 负向约束（Negative Constraints / Non-goals）：明确禁止引入的复杂依赖或多余设计。

2. 计划驱动（Plan before Code）

• 强制推演：在智能体修改文件前，要求其输出 3-5 步的有序执行计划（Plan），审查其架构假设是否偏离；
• 小步快跑：每次只让智能体执行一个原子任务，禁止单次下达超过 3 个复合功能的模糊指令。

3. 确定性门控验收（Deterministic Verification）

• 绝不依靠肉眼审读代码：验证的唯一真理是机器客观反馈——运行单元测试、Linter 校验或启动命令；
• 错误日志回灌自愈（Self-Healing）：捕获原始 stderr 堆栈追踪直接回灌给模型，由其自主定位并修正（呼应 loop-engineering 的 Maker-Checker 分离机制）。

4. 会话卫生与物理存档（Thread Hygiene & Snapshot）

• 即时物理存档：单个功能验证通过后，立刻执行 git commit。Git 历史是抵御智能体破坏性重构的最佳安全网；
• 上下文防污染：会话超过 10-15 轮且模型出现记忆退化时，果断开启全新的 Thread/Session，基于干净的代码库重新起步。

---

三、 工业级提示词模版 (Master Prompt)

我想在当前项目中实现 [功能描述]。
 
请遵循以下工作流：
1. 先阅读现有代码库结构与相关文件；
2. 输出一个简要的实施计划（Plan），列出需要新建/修改的文件与关键逻辑；
3. 等待我的确认后，再开始编写代码；
4. 编写完成后，请主动运行测试或启动命令进行自测验证（Exit Code 0 为准）。

Vibe Coding 陷阱与资深工程师的防护栏

Source: agentic-engineering

资深软件工程师指出，盲目依赖 Vibe Coding 会迅速导致架构熵增与调试地狱。初学者容易陷入“代码貌似能跑，但无人理解其内部状态与边界条件”的虚假繁荣。资深开发者的关键防护栏包括：坚守规格说明书先行、严格的自动化回归测试、拒绝黑盒不可维护代码以及保留主权思考。