VibeCraft Vibe Coding 实战指南
标准 SOP 真实对话示范 Git 安全网

从 0 到 1 五步标准化开发工作流(SOP)

Vibe Coding 成败的关键不在“提示词多华丽”,而在于节奏控制。把一个大项目拆成 5 个标准动作,你会发现几乎不会出现全局崩盘。

Step 1:反问澄清,冻结极简 PRD

千万不要一上来就说“帮我写一个小红书”。先让 AI 逼着你把范围砍到最小可运行单元(MVP):

真实对话示范(第 1 轮)

你:我想做一个给团队用的“接口监控与告警小工具”,支持定时测 URL 状态,挂了就发飞书通知。先不要写代码,反问我 5 个最关键的设计问题。
AI 会问你:1. 需要多用户登录还是单管理员密码即可? 2. 数据库用单文件 SQLite 够吗? 3. 定时周期是固定每分钟还是每个站点自定义? 4. 连续失败几次才告警以防抖动? 5. 需要历史响应曲线图吗?

你用 3 句话答完这 5 个问题,再让它整理成 docs/PRD.md。把二期才要做的权限系统、图表导出全部明确写进“本期不做清单”,这一步就能帮你省下 60% 返工。

Step 2:契约先行(Schema + API 先定死)

让 AI 先写出两个只包含“结构定义”的文件,经你确认后再开始写实现:

GET  /api/monitors          -> { "code": 0, "data": [ { "id": 1, "name": "...", "status": "up" } ] }
POST /api/monitors          -> Body: { "name": "官网", "url": "https://..." }
POST /api/monitors/{id}/run -> 立即手动触发一次检测并返回耗时

Step 3:纵向切片小步快跑(Vertical Slice)

永远按“能端到端跑通的一小条功能”切块推进,而不是把所有后端文件先写完、再把所有前端页面写完:

轮次本轮只做什么验收动作(必须亲眼看见)
切片 1项目脚手架 + SQLite 建表 + /api/health浏览器打开首页正常,访问 /api/health 返回 {"ok": true}
切片 2新增监控项表单 + 后台入库 + 首页列表渲染页面填一个网址提交,刷新页面依然还在列表里
切片 3后台定时检测调度器 + 飞书 Webhook 告警填一个故意不通的端口,观察后台日志 1 分钟内发出告警请求
切片 4管理员登录密码保护 + 响应式样式精修未登录请求 POST 接口返回 401,手机宽度下无错位

Step 4:强制验证闭环(不看自夸看输出)

每次 AI 说“我已经完成了”,立即让它运行或你亲自运行真实检验命令:

# 后端:语法与测试
pytest -q && curl -s http://127.0.0.1:8000/api/health

# 前端:TypeScript 类型检查 + 生产构建(很多本地 dev 模式不报错的问题 build 时全暴露)
npx tsc --noEmit && npm run build

Step 5:Git 存档与 20 轮强制换窗

两条保命习惯
  1. 每通一个切片就 Commit:哪怕你不上传到 GitHub,本地运行 git init && git add . && git commit -m "step 2: monitor CRUD" 也是你的后悔药。一旦后面 AI 改乱了,git diff 一眼看出改坏哪行,git checkout -- . 秒回档。
  2. 单次对话不要超过 20 轮:上下文塞满旧报错后,AI 注意力会被严重稀释。让它输出一份当前状态摘要文档 HANDOFF.md,马上开新对话继续。