主题
如何写好需求
核心理念
本系统采用**「一次性生成」**设计理念——我们会根据你的需求进行**全局规划**，精确设计每一个模块、接口和页面，然后一次性生成完整项目。
需求描述的质量直接决定生成代码的质量！
🧠 理解我们的工作原理
在开始写需求之前，先了解我们的系统是如何工作的：
全局规划的力量
你的需求 → 需求分析 → 数据模型设计 → API 规划 → 任务拆分 → 代码生成我们会根据你的需求进行全局统筹：
- 分析需求 → 理解你想要什么
- 设计数据模型 → 规划所有实体、字段、关系
- 规划 API 接口 → 设计所有接口路径、参数、返回类型
- 拆分开发任务 → 将工作分成有序的迭代步骤
- 按计划生成 → 逐步生成前后端代码
关键洞察
**只有在需求完善的情况下，全局规划才能发挥最大效果。** 如果需求不清晰或中途修改，会破坏整体规划，导致生成结果不符合预期。
需求质量与生成效果的关系
| 需求质量 | 规划效果 | 生成结果 |
|---|---|---|
| ⭐ 模糊笼统 | 无法精确规划 | 功能缺失、需要大量修改 |
| ⭐⭐ 基本描述 | 部分规划 | 基本可用、部分功能需调整 |
| ⭐⭐⭐ 清晰具体 | 精确规划 | 完整可用、少量微调 |
| ⭐⭐⭐⭐ 详细完整 | 最优规划 | 几乎完美、直接使用 |
❌ vs ✅ 好需求与差需求对比
📌 示例一：项目描述
❌ 差的需求
"做一个电商系统"
问题：
- 什么类型的电商？B2B？B2C？C2C？
- 需要哪些功能？支付？物流？
- 有哪些用户角色？
- AI 只能猜测，结果可能完全不是你想要的
✅ 好的需求
"做一个二手书交易平台，用户可以发布自己的闲置书籍，其他用户可以浏览和购买。
用户角色：
- 普通用户：可以发布书籍、购买书籍
- 管理员：审核书籍、处理举报
核心功能：
- 书籍发布：标题、作者、类别、新旧程度、价格、照片
- 书籍搜索：按书名、作者、类别筛选
- 订单管理：下单、付款、发货、确认收货
- 个人中心：我发布的、我购买的、收藏夹"
📌 示例二：功能描述
❌ 差的需求
"需要用户管理功能"
✅ 好的需求
"用户管理功能：
- 管理员可以查看所有用户列表（分页，每页20条）
- 可以按用户名、邮箱、注册时间搜索
- 可以禁用/启用用户账号
- 可以重置用户密码
- 可以导出用户数据为 Excel"
📌 示例三：业务规则
❌ 差的需求
"订单要支持取消"
✅ 好的需求
"订单取消规则：
- 未付款订单：随时可取消
- 已付款未发货：可申请取消，自动退款
- 已发货：不可取消，需走退货流程
- 取消后库存自动恢复"
📝 需求描述模板
使用这个模板来组织你的需求：
需求模板.md
markdown
# [系统名称]
## 项目背景
简要描述这个项目是做什么的，解决什么问题。
（示例：这是一个面向大学生的二手教材交易平台，解决新学期买书贵、旧书无处处理的问题）
## 用户角色
列出所有使用系统的用户类型：
- 角色1：描述该角色的主要职责和能做什么
- 角色2：描述该角色的主要职责和能做什么
（注意：尽量控制在 2-3 种角色，复杂的权限系统会增加项目复杂度）
## 核心功能
### 功能模块1：[模块名]
- 功能点1.1（具体描述，如：用户可以上传商品图片，最多5张）
- 功能点1.2（具体描述）
- 功能点1.3（具体描述）
### 功能模块2：[模块名]
- 功能点2.1
- 功能点2.2
## 业务规则
列出重要的业务逻辑和规则（这很重要！）：
- 规则1（示例：订单超过30分钟未付款自动取消）
- 规则2（示例：每个用户最多同时发布10个商品）
## 数据和展示
描述你希望看到的数据展示：
- 首页：显示最新上架的商品、热门分类
- 个人中心：我发布的、我购买的、我的收藏
## 技术要求（可选）
如果有特定的技术限制或偏好：
- 需要支持手机端
- 需要支持微信登录💬 AI 对话技巧
在和 AI 助手对话时，我们会引导你完善需求。以下是一些有效的对话技巧：
开始对话
好的开始方式
你说： "我想做一个个人博客系统，主要想自己写文章记录学习心得，也想让朋友们能看到和评论。"
AI 助手会回复： "明白了，你想做个个人博客来记录学习心得。通常博客会包含这些功能：
- 写文章、编辑、删除文章
- 给文章分类和打标签
- 读者可以评论文章
- 搜索文章内容
- 文章可以设为草稿或发布
- 统计文章阅读量
这些功能里，哪些是你需要的？还有其他想要的吗？"
明确回复
清晰的回复
你说： "功能 1、2、3、5 我都需要。搜索功能暂时不用。另外我还想要：
- 文章支持插入图片
- 有一个"关于我"的页面
- 深色模式"
确认完成
当需求收集接近完成时，AI 会帮你总结：
需求总结示例
AI 总结： "好的，总结一下你的博客系统需求：
用户角色
- 博主（你）：写文章、管理内容
- 访客：阅读文章、发表评论
核心功能
- 文章管理：写文章、编辑、删除、设为草稿/发布、插入图片
- 分类标签：可以给文章设置分类和标签
- 评论系统：访客可以评论文章
- 静态页面：「关于我」页面
- 界面：支持深色模式
这样理解对吗？如果没问题，我们就可以开始生成了！"
⚠️ 常见误区与建议
误区一：需求过于简单
**问题**："做一个博客" —— 太模糊了
建议：至少说明核心功能、用户角色、主要的业务规则
误区二：需求过于复杂
**问题**："做一个完整的电商平台，包括商城、社区、直播、短视频..." —— 范围太大
建议：从核心功能开始，控制在 3-5 个主要模块。MVP 原则：先做最小可用版本。
误区三：只说"是什么"不说"怎么用"
**问题**："需要订单管理" —— 不知道要怎么管理
建议：描述用户如何使用。"管理员可以查看订单列表、按状态筛选、处理退款申请"
误区四：忽略业务规则
**问题**：只列功能，不说规则
建议：业务规则很重要！比如"库存不足时不能下单"、"优惠券只能使用一次"
误区五：中途大改需求
严重问题
**问题**：生成过程中突然说"我还要加一个论坛功能"
后果：会破坏已有的全局规划，导致架构不一致
建议：在开始生成之前，确保需求已经完整。小调整可以接受，大改动会影响质量。
✅ 需求自检清单
在提交需求之前，用这个清单检查一下：
项目目标清晰：一句话能说明这是做什么的
用户角色明确：列出了所有使用者类型
核心功能具体：主要功能点都有详细描述
业务规则完整：重要的规则和限制都说明了
范围可控：功能模块在 3-5 个以内
没有模糊表述：没有「等等」「之类的」「大概」
📚 常见需求示例库
以下是一些常见类型项目的需求参考：
📝 博客系统
博客系统需求要点
- 用户角色：管理员、作者、访客
- 文章管理：发布、编辑、删除、草稿、定时发布
- 分类标签：多级分类、标签系统
- 评论功能：发表评论、回复、审核
- SEO 优化：自定义 URL、Meta 信息
- 业务规则：草稿不对外显示、评论需审核后展示
🛒 电商系统
电商系统需求要点
- 用户角色：买家、管理员
- 商品管理：上架、下架、库存、分类、多图片
- 购物流程：加入购物车、下单、支付（模拟）
- 订单管理：订单状态流转、收货确认
- 用户中心：个人信息、收货地址、订单历史
- 业务规则：库存不足不能下单、30分钟未付款自动取消
📊 管理后台
管理后台需求要点
- 用户角色：管理员、普通员工
- 权限系统：角色权限、菜单权限
- 数据管理：CRUD 操作、批量操作、导入导出
- 数据展示：表格、图表、统计面板
- 系统设置：参数配置、操作日志
- 业务规则：员工只能看自己负责的数据
📋 任务管理系统
任务管理系统需求要点
- 用户角色：管理员、普通用户
- 任务管理：创建、编辑、删除、标记完成
- 任务属性：标题、描述、截止日期、优先级、标签
- 视图展示：列表视图、看板视图
- 筛选排序：按状态、优先级、日期筛选
- 业务规则：逾期任务高亮显示、完成的任务可恢复
下一步
准备好了？
认真写好需求描述后，就可以开始创建你的第一个项目了！记住：**花在需求上的时间，会在生成质量上得到回报。**