[控场AI]
· 5 分钟阅读· 2,965 字

Vibe Coding实战:用AI专业规划产品功能

Vibe Coding实战:用AI专业规划产品功能

先做产品规划再开发,用文档和规范让Vibe Coding变得可控。

文章针对AI辅助编程(Vibe Coding)中项目越做越乱的问题,指出根源在于跳过产品规划阶段。B站UP主“丁老师”提出一套从0到1的工作流:先把产品规划文档独立存放在Docs文件夹,产品事实文档内容唯一以免冲突;再搭建项目地基,包括Git分支开发、测试通过后合并、同步远端备份,并引入Spec文档作为单次开发任务的规范,由开发Agent和测试Agent共同遵循;接着收敛用户角色、梳理用户故事并定P0/P1/P2优先级;然后从故事推导界面、数据库字段模型与技术栈;最后拆分里程碑。核心原则是节奏由人引导,AI只在可控范围内提供建议。

为什么你的Vibe Coding项目总是“长歪”?

很多开发者用AI写代码时,一上来就让AI直接生成页面和功能,结果项目越做越乱:文案堆砌、按钮找不到、功能互相冲突。B站UP主“丁老师”在系列教程中指出,问题出在跳过产品规划阶段。他提出一套从0到1的Web Coding工作流,核心是先和AI把产品架构、用户角色、功能边界彻底想清楚,再进入开发。这套方法强调:节奏由人引导,AI只负责在可控范围内提供建议。

据该UP主分析,产品规划阶段需要产出多份文档,并严格区分存放位置——所有与产品规划相关的文档应放在独立的Docs文件夹中,而不是混在源码里。其中“产品事实文档”用于描述产品骨架,每个文档内容唯一,避免冲突。若AI在调整时只改一个文件而遗漏另一个,内容会逐渐矛盾,导致项目越来越乱。

每次开发都会从主仓库上拉出一个分支来

第一步:搭建规范的项目地基

开始前,先建一个空白文件夹,并打开AI Agent软件(如Codex、Workbody、Cloud Code等)。若使用Codex,需切换到Codex模式进行严肃开发。选择该文件夹,并挑选你能用到的最好模型和订阅套餐能承受的最高思考度。

随后用两三句话向AI描述产品雏形。例如UP主举例:开发一个项目,让粉丝能看到其他粉丝提交的Vibe Coding作品,点击可进入作者主页,甚至添加联系方式。描述不必过细,但需清晰。

接下来贴入一段项目结构规范提示词,让AI自动生成目录结构。据视频演示,AI会建立Docs文件夹存放产品规划文档,并设定工程规范:源码纳入Git仓库,每次开发从主仓库拉出分支,测试通过后才合并回主仓库,确保主仓库代码始终正确。同时同步到GitHub远端仓库作为备份,防止本地电脑故障。

这里出现一个关键概念:Spec文档(需求规格说明书)。它描述单次开发任务,区别于产品事实文档。每次与规划Agent确定任务后输出Spec,开发Agent基于Spec开发,测试Agent基于Spec验收,三方遵从同一规范。

Spec文档(需求规格说明书)与产品事实文档的分工是这套工作流的关键设计。产品事实文档描述的是产品的长期骨架——有哪些角色、每个角色能做什么、数据模型长什么样,它的生命周期与项目等长,任何改动都必须同步更新所有受影响的条目。而Spec文档只服务于一次具体的开发任务:它从产品事实文档中摘取本次要实现的切片,写明输入、输出、验收标准与边界条件。开发Agent按Spec写代码,测试Agent按Spec写用例并验收,规划Agent负责在任务完成后把Spec中沉淀下来的新事实回写到产品事实文档。三者共享同一份规范,才能避免“开发以为做了、测试以为没做、文档以为不存在”的错位。

第二步:收敛用户角色,避免功能膨胀

项目结构就绪后,进入产品功能探讨。第一步是确定用户角色。UP主提醒:每多一个角色,产品功能就复杂一分,应尽量缩减但平衡体验。

以Vibe Coding作品展示网站为例,AI initially推断出四个角色(普通观众、创作者、管理员等),但UP主明确只要两个:管理员负责上传所有内容,游客负责浏览、访问作品、留言点赞等。据B站UP主演示和视频画面,AI随后基于观众角色推断出多个用户故事:随便看看、带着需求搜索作品、了解作品是否合适、体验作品、学习作品做法。UP主补充一个故事:用户看完后想投稿并联系自己。

然后他已经给你出来了两个角色

用户故事梳理完后需定优先级(P0/P1/P2)。P0是必须优先满足、界面要设计好的;P1可选择是否在第一期满足;P2可先不考虑界面,保留功能即可。UP主将访问作品、体验作品等编号1-4定为P0,投稿和联系定为P1。管理员故事同样分级,砍掉无关信息后按P0/P1/P2排列。

这里体现一个核心原则:所有节奏方向由人引导,AI只在可控范围内给建议,人来判断是否采纳。若让AI牵着跑,后续大概率出问题。

那这件事后续大概会出问题的

**用户故事(User Story)**是敏捷开发中描述需求的常用句式,典型形式为“作为〈角色〉,我希望〈做某事〉,以便〈获得某种价值〉”。它的价值在于把功能描述绑定到具体角色和动机上,而不是罗列“要有搜索框、要有详情页”这类脱离使用场景的功能清单。在AI辅助开发中,用户故事还有一个额外作用:它是AI推断界面与数据模型的中间层。角色确定后让AI生成用户故事,再由故事反推页面,能显著减少AI凭空发明功能的情况。每个故事再标注P0/P1/P2优先级,等于给AI划定了本期实现范围,避免它在生成代码时把P2需求也一并做进去,造成范围膨胀。

第三步:从故事推导界面与技术方案

用户故事确定后,开始梳理界面。UP主让AI从观众角色出发给思路,AI建议作品广场(兼首页)、作品详情页、投稿页,均对应故事,UP主确认无误。接着梳理管理员界面:作品管理、作品编辑分类、投稿说明介绍、数据浏览。

界面架子定下后,让AI处理开发者不熟悉的部分:数据库字段模型和技术栈。所有数据存数据库,表结构类似Excel列表,大框架确定后AI梳理不会出大问题;技术栈即页面搭建用什么技术,也交由AI决定。UP主强调,这两项因框架已定,可放心让AI完成。

对于复杂产品(如含登录功能),UP主建议额外让AI梳理页面跳转流程:未注册用户跳注册页,管理员或创作者跳对应页面,每个页面不同状态的跳转关系都需理清。

数据库字段模型在这里指的是把用户故事中涉及的名词提取为数据表及其字段,例如“作品”对应作品表(标题、作者、分类、链接、封面、创建时间),“留言”对应留言表(内容、留言者、目标作品、时间)。字段模型一旦定下,后续所有页面都围绕它读写,因此它是产品事实文档中最需要保持唯一性的部分。技术栈则指前端框架、样式方案、数据库类型、部署方式等的组合选择。UP主之所以把这两项放心交给AI,是因为它们属于“框架已定、约束充分”的决策:角色、故事、界面都已确定,AI的选择空间被压缩,出错概率低。反之,如果在产品规划之前就让AI选技术栈,往往会得到与需求不匹配的方案。

第四步:拆分里程碑,但别急着开发

最后一步是让AI梳理里程碑,把产品实现步骤拆开,保证开发有节奏。据视频演示,AI经过较长等待后输出复杂数据库梳理结果和里程碑规划。UP主特别提醒:里程碑梳理完不要急着开发,下一期将讲解如何确定产品样式与交互规范,确保整个产品视觉统一。

整套流程的价值在于:把“想清楚”前置,用文档和规范约束AI的输出,让Vibe Coding从随意生成变成可控工程。对于想认真做产品的开发者,这套方法值得实践。

所有的用户的体验

#Vibe Coding#AI编程#产品规划#用户故事#需求规格说明书#AI Agent#Web开发
分享:

相关推荐