给概率系统加上确定性:我理解的开发规范与 VibeCoding

“优秀的 SOP 本质是给概率系统加上确定性的状态机。“

核心观点 / 起源

最近在小红书上看到一个叫 vibe-coding-standard-workflow 的 Skill,让我对 AI 辅助编程有了全新的认识。它不是教你怎么写代码,而是教你怎么”克制” AI 写代码。这个看似反直觉的思路,恰恰击中了当下 AI 编程最核心的痛点。

用 Claude Code 或 Cursor 这类 AI 工具写代码时,你有没有遇到过这种情况:一开始聊得很顺,AI 理解你的需求,快速生成代码。但聊着聊着,它开始”飘”了——要么忘记了之前定好的架构,要么突然改变实现方式,要么在你没要求的地方自作主张加了一堆”优化”。最后你发现,代码是写了一大堆,但整个项目像是拼凑出来的,没有一致的逻辑。

这就是 上下文漂移(Context Drift) 和 行动过早(Premature Coding) 两大痛点。

大语言模型的本质是概率生成器。它天生倾向于”顺畅地把话接下去”,而不是”先停下来规划”。如果没有规范的约束,AI 就像一个没有图纸但手速极快的泥瓦匠——砌出来的墙表面平整,但地基是歪的。

VibeCoding 的本质

那个启发我的工作流,把原本”边聊边写、越写越乱”的黑盒过程,强制变成了”文档驱动、状态持久化、单步执行”的工程化白盒。它的核心可以总结为三个机制:

记忆外包机制 — AI 的上下文窗口是有限的,而且会随着对话稀释。通过建立 memory-bank/ 目录,将核心信息固化为物理文件。在项目根目录的 CLAUDE.md 中写入系统提示词,强制要求 AI 在写任何代码前必须读取架构文档和设计文档。这相当于给 AI 外挂了一个长期记忆硬盘。

渐进式澄清机制 — 严禁 AI 拿到一个模糊的需求就开始写代码。将需求转化为代码的过程切分成必须跨越的门槛:PRD → 设计文档 → 技术栈 → 实施计划。每一步都是对下一步的约束。

单步验证执行环 — 采用严格的”单步锁”机制:一次只做一步,完成即停止;把开发者作为验证的网关;步骤验证通过后,必须同步更新进度文档和架构文档。

过程 / 推演

这套机制看起来很完美,但当我尝试应用到实际项目时,发现了一些问题。

瀑布流的沉重

它强制要求先写全 PRD、设计文档、架构文档,然后才开始写代码。在进行早期的快速市场验证时,这种重文档的流程会严重拖慢试错速度。

我的改进思路是:SOP 应该是模块化的。可以拆分为 bootstrap-sop(用于打地基)和 feature-iteration-sop(用于单点功能突击)。小功能迭代不需要重写架构文档,只需更新接口契约即可。

上下文的线性膨胀

每次执行步骤前,SOP 都要求 AI “完整阅读 memory-bank 下的所有文档”。当系统变得庞大时,每次都灌入海量上下文,不仅消耗 Token 极快,还会导致 AI 产生”注意力稀释”,忽略关键细节。

解决方案是引入分层/索引化上下文。AI 首先读取一份轻量级的 index.md,然后根据当前任务,自主决定要去检索哪个具体的子系统文档,而不是每次都全量读取。

人工网关瓶颈

“在我验证当前步骤前,不要开始下一步”,这意味着开发者必须时刻盯盘,手动跑测试,手动回复。这并没有发挥出 AI 自动化执行的全部潜力。

更好的做法是将”人工验证”升级为”测试驱动验证(TDD)“。SOP 可以规定:实施计划的第一步必须是写一段测试脚本。AI 写完业务代码后,必须自己运行脚本,只有控制台返回 Success,它才能自动更新进度并进入下一步。

构建个人 SOP 的四大法则

在这个过程中,我逐渐总结出了构建个人 SOP 的四大法则:

约束至上法则 — 好的 SOP 不在于告诉 AI “你能做什么”,而在于严格规定”你绝对不能做什么”。例如:“严禁在未检查环境变量配置的情况下直接修改端口映射”、“严禁合并两个不相关的实施步骤”。

输入输出标准化 — 把 AI 当作一个函数,SOP 就是这个函数的类型声明。避免让 AI 输出毫无结构的散文。直接给出 JSON 或特定 Markdown 结构的模板,强制 AI 按照特定格式输出。

状态流转机制 — SOP 必须让 AI 清楚地知道项目目前处于什么状态,以及如何合法地进入下一个状态。建立清晰的”准入/准出条件”。

内置降级与反思 — 最糟糕的 SOP 是假设 AI 一次就能做对。优秀的 SOP 必须包含”纠错逻辑”。例如:“如果在执行某一步骤时,连续报错超过 3 次,你必须停止修改代码,记录错误日志,并向我请求干预。“

结语 / 反思

构建优秀的 SOP,本质上是在做一场**“降维打击”**——把高维度、发散性的自然语言编程,降维成低维度、高确定性的流水线工程。

我的建议是:不要试图用一个巨无霸 SOP 解决所有问题。你可以先为你最熟悉的工作流写一个最精简的、包含严格测试卡点的 Skill,在实际使用中不断修剪它。

当你能用这套 SOP 稳定、可预期地重复输出高质量的工程结构时,这套 SOP 就成了你个人开发能力的极效放大器。

克制 AI 的盲目,是所有优秀规范的底层逻辑。而这种克制,最终会转化为你对整个开发流程的精准掌控。