可以把这件事拆成两部分:先学会“怎么向 AI 提需求”,再用这个方法产出一份“可直接拿去生成博客程序”的高质量需求说明书。
先说结论。对 AI 提需求,最核心的不是“写得长”,而是把 6 件事说清楚:
- 目标是什么
- 给谁用
- 要解决什么具体问题
- 功能边界到哪里
- 技术和交付约束是什么
- 什么叫“完成”
很多人给 AI 的需求低效,通常是因为只说了“帮我做个博客”,但没有定义用户、场景、功能优先级、页面范围、技术栈、验收标准。AI 就只能自行脑补,结果往往偏题。
一套最高效的提需求结构
可以以后固定按下面这个顺序给 AI:
项目背景
- 你为什么要做这个产品
- 当前已有内容或系统是什么
- 这个项目是练手、商用、个人展示,还是正式运营
产品目标
- 这个博客最重要的目标是什么
- 例如:内容展示、SEO获客、沉淀品牌、知识付费前置、个人作品展示
目标用户
- 谁会访问
- 他们最关心什么
- 他们会执行哪些操作
核心场景
- 用户进入后最常见的 3 到 5 个行为路径
- 例如:看文章、按分类查找、搜索、评论、订阅、后台写作
功能清单
- 必须有
- 应该有
- 可选
- 明确哪些这期不做
页面与信息架构
- 有哪些页面
- 每个页面有哪些模块
- 页面之间如何跳转
数据结构
- 文章有哪些字段
- 分类、标签、作者、评论、用户等对象有哪些属性
权限与角色
- 游客、注册用户、编辑、管理员分别能做什么
非功能要求
- 性能
- SEO
- 安全
- 响应式
- 可维护性
- 可扩展性
技术约束
- 指定或不指定技术栈
- 部署环境
- 数据库
- 是否需要 CMS、SSR、静态生成
设计要求
- 风格参考
- 色彩倾向
- 是否偏极简、专业、媒体化、开发者风格
- 是否有暗黑模式
交付要求
- 你要 AI 交付什么
- 例如:PRD、原型、页面文案、前端代码、全栈代码、数据库设计、测试用例、部署脚本
验收标准
- 具体到可以检查
- 例如:支持发布文章、支持 Markdown、首页可按分类筛选、文章页 SEO 标签完整、移动端可正常阅读
怎么写,AI 才最准确
你写需求时,尽量遵守这几个原则:
1. 用“明确指令”,不要用模糊形容词
差的写法:
- 做一个好看的博客
- 要高级一点
- 体验丝滑
- 功能完整
好的写法:
- 首页首屏展示最新 6 篇文章
- 支持文章封面、摘要、标签、发布时间
- 移动端文章正文宽度适配,正文字号 16px 以上
- 后台支持 Markdown 编辑与文章预览
2. 明确“优先级”
你要告诉 AI:
- P0:必须实现
- P1:建议实现
- P2:可以后续补充
否则 AI 容易把精力浪费在不重要的功能上,比如评论系统、点赞动画、复杂推荐算法。
3. 明确“不做什么”
这很重要。比如:
- 本期不做多语言
- 不做支付
- 不做复杂社交关系
- 不做原生 App
- 不做第三方登录
AI 一旦不知道边界,就会过度设计。
4. 尽量量化
例如:
- 支持 1000 篇文章规模
- 首页首屏 LCP 目标小于 2.5s
- 搜索支持标题和正文关键字
- 后台管理员最多 3 个角色
- 文章预计字段 12 个以内
5. 把“假设”写出来
比如:
- 当前内容由站长一人维护
- 前期读者无需注册即可浏览
- 评论可关闭
- 主要流量来自搜索引擎和社交分享
这会帮助 AI 做合理设计。
6. 明确你希望 AI 扮演什么角色
例如:
- 请你以资深 AI 产品经理身份输出 PRD
- 请你以全栈架构师身份推荐技术方案
- 请你以高级前端工程师身份实现页面
- 请你先提问补全信息,再开始写方案
这个很有用,因为它会直接影响 AI 的输出风格和深度。
最实用的需求提问模板
以后可以直接复制这段给 AI:
你现在扮演一名资深AI产品经理兼全栈架构师,帮助我设计并实现一个博客程序。
请按以下方式工作:
1. 先阅读我的需求背景
2. 如果信息不足,先提出关键澄清问题,不要直接开始生成方案
3. 在信息足够后,输出完整的需求说明书
4. 然后给出技术方案、信息架构、页面结构、数据模型和开发优先级
5. 最后按需求说明书生成可实施的开发任务清单
项目背景:
[在这里写背景]
项目目标:
[在这里写目标]
目标用户:
[在这里写用户]
核心功能:
[在这里写功能]
技术偏好/限制:
[在这里写技术要求]
设计风格要求:
[在这里写设计要求]
交付物要求:
[在这里写你想要PRD、原型说明、代码、数据库设计、部署方案等]
输出要求:
- 先补充问题,再出方案
- 方案要结构化
- 明确区分必须做、建议做、后续做
- 给出验收标准
- 尽量避免过度设计一份适合 AI 高效工作的“完美需求说明书”示例
下面是一份完整版本。可以把它作为“博客程序”的标准需求说明书基础模板,后续只需要替换细节。
# 博客程序需求说明书
## 1. 项目概述
我要开发一个现代化博客程序,用于发布技术文章、产品思考和项目案例。该博客既是内容发布平台,也是个人/团队品牌展示站点。
本项目目标是:
- 提供良好的文章阅读体验
- 具备清晰的内容组织能力(分类、标签、搜索)
- 支持后台内容管理
- 具备良好的 SEO 能力
- 支持后续扩展为多作者内容平台
当前阶段优先实现 MVP 版本,先满足内容发布、展示、检索和基础管理,不追求复杂社区能力。
## 2. 项目目标
### 2.1 核心目标
- 用户可以快速浏览和阅读文章
- 管理员可以高效创建、编辑、发布文章
- 网站具备良好的搜索引擎收录能力
- 页面在桌面端和移动端均有良好体验
### 2.2 商业/产品目标
- 用于个人品牌建设或团队内容运营
- 提升内容沉淀能力
- 可作为后续知识产品或订阅服务的内容基础设施
## 3. 目标用户
### 3.1 访客用户
- 通过搜索引擎、社交媒体或直接访问进入博客
- 主要诉求:快速找到感兴趣的文章并获得良好阅读体验
### 3.2 注册用户(可选,MVP 可不做)
- 可以评论、收藏、订阅内容
- 当前版本不作为必需功能
### 3.3 管理员/作者
- 负责编写、编辑、发布、下线文章
- 管理分类、标签、文章封面、SEO 信息
## 4. 产品范围
### 4.1 本期必须实现(P0)
- 首页
- 文章列表页
- 文章详情页
- 分类页
- 标签页
- 搜索功能
- 后台登录
- 后台文章管理
- 后台分类/标签管理
- Markdown 编辑器
- SEO 基础能力
- 响应式布局
### 4.2 本期建议实现(P1)
- 相关文章推荐
- 文章目录导航
- 代码高亮
- 草稿与定时发布
- 阅读量统计
- 暗黑模式
- RSS 输出
- Sitemap 自动生成
### 4.3 后续版本考虑(P2)
- 评论系统
- 用户注册登录
- 点赞/收藏
- 邮件订阅
- 多作者协作
- 多语言支持
- AI 文章摘要/标签生成
### 4.4 本期不做
- 电商/支付
- 复杂社交系统
- 即时聊天
- 原生移动端 App
- 大型推荐算法系统
## 5. 核心用户场景
### 场景1:访客阅读文章
用户进入首页 -> 浏览文章卡片 -> 点击文章详情 -> 阅读正文 -> 查看相关文章 -> 返回列表继续浏览
### 场景2:访客搜索内容
用户输入关键词 -> 查看搜索结果 -> 进入相关文章 -> 继续浏览标签或分类
### 场景3:管理员发布文章
管理员登录后台 -> 新建文章 -> 使用 Markdown 编辑 -> 设置标题、摘要、封面、分类、标签、SEO 信息 -> 保存草稿/发布
### 场景4:管理员管理内容
管理员在后台查看文章列表 -> 筛选草稿/已发布文章 -> 编辑或删除 -> 管理分类和标签
## 6. 页面与信息架构
### 6.1 前台页面
1. 首页
2. 文章列表页
3. 文章详情页
4. 分类归档页
5. 标签归档页
6. 搜索结果页
7. 关于页(可选)
### 6.2 后台页面
1. 登录页
2. 仪表盘
3. 文章列表页
4. 新建/编辑文章页
5. 分类管理页
6. 标签管理页
7. SEO/站点设置页(可选)
## 7. 页面详细需求
### 7.1 首页
模块包括:
- 顶部导航
- 站点标题/简介
- 最新文章列表
- 推荐文章区(可选)
- 分类入口
- 页脚
要求:
- 默认展示最新 6~12 篇文章
- 每篇文章显示标题、摘要、封面、分类、标签、发布时间、阅读时长
- 支持分页或“加载更多”
### 7.2 文章详情页
模块包括:
- 标题
- 作者信息
- 发布时间
- 分类/标签
- 正文内容
- 文章目录
- 相关文章推荐
- 上一篇/下一篇导航
- 分享入口(可选)
要求:
- 支持 Markdown 渲染
- 支持代码高亮
- 支持图片展示
- 支持 SEO meta 信息
- 阅读体验优先,正文排版清晰
### 7.3 搜索结果页
要求:
- 支持按标题、摘要、正文关键字检索
- 展示匹配文章列表
- 支持无结果状态提示
### 7.4 后台文章编辑页
字段包括:
- 标题
- 摘要
- 正文
- 封面图
- 分类
- 标签
- slug
- SEO 标题
- SEO 描述
- 发布状态(草稿/已发布)
- 发布时间
要求:
- 支持 Markdown 编辑与预览
- 支持自动保存草稿
- 支持文章预览
## 8. 数据模型
### 8.1 文章 Article
字段:
- id
- title
- slug
- summary
- content_markdown
- content_html(可选)
- cover_image
- status(draft/published)
- category_id
- author_id
- seo_title
- seo_description
- reading_time
- created_at
- updated_at
- published_at
### 8.2 分类 Category
字段:
- id
- name
- slug
- description
### 8.3 标签 Tag
字段:
- id
- name
- slug
### 8.4 作者 Author
字段:
- id
- name
- avatar
- bio
- email
### 8.5 用户 User(如启用后台账号体系)
字段:
- id
- username
- password_hash
- role
- created_at
## 9. 权限设计
### 游客
- 查看公开文章
- 搜索文章
- 查看分类和标签页
### 管理员
- 登录后台
- 创建/编辑/删除文章
- 管理分类和标签
- 管理 SEO 基础信息
- 管理文章发布状态
## 10. 非功能需求
### 10.1 性能
- 首页和文章页加载速度快
- 优化图片加载
- 支持静态生成或服务端渲染优先
### 10.2 SEO
- 每篇文章支持独立 title、description、slug
- 自动生成 sitemap
- 支持 canonical
- 结构化数据可作为增强项
### 10.3 响应式
- 适配桌面端、平板、手机
- 移动端正文易读,交互简洁
### 10.4 安全
- 后台必须鉴权
- 密码必须加密存储
- 防止常见 XSS/CSRF/注入问题
### 10.5 可维护性
- 前后端结构清晰
- 代码易于扩展
- 支持后续增加评论、订阅、多作者能力
## 11. 技术要求
如无特殊限制,优先推荐现代 Web 技术栈,要求开发效率高、SEO 友好、维护成本适中。
优先方案建议:
- 前端:Next.js
- UI:Tailwind CSS 或成熟组件库
- 后端:Next.js API Routes / Node.js
- 数据库:PostgreSQL
- ORM:Prisma
- 内容编辑:Markdown
- 鉴权:NextAuth 或等效方案
- 部署:Vercel / Docker / 云服务器均可
如果 AI 认为有更适合博客场景的方案,可以说明替代方案及原因,但必须优先考虑:
- SEO
- 开发效率
- 可维护性
- 部署简单
## 12. 设计要求
- 整体风格:简洁、专业、偏内容型产品
- 避免花哨营销页风格
- 强调阅读体验和内容层级
- 支持浅色主题,暗黑模式为可选增强
- 字体、间距、段落、代码块样式需适合长文阅读
## 13. 交付物要求
请 AI 最终输出以下内容:
1. 完整 PRD
2. 技术方案设计
3. 页面结构说明
4. 数据库模型设计
5. API 设计草案
6. 开发任务拆解(按优先级)
7. 测试验收清单
8. 可直接开始编码的项目脚手架建议
## 14. 验收标准
以下条件满足即视为 MVP 完成:
- 管理员可登录后台
- 可创建、编辑、删除、发布文章
- 前台可查看文章列表和文章详情
- 支持分类、标签、搜索
- 页面具备基础 SEO 信息
- 支持移动端适配
- Markdown 内容显示正常
- 代码块和图片展示正常
- 系统可部署并稳定运行
## 15. 对 AI 的工作要求
请按以下步骤工作:
1. 先审查这份需求是否存在冲突、遗漏和模糊点
2. 提出最多 10 个最关键澄清问题
3. 在我回答后,再输出最终版 PRD
4. 输出时明确标记:
- 已确定需求
- 待确认需求
- 风险项
- 默认假设
5. 然后基于最终 PRD 生成开发方案和代码实现计划怎么判断这份需求是否“足够好了”
可以用下面 7 个标准检查:
- AI 是否还需要大量猜测
- 功能边界是否清楚
- 页面范围是否清楚
- 数据对象是否清楚
- 技术约束是否清楚
- MVP 和后续版本是否分开
- 验收是否可以逐条检查
如果这 7 项都比较清楚,AI 生成方案和代码的质量通常会明显提高。
最关键的实践建议
真正高效的方式不是一次性让 AI “直接写代码”,而是分三步:
先让 AI 帮你补需求
- 让它先提问题,找模糊点
再让 AI 输出 PRD/技术方案
- 确定边界和结构
最后再让 AI 分阶段写代码
- 先脚手架
- 再核心页面
- 再后台
- 再优化 SEO 和体验
这样准确率比“一句话生成完整项目”高很多。