brainax

先做计划:一页纸需求

“Vibe coding”课程第 5 课,共 26 课。免费,有动画和小测验。

为什么先计划再写代码

AI 不会读心术。你没说的部分,它会自己脑补,而且常常不是你想要的。你说“做个健身房打卡工具”,结果拿到一个带付款、聊天和排行榜的应用,其实你只想记录训练。然后花半天返工。写代码前先列个简短计划,省下的时间比花的多。听起来很无聊,其实就五分钟。

一页纸需求

需求文档就是对你要做的东西的简短描述。上一课的请求描述的是一个步骤,需求文档描述的是整个项目。一共五行。目标:一句话说清为什么做。给谁用:谁会用它。三个主要功能。现在不做什么。完成标准:凭什么判断做成了。图里是一个健身打卡工具的例子。

三个功能和“现在不做”

MVP,最小可行产品:已经能派上用场的最小版本。对打卡工具来说就是三个功能:记录一次训练、查看连续打卡天数、看简单统计。“现在不做什么”这一行同样重要:付款和聊天可以以后再说。常见错误:一口气写上二十个功能。项目被拖垮,什么都做不完。

“完成标准……”

最后一行是一份简短的检查清单,也就是可以逐项打勾的条目。例如:“手机上能打开且好用”“刷新页面后打卡记录还在”“朋友能自己注册”。没有这一行,项目可以永远改下去。有了它,你就知道什么时候该停下来发布。

先计划,再写代码

把需求文档交给 AI,并让它先别写代码:“请提出项目结构,并把工作拆成步骤。”读一读回答。如果 AI 加了多余的东西或理解错了,现在就改计划,这时只是几行文字而已。然后一步步来:骨架(也就是页面的空框架)、第一个功能、第二个、发布。把需求文档放在项目里,每次开新对话都发给 AI。

自测一下

  1. 需求文档里为什么要有“现在不做什么”?
    正确答案: 让你和 AI 不在多余的东西上浪费精力. 没有这一行,AI 会自作主张加上付款、聊天等。明确说“不做”,项目才能保持小巧、做得完。
  2. 什么是 MVP?
    正确答案: 已经有用的最小版本. MVP 就是最小可行产品。它已经能解决核心问题,其余的以后再加。
  3. 需求文档写好了,先让 AI 做什么?
    正确答案: 先提出结构和步骤,暂不写代码. 先看 AI 怎么理解任务。改几行计划,比重写已经写好的代码容易得多。

← 怎么给 AI 布置任务 密钥与机密信息 →