Vibe Coding 全流程:从需求到上线的 7 步

最近密集用 Vibe Coding 做了几个项目,把跑通的流程整理出来。核心思路一句话:人定方向,AI 干活,人验收。


总览

本文系统梳理了使用 Vibe Coding(以 CodeBuddy 为例)进行项目开发的七步标准化流程:从需求调研、HTML原型验证、设计方案、详细设计、后端接口、前端开发到联调测试。核心原则是"人定方向,AI 干活,人验收",通过结构化提示词和分步迭代,将 AI 作为高效执行工具,由人类把控关键决策与质量验收。文中还总结了七条实战经验,强调提示词质量、分步执行、保存中间产物、人工审核、明确边界、范例驱动开发以及联调时提供完整上下文的重要性,旨在实现开发效率的倍数提升。

步骤 干什么 谁主导 产出
1 需求调研 需求文档
2 HTML 原型验证 CodeBuddy 生成,人确认 可交互页面
3 设计方案 CodeBuddy 生成,人审核 架构方案
4 详细设计 CodeBuddy 生成,人审核 设计文档
5 后端接口 CodeBuddy 生成,人审核 接口文档 + 代码
6 前端开发 CodeBuddy 生成,人审核 前端代码
7 联调测试 CodeBuddy 自主执行,人验收 可运行系统

1. 需求调研

干什么: 把客户嘴里模糊的想法,变成 AI 能理解的精确描述。

怎么做:

  • 痛点:客户到底哪里不爽,一句话说清
  • 需求:拆成功能点,每条写成"谁 → 做什么 → 为了什么"
  • 边界:明确写"不做什么",这步最容易被忽略,但最关键
  • 关键点:哪些地方有性能要求、安全要求、兼容要求,标出来

注意: 这步别用 AI。需求判断是人的活,AI 只能帮你整理格式。


2. HTML 原型

干什么: 5 分钟出一个能点的页面,拿给客户看,比画 Figma 快 10 倍。

怎么做:

  • 把 1 的需求整理成提示词,丢给 CodeBuddy
  • 让它输出单文件 HTML(含 CSS + JS)
  • 拿给客户看,客户说哪不对,改提示词重新生成
  • 来回 3~5 轮,基本就定了

注意: 最终确认的 HTML 页面要存好,后面前端开发直接对着它做。


3. 设计方案

干什么: 让 CodeBuddy 当架构师,出整体方案,人来挑毛病。

怎么做:

  • 输入:1 的需求 + 2 的页面结构
  • 让 CodeBuddy 输出:模块划分、业务流程、数据模型、技术选型
  • 你逐条审:拆得对不对?扩展性够不够?有没有漏?
  • 不满意就追问,让它改,通常 3~4 轮收敛

注意: 别一次性接受方案。把 CodeBuddy 当一个聪明但不懂你业务的架构师,你得用业务判断去校准它。


4. 详细设计文档

干什么: 把方案变成施工图,后面写代码全靠它。

怎么做:

  • 告诉 CodeBuddy 技术栈(比如 Spring Boot + Vue3 + MySQL)
  • 让它输出:表结构、模块内部设计、核心逻辑伪代码、异常处理、安全方案
  • 分模块生成,别一次性出全文,质量会差很多

注意: 这份文档是后面所有步骤的唯一依据,多花 30 分钟打磨这里,后面省好几小时。


5. 后端接口

干什么: 先定接口契约,再写代码。前后端能并行干活。

怎么做:

  • 输入:详细设计文档
  • 让 CodeBuddy 输出每个接口的:路径、方法、入参、出参、业务规则、JSON 示例
  • 人工过一遍:粒度够不够细,字段有没有漏
  • 确认后再让 CodeBuddy 生成后端代码

在现有项目中加功能时:

找一个目录结构清晰、接口命名规范、代码结构合理的现有菜单模块,把它的代码目录整个丢给 CodeBuddy,告诉它:"参考这个模块的风格和结构,生成新功能。"CodeBuddy 会模仿已有的命名规范、分层方式、异常处理模式来写,准确率比从零生成高很多。

注意: 一定要让 CodeBuddy 给完整的 JSON 示例,光有字段表格不够。示例才是前后端沟通的语言。


6. 前端开发

干什么: 把 2 的 HTML 原型变成工程代码。

怎么做:

  • 输入:HTML 原型 + 接口文档
  • 让 CodeBuddy 拆组件、接接口、加状态管理、补交互细节(loading、空态、报错提示)
  • 一个页面一个页面来,别贪多

在现有项目中加功能时:

同样找一个页面样式美观、组件拆分合理的现有菜单页面,把它的前端代码目录给到 CodeBuddy,让它模仿这个页面的组件结构、样式写法、路由注册方式来生成新页面。这样出来的代码风格和项目一致,不用你手动对齐。

注意: 做完对着 2 的 HTML 原型看,哪里不像改哪里,这是最直观的验收方式。


7. 联调测试

干什么: 把前后端代码和接口文档全部丢给 CodeBuddy,让它自己跑通、自己修、自己验。

怎么做:

  • 输入:后端代码 + 接口文档 + 前端代码,一次性贴给 CodeBuddy
  • 让它自主完成以下动作:
    • 联调:对照接口文档,检查前后端字段映射、请求路径、参数格式是否一致
    • 测试:生成边界用例(空值、超长、非法输入、超时),跑一遍主流程
    • Bug 修复:发现报错直接定位原因并给出修复代码
    • 合理性评估:检查逻辑是否有冗余、异常处理是否遗漏、命名是否规范,不合理的地方直接改掉
  • 你只需要最后跑一遍,看结果对不对

注意: 这步的关键是"别插手"。把上下文给全,让 CodeBuddy 自己闭环。你只在最后做验收,发现问题再追加指令让它改。


几个踩坑后的经验

  1. 提示词质量决定一切。 你给 CodeBuddy 的信息越结构化,输出越能用。别写一大段话,用列表、分点、明确约束。
  2. 分步走,别贪大。 一次让 CodeBuddy 干一件事。生成整个系统?不现实。一个模块一个模块来。
  3. 中间产物必须存。 需求文档、HTML 原型、接口文档、设计文档------每一步的输出都是下一步的输入,丢了就得重来。
  4. 人必须审。 AI 会一本正经地写出跑不通的代码。每一步生成后,人过一遍是底线。
  5. 边界比功能重要。 告诉 CodeBuddy"不做什么"比告诉它"做什么"更能控制输出质量。
  6. 现有项目加功能,给范例比给描述管用。 与其花 10 分钟描述"我要什么风格",不如直接丢一个写得好的模块目录让 CodeBuddy 照抄。模仿比创造靠谱。
  7. 联调阶段给全上下文。 后端、前端、接口文档三者同时给,CodeBuddy 才能自己发现不匹配的地方。只给一半它只能猜。

一句话总结

Vibe Coding 不是让 AI 替你想,是让 AI 替你干。你负责定方向、做判断、验结果。把这三件事做好,效率能翻几倍。

相关推荐
todoitbo3 小时前
飞算JavaAI的多租户权限隔离实测
java·springboot·ai编程·java开发·飞算javaai·java代码生成
明月_清风5 小时前
Pi Agent 深度解析:开源极简终端 AI 编码代理的终极指南
前端·后端·ai编程
因吹斯汀5 小时前
基于 Pi,我居然自己搞了一个好用的 AI Agent 桌面工作台
aigc·openai·ai编程
世界哪有真情6 小时前
AI 写代码两年多,我发现自己越来越"看不进去"了
前端·后端·ai编程
全栈弄潮儿6 小时前
AI 写代码后,如何自己检查有没有问题?
aigc·openai·ai编程
禁止摆烂_才浅6 小时前
前端 AI 面试题
前端·面试·ai编程
小四的小六6 小时前
两个Agent同时写同一个Tool,数据被覆盖了——我是怎么用乐观锁修好的
openai·agent·ai编程
宋哥转AI6 小时前
深入理解 AI Agent · MEMORY #03:从设计到落地
人工智能·agent·ai编程
_codeOH6 小时前
大模型上下文窗口管理:从滑动窗口到 RAG
人工智能·ai编程