这个需求包解决什么它不是报价表,也不是泛泛的沟通清单。它用来判断一个项目能不能进入开发:事实是否够、风险是否清楚、首版是否能验收、后续 AI 能不能接手。拿到真实需求后,先按下面字段补齐,再用 AI 需求文档生成器整理成任务包。生成任务包相关服务交付体系
必填信息服务器信息:云厂商、系统版本、CPU、内存、磁盘、地域和登录方式。应用信息:仓库、分支、运行时、构建命令、启动命令、端口和健康检查。服务入口:主站、API、后台、文件服务、定时任务、监控和静态资源。域名和证书:DNS、备案、HTTPS、证书续期、Nginx/Caddy 配置。数据服务:MySQL、Redis、对象存储、备份频率、恢复方式和迁移需求。安全边界:防火墙、SSH、数据库端口、环境变量、密钥和最小权限。日志监控:访问日志、应用日志、错误日志、磁盘空间和告警方式。回滚要求:允许停机时间、旧版本路径、数据库回滚和发布窗口。
可选补充现有部署脚本、Dockerfile、systemd、PM2、Nginx 配置和历史报错。云厂商控制台截图、DNS 控制台截图和证书状态。客户侧账号权限边界:哪些操作 AI 能做,哪些必须客户手动做。成本限制、监控要求、备份保留周期和合规要求。
风险检查没有备份就做数据库迁移或覆盖部署,风险最高。数据库、Redis 和后台端口不能直接暴露公网。密钥不能进入仓库或聊天记录中的公开内容。只记录部署成功,不记录回滚命令,下次出问题很难接手。客户侧服务器权限不足时,必须明确由谁执行控制台操作。
可开工标准运行时、端口、环境变量和启动命令已经明确。域名、HTTPS、反向代理和防火墙策略已经确定。数据库备份和恢复方式已经写清楚。日志路径、健康检查和重启方式可以被下一个 AI 复现。回滚命令和生产验证 URL 已经列入任务包。
交接产物服务器清单、应用目录、运行时版本和启动命令。环境变量名、Nginx 配置路径、证书状态和开放端口。数据库备份路径、恢复命令和迁移记录。日志路径、健康检查 URL、监控方式和故障排查步骤。上线验证结果、回滚命令和客户侧待办。
交给 AI 前要确认首版范围和暂不做范围已经分开。验收标准能写成具体动作和可观察结果。部署环境、账号权限、域名状态和缺失资料已经说明。敏感信息不会进入公开仓库、公开页面或可泄露文档。下一位 AI 能通过 HANDOFF、任务包和内部文档继续工作。