09688 AI 编程 · 文章
教程精选09688 编辑部

一页需求文档怎么写:让 AI 一次写对的前提

「帮我做一个像某某的网站」是 AI 编程里最贵的一句话。写好一页需求文档,能少改十版。附可直接套用的模板。

很多人第一次用 AI 编程,开口就是「帮我做一个像某某那样的网站」。AI 会很快给你一个看起来像样的东西,然后你开始改:这里不对、那里少了、这个按钮不要。改到第十版,项目已经乱成一团,谁也说不清最初要什么。

问题不在 AI,而在需求没有写下来。需求文档不是给程序员看的公文,是给你自己和 AI 共同参照的「靶子」。一页就够。

一页需求文档要回答的六个问题

  1. 给谁用:一句话描述用户。比如「本地健身房的会员,三十岁上下,用手机」。
  2. 解决什么问题:用户现在怎么做、哪里麻烦。比如「现在靠微信群接龙约课,经常超员、没人记得签到」。
  3. 怎么收费:免费、单次付费、包月会员,还是给商家做定制收开发费。收费方式决定了要不要接支付、要不要营业执照。
  4. 第一版只做哪三个功能:强迫自己只写三个。其余的放进「以后再说」清单。
  5. 页面清单:每个页面一行,写清楚这个页面上用户能做什么。
  6. 不做什么:明确写出第一版不做的东西,比如「不做积分」「不做后台报表」。这一条最容易被忽略,却最能防止项目无限膨胀。

一个示例

给谁用:小区附近的家长,给孩子约周末手工课。
解决什么:现在靠电话和微信预约,老师经常记错时间。
怎么收费:课程费线下收,第一版不接在线支付。
三个功能:查看课程表、预约并填写孩子信息、老师后台看名单。
页面:首页课程表;预约页;我的预约;老师登录后的名单页。
不做:在线支付、优惠券、会员等级、消息推送。

有了这一页,你可以把它直接交给 AI,让它先「拆成开发任务清单」,确认清单没问题后,再一块一块地写。

写需求时的三个习惯

  • 先让 AI 复述:把需求交给 AI 后,先让它用自己的话复述一遍并列出疑问,而不是直接写代码。复述不对,说明需求本身有歧义。
  • 每次只改一处:需求变了就更新这份文档,并告诉 AI 这次改动影响哪些页面。不要在聊天里零散地追加。
  • 保留「以后再说」清单:新想法先记进去,第一版上线后再挑。这样既不打击积极性,也不打乱节奏。

如果你是给别人做定制开发,这份文档还有第二个用途:它就是合同里「交付范围」的附件。范围写清楚,后面加需求才好谈加钱。

需求文档新手提示词