从 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 先写出两个只包含“结构定义”的文件,经你确认后再开始写实现:
- 数据表结构:如
monitors(id, name, url, interval_sec, fail_threshold, status, last_checked_at) - 接口契约:明确列出路由、请求体和返回 JSON 示例,例如:
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 轮强制换窗
两条保命习惯
- 每通一个切片就 Commit:哪怕你不上传到 GitHub,本地运行
git init && git add . && git commit -m "step 2: monitor CRUD"也是你的后悔药。一旦后面 AI 改乱了,git diff一眼看出改坏哪行,git checkout -- .秒回档。 - 单次对话不要超过 20 轮:上下文塞满旧报错后,AI 注意力会被严重稀释。让它输出一份当前状态摘要文档
HANDOFF.md,马上开新对话继续。