这个需求包解决什么它不是报价表,也不是泛泛的沟通清单。它用来判断一个项目能不能进入开发:事实是否够、风险是否清楚、首版是否能验收、后续 AI 能不能接手。拿到真实需求后,先按下面字段补齐,再用 AI 需求文档生成器整理成任务包。生成任务包相关服务交付体系
必填信息调用端:小程序、网页、管理后台、第三方系统或定时任务。核心数据对象:用户、订单、商品、报名、文件、审核、配置、日志等。字段和状态:必填字段、唯一约束、枚举状态、状态流转和删除策略。接口范围:列表、详情、新增、修改、删除、上传、登录、导出、审核。权限模型:角色、菜单、按钮、数据隔离、管理员和普通用户边界。数据库和迁移:新建库、已有库、旧数据迁移、索引和备份。联调方式:Swagger、Postman、示例 JSON、测试账号和前端环境。部署环境:JDK、MySQL、Redis、Nginx、端口、日志、环境变量。
可选补充已有接口文档、数据库表结构、旧系统账号和错误日志。文件存储、短信、支付、地图、第三方 API、消息队列或对象存储资料。后台页面草图、导入导出模板和运营配置字段。性能预期:数据量、并发、导出规模、任务频率和保留周期。
风险检查没有权限边界时,后台接口容易泄露不该看的数据。没有数据模型就先写 Controller,后期会反复返工。已有库迁移前必须备份,不能直接改生产表。文件上传、导出和定时任务需要考虑大小、超时、路径和清理策略。只交付代码但不记录部署方式,会导致下一个 AI 无法接手。
可开工标准数据对象、接口范围、权限边界和部署环境已经明确。每个核心接口都有请求、响应、错误和权限说明。至少有一组正常数据和一组异常数据用于验收。数据库迁移和回滚策略已经写清楚。日志、健康检查和联调方式已经纳入交付范围。
交接产物API 清单、数据模型、错误码和权限说明。数据库脚本、迁移记录、备份位置和回滚说明。部署命令、环境变量名、端口、日志路径和健康检查地址。Postman/Swagger 入口、测试账号和联调样例。已测接口、未测风险和下一批接口计划。
交给 AI 前要确认首版范围和暂不做范围已经分开。验收标准能写成具体动作和可观察结果。部署环境、账号权限、域名状态和缺失资料已经说明。敏感信息不会进入公开仓库、公开页面或可泄露文档。下一位 AI 能通过 HANDOFF、任务包和内部文档继续工作。