AI工具实战--VibeCoding开发流程:写代码前的9步准备

张开发
2026/4/4 0:58:56 15 分钟阅读
AI工具实战--VibeCoding开发流程:写代码前的9步准备
VibeCoding最近特别火。但很多朋友反映一个问题通过VibeCoding项目推得特别快但越往后代码越乱慢慢变成屎山越改越差最后牵一发而动全身整个项目直接崩盘。问题不在AI强不强而在于VibeCoding不是把活丢给AI就完事了你还需要构建一套工程流程来驾驭AI。今天讲一套标准的工作流开发前的9个步骤 开发中的5个关键点。总览开发前9个步骤三阶段 ├── 第一阶段定图纸步骤1-3 ├── 第二阶段打地基步骤4-6 └── 第三阶段立规矩步骤7-9 开发中5个关键点 ├── 关键点1小步迭代 ├── 关键点2主动拆分 ├── 关键点3限制权限 ├── 关键点4坚守安全底线 └── 关键点5科学应对报错第一阶段定图纸步骤1-3步骤1导需求先别写代码先像跟朋友聊天一样把痛点、目标用户、使用场景、理想中的核心功能全部讲给AI。这个时候不用追求严谨追求信息量。让AI理解你想要什么比让AI马上动手更重要。步骤2整理PRD文档让AI输出一份结构化的PRD文档包括内容说明功能列表有哪些功能用户流程用户怎么操作页面清单有哪些页面重点每个功能后面补一句做到什么程度才算完成。功能验收标准用户登录输入账号密码点击登录跳转到首页登录失败提示账号或密码错误不锁定账户登录成功跳转到首页显示用户名如果你没有验收标准一定会写得越来越发散。步骤3定视觉和页面框架找2-3个参考网站或者让AI给出几种风格方案。你需要决定导航栏怎么放页面有哪些区块整体想要简约风还是豪华风这步是为了后面不让AI一边写功能一边把UI推倒重来。第二阶段打地基步骤4-6步骤4明确项目边界和非功能需求回答三个问题问题说明本地自用还是上线公开影响安全性和性能要求有没有用户数据、支付、隐私合规影响合规设计性能和成本有没有上限影响技术选型安全、性能、可用性、成本——这四个不写清楚后面一定会返工。步骤5锁定技术栈原则不是越主流越好而是越可验证越好。主流技术通常更稳因为资料多、工具链成熟、不容易瞎编。但更关键的是你选的技术要有社区材料官方文档清晰示例能跑测试能监控一句话总结不用追求特别潮追求可控、资料多。步骤6出轻量化架构草案让AI输出内容说明目录架构怎么分层核心模块有哪些模块数据模型长什么样服务端逻辑哪些逻辑必须在服务端注意这是草案不是宪法。允许持续迭代但每次迭代都要记录原因。第三阶段立规矩步骤7-9步骤7固化项目上下文把架构、当前状态写成项目根目录的三个文本文件文件内容PRD.md需求文档ARCH.md架构描述PROJECT.md项目阶段、已知问题、下一步要干嘛这三份是AI的全局上下文。每次大改动这三份必须同步更新否则AI会按照旧的世界观写新代码。步骤8定开发规范和参考资料让AI有照着抄的标准规范示例语言规范必须用TypeScript命名规则组件命名用PascalCase文件限制单文件不超过500行另外建一个reference文件夹放你认可的按钮、表单、弹窗的标准实现。步骤9拉起Git和质量闸门Git是安全带。某个代码写着写着飞了你可以通过Git一键回溯到以前最好的代码。通过多个分支开发不同特性并行开发不用担心冲突。开发中的5个关键点关键点1小步迭代MVP法则一次只做一个可验证的小切片。阶段目标页面能打开最小可用能提交表单核心交互服务端保存数据持久化权限校验安全性列表展示完整流程每完成一个能跑通的切片就跑测试、Git提交一次。关键点2主动拆分人类必须介入。不允许所有代码都放在同一个文件里。虽然看着很爽但后面找某个功能会特别崩溃。关键点3限制权限禁止AI做主每次任务结尾加一句“只改我点名的文件和范围不要顺手重构不要改UI风格不要改无关逻辑。”你让他修一个按钮它可能顺便重写整个页面。用状态摘要管理上下文防止AI越改越多。关键点4坚守安全底线这四条必须盯住底线说明敏感信息不入前端很容易被人抓出来密钥不入仓库用环境变量和服务端调用服务端校验和授权校验不能信任前端输入不信任任何用户输入防注入攻击写代码往往只求能跑不会默认安全。你至少要盯住这些底线。关键点5科学应对报错如果两次没有新增证据就停掉。正确做法步骤动作1做最小复现把问题缩到最小输入2加日志、加断点打印关键变量分支3写一个小测试把当前正确行为锁住4让AI基于测试来修如果连续两次都没有进展只是在拆东墙补西墙借助Git回滚到上一个稳定点别让它乱改扩大损失。检查清单开发前检查需求是否讲清楚PRD是否有验收标准技术栈是否锁定架构草案是否输出三个上下文文件是否创建开发中检查是否小步迭代是否主动拆分模块是否限制AI的修改范围是否遵守安全底线报错时是否科学应对常见问题Q1开发前花这么多时间值得吗值得。9步准备可能花1-2小时但能避免后面几天的返工。Q2AI不听我的怎么办用更具体的约束。不要说优化一下要说只改XX文件的XX函数不超过20行。Q3项目已经变成屎山了怎么办如果重构成本高于重写成本考虑重新开始这次按流程来。一句话总结开发前的9步告诉你做什么、怎么做开发中的5个关键点决定你的项目能不能真正落地存活。你负责边界和验收AI负责体力活。

更多文章