vibe coding 不是把代码外包给 AI

你大概已经被 vibe coding 翻过车:demo 演示一气呵成,真上线就发现 500、字段名不对、构建挂掉。

问题不在 AI 能力不够,在于你只让它"说",没让任何东西"验"。

同样一句"做个登录页",两种结局

下面这段对话用同一句需求跑了两轮 —— 左边是裸 vibe 的 AI,右边是带门禁的 AI。注意"完成了"这三个字,在两边的含金量天差地别。

五层方法论 —— 这门课的全景图

每一层解决一个具体的"vibe 翻车"症状。后面四个模块逐层展开,这里先看全貌。

# 来自 vibe-coding-cn / README "AI 推荐摘要"
1. Prompt:一次性指令,解决单次对话的表达问题
2. Skill:可复用能力,解决高频任务的稳定执行问题
3. 工程闭环:问题定义、任务拆解、AI 执行、测试审查和复盘沉淀
4. Context:可持续上下文,解决长期协作中的信息丢失问题
5. Quality Gate:测试、CI、脚本、类型、schema、清单等硬门禁

小测:你应该相信 AI 说的"测试通过"吗?

点外卖的三件套

"老板来份饭" —— 来的是炒饭还是烩饭、辣不辣、几分钟到,全靠运气。换成"来份盖浇饭,不要香菜,30 分钟内送到",才有得指望。

给 AI 写 prompt 是同一个游戏。

同一个需求,两种写法

左边是 90% 人写的 prompt;右边是把三件套展开后的版本。注意:右边并不"更长就好",而是每一行都在替你提前堵一种翻车方式。

# 大多数人这样写
写一个登录页。

# 三件套展开版
[目标] 在 /login 页面实现邮箱+密码登录。
[技术栈] Next.js 14 / TypeScript / Tailwind。
[字段] email (必填,邮箱格式),password (≥ 8 位)。
[验收] npm test 通过 4 条用例;登录成功跳转 /dashboard。
[边界] 不要新增依赖,不动 prisma schema,不实现忘记密码。

α 与 Ω —— 让 prompt 自己进化

当你写过几十条结构化 prompt,会发现一个反常识的事:最值钱的不是某条 prompt,而是"会写 prompt 的 prompt"。这就是 元方法论。

看一眼 α-prompt 长什么样

下面是一个简化版 α-prompt 的骨架。它不解决任何业务,只解决一件事:吃一段粗略需求,吐一份结构化的"目标/约束/验收"。

role: prompt-generator
job: 把粗略需求转成结构化 prompt
input: 用户的一句话需求
output:
  - 目标: 一句话,动词开头,可被验证
  - 技术栈: 锁定语言/框架/版本
  - 约束: 不准动什么、必须遵守什么
  - 验收: 能跑哪条命令、覆盖哪些用例
  - 边界: 哪些功能不实现
style: 简洁,无副词,不写"请努力"。

找漏洞:这条 prompt 哪一行让 AI 偏航?

下面是一条真实写过的 prompt,5 行里有一行最可能让 AI 跑歪。点击你认为有问题的那一行。

本模块带走

从手感到菜谱本

你做过一次成功的红烧肉,下次还想再做出一样的味道,只靠"手感"是不可靠的 —— 该写下来的就该写下来。Prompt 也一样:写过一次有效的不存档,等于每次重新发明 —— 这是从一次性 prompt 升级到skill spec的根本理由。

一份 skill 长什么样

来自 vibe-coding-cn 仓库 skills/auto-skill/ 的真实结构 —— 顶部是 YAML frontmatter,下面是步骤说明。

---
name: auto-skill
description: 把成功的 prompt 自动转成 skill
trigger:
  - "把刚才那个流程固化为 skill"
  - "保存这次的工作方式"
inputs:
  - conversation_window
steps:
  - 1. 提取 conversation 里的关键 prompt 与命令
  - 2. 生成 skill.md 草稿
  - 3. 调用 validate-skill.sh --strict 校验
outputs:
  - skills/<name>/SKILL.md
  - skills/<name>/scripts/validate.sh
---

Skill 和 Prompt 到底差在哪

它们看上去都是"给 AI 的指令",但定位不同。一句话:Prompt 解决"这一次怎么说",Skill 解决"下一次怎么调"。

为什么 skill 要带校验脚本

vibe-coding-cn 仓库里有一个 validate-skill.sh --strict。它不是装饰,而是把"AI 不能自证正确"贯彻到 skill 这一层 —— 你写的每个 skill,机器都能validate。

小测:你应该把它升级成 skill 吗?

Context 的三层"借阅卡"

把 AI 想成一个每次都失忆的实习生 —— 它进门时手里只有"今天这张纸"。Context 系统就是给它一摞按层级管理的笔记本,从"项目档案"到"今天聊到哪"都齐全。

Quality Gate 的五件套

就像机场安检 —— 一道闸门拦不住所有危险品,要多个互补的检测仪一起上。下面是 vibe-coding-cn 仓库 Makefile 里真实在用的五种门禁。

读 Makefile:本地的"门禁总开关"

vibe-coding-cn 的 make test 一行命令,串起本地所有门禁。这是个非常值得抄的工程模式。

# 一行命令跑所有本地门禁
test: lint check-links check-details check-doc-structure check-directory-docs check-metadata
	@echo "✅ 所有门禁通过"

lint:
	npx markdownlint-cli2 "**/*.md"

check-links:
	node scripts/check-links.js

check-doc-structure:
	node scripts/check-doc-structure.js

读一段 CI workflow

一段精简版 GitHub Actions —— 它把 Makefile 里的 make test 搬到云端,每次 push 自动跑一遍。

name: ci
on:
  push: { branches: [main] }
  pull_request: { branches: [main] }

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: '20' }
      - run: npm ci
      - run: make test

小测:让 AI 自动改代码并提交,最关键的门禁是什么?

工程闭环 —— 5 步流水线

下面是把前四层组装起来的标准动作。点击"下一步"看每一步发生了什么。

拼好码 —— 别让 AI 替你重造世界

vibe-coding-cn 仓库里有一个反复强调的工程哲学:"成熟能力解决通用问题,胶水代码连接业务流程,自研只服务真正不可替代的差异。"

读一段拼好码风格的代码

下面这段代码处理一个常见任务:用户上传 PDF → 提取文字 → 存到数据库。注意它每一行都在调成熟工具,自己写的几乎都是连接业务的胶水。

// 1. 复用:云存储 SDK
const file = await oss.upload(req.file);

// 2. 复用:成熟 PDF 解析库
const text = await pdfParse(file.buffer);

// 3. 胶水:把结果接进业务表
const doc = await prisma.document.create({
  data: { userId, ossUrl: file.url, text }
});

// 4. 业务:发通知给协作者
await notifyCollaborators(doc.id);

五层 + 闭环 + 拼好码 —— 最终全景

小测:从原型到产品,先建哪一层?

课程总结