【模板1:需求规格说明书】
适用场景:启动新项目,需要规范的需求文档框架模板内容:
你是一位资深技术文档专家。 请根据以下输入,生成〖需求规格说明书〗。 要求:结构清晰、语言简洁、使用表格和列表等格式。 输入信息:〖粘贴你的原始需求/要点〗 输出格式: 1、业务背景与目标 2、系统边界与范围 3、功能需求列表(按模块分组) 4、非功能需求(性能、安全性、可用性等) 5、验收标准(每个功能一条) 6、依赖与约束 🌰实例:输入“需要一个记加班的小程序,用户登录后可以打卡开始加班,结束时打卡,系统自动算加班时长和费用,管理员能导出报表。” → AI输出3个功能模块(用户管理、打卡记录、报表导出),8个功能点,还补了“响应时间<1秒”和“数据保存3年”的非功能需求。
【模板2:功能点拆分与优先级排序】
适用场景:拿到一堆需求后,拆分成可交付的功能点并按重要性排序
模板内容:
你是一位资深技术文档专家。
请根据以下输入,生成〖功能点拆分与优先级排序文档〗,
要求:
将需求拆解为独立可验证的功能点,
使用MoSCoW方法标注优先级(必须有/应该有/可以有/不会有),
每个功能点包含估算复杂度(高/中/低)和依赖关系。
输入信息:〖粘贴原始需求列表或用户故事〗 输出格式: 1、功能点清单表格(编号、名称、优先级、复杂度、前置依赖) 2、必须有(Must)的功能详述 3、应该有(Should)的功能详述 4、可以有(Could)的功能详述 5、本版本不会有(Won't)的明确列表 🌰实例:输入“要做考试系统:学生在线答题,自动判分,老师可以出题和查看成绩报告,最好有防作弊和题目难度分析。” → AI拆出11个功能点,标注“自动判分”为必须有,“防作弊”为应该有,“难度分析”为不会有。
【模板3:系统边界与功能列表】
适用场景:明确系统做什么、不做什么,防止需求蔓延
模板内容:
你是一位资深技术文档专家。
请根据以下输入,生成〖系统边界与功能列表〗,
要求:用表格区分“本系统负责”与“外部系统/人工完成”,功能列表分层级。
输入信息:〖粘贴业务范围描述〗 输出格式: 1、系统上下文图(文字描述) 2、边界说明表格 3、功能清单(L1模块 -> L2功能点) 4、不在范围内的典型场景 🌰实例:输入“电商优惠券系统,用户领券、下单抵扣、过期退回。” → AI输出边界表格:本系统负责生成券码、校验有效期、扣减库存;外部系统负责支付、发货;人工负责异常退款审核。并列出“不包含创建优惠券规则界面(由运营后台提供)”等3条不在范围项。
【模板4:非功能需求规格】
适用场景:需要量化性能、安全、可用性等非功能要求
模板内容:
你是一位资深技术文档专家。
请根据以下输入,生成〖非功能需求规格〗,
要求:每项需求可测量、可测试,使用表格列出指标与阈值。
输入信息:〖粘贴系统类型和预期负载、安全等级等〗 输出格式: 1、性能需求(响应时间、吞吐量、并发数) 2、可靠性(MTBF、故障恢复时间) 3、安全性(认证、权限、数据加密) 4、可维护性 5、各指标的测试验证方法 🌰实例:输入“一个面向内部员工的考勤系统,预计500人同时打卡,需要支持手机端和电脑端。” → AI输出:响应时间<2秒(95%请求),并发支持600人,故障恢复<30分钟,密码需加密存储且每90天强制更换。还给出了压测建议。
【模板5:架构设计与模块划分】
适用场景:从需求过渡到顶层设计,拆分模块并定义关系
模板内容:
你是一位资深技术文档专家。
请根据以下输入,生成〖架构设计与模块划分文档〗,
要求:使用文字版模块图(层次缩进),描述模块职责和依赖关系。
输入信息:〖粘贴功能列表和关键约束〗 输出格式: 1.整体架构(分层/微服务/事件驱动等风格说明) 2.模块清单(名称、职责、对外提供接口) 3.模块间依赖矩阵(表格) 4.数据流向说明(可选) 5.技术选型原则(不指定具体产品,只列判断标准) 🌰实例:输入“一个在线会议室预订系统,功能包括用户登录、查看会议室空闲时段、提交预订申请、管理员审批、系统发送通知。” → AI输出三层架构(展示层-业务层-数据层),拆出5个模块:用户模块、会议室模块、预订模块、审批模块、通知模块,并画出依赖矩阵(通知模块依赖预订模块,预订模块依赖用户和会议室模块)。
【模板6:接口设计规范】
适用场景:定义模块间或前后端的调用接口
模板内容:
你是一位资深技术文档专家。
请根据以下输入,生成〖接口设计文档〗,
要求:每个接口包含名称、请求参数(字段/类型/必填/说明)、响应结构、错误码,使用表格。
输入信息:〖粘贴接口功能描述或原始格式〗 输出格式: 1.接口列表概览 2.接口详情(正常流程示例) 3.异常返回说明 4.调用时序(文本描述) 🌰实例:输入“用户登录接口,传用户名密码,成功返回token和过期时间,失败返回错误原因。” → AI输出请求参数表格(用户名/字符串/必填,密码/字符串/必填),响应结构(成功码200,返回token和expires_in),错误码(401用户名密码错,429尝试次数过多等5种)。
【模板7:数据结构与算法流程】
适用场景:设计核心数据实体和复杂业务的处理逻辑模板内容:
你是一位资深技术文档专家。 请根据以下输入,生成〖数据结构与算法流程设计〗, 要求:数据实体用表格(字段/类型/约束), 算法流程用步骤化伪代码, 标注输入输出和边界条件。 输入信息:〖粘贴业务规则和数据项描述〗 输出格式: 1.实体关系说明 2.关键数据结构表格 3.主要算法伪代码(正常路径 + 异常处理) 4.复杂度分析(时间/空间,可选)
🌰实例:输入“订单状态流转:新建→已支付→已发货→已完成,可取消(仅限新建和已支付状态),取消后回到关闭状态。” → AI输出orders表的字段(id, status, created_at等),伪代码包含check_cancel()判断条件,并列举了边界情况:重复取消、发货后尝试取消应拒绝。
你是一位资深技术文档专家。 请根据以下输入,生成〖数据结构与算法流程设计〗, 要求:数据实体用表格(字段/类型/约束), 算法流程用步骤化伪代码, 标注输入输出和边界条件。 输入信息:〖粘贴业务规则和数据项描述〗 输出格式: 1.实体关系说明 2.关键数据结构表格 3.主要算法伪代码(正常路径 + 异常处理) 4.复杂度分析(时间/空间,可选) 【模板8:伪代码与详细流程】
适用场景:需要给开发人员或测试人员清晰的实现步骤模板内容:
你是一位资深技术文档专家。 请根据以下输入,生成〖详细流程伪代码〗, 要求:类自然语言但带控制结构(if-else、循环、异常),每个步骤标注前置后置条件。 输入信息:〖粘贴某个功能的输入输出和业务规则〗 输出格式: 1.函数/方法名称与描述 2.输入参数表 3.伪代码(缩进对齐) 4.主要异常及处理方式 5.后置结果说明
🌰实例:输入“忘记密码功能:用户输入邮箱,系统生成6位验证码发送到邮箱,用户输入验证码和新密码,校验通过后更新密码。” → AI输出伪代码:function resetPassword(email, code, newPwd) → 前置条件:邮箱已注册且未锁定 → 步骤:检查邮箱存在性→验证码是否匹配且未过期→校验新密码复杂度→更新数据库→记录日志 → 异常:邮箱不存在返回404,验证码错误返回400,重试超过5次锁定账户。
你是一位资深技术文档专家。 请根据以下输入,生成〖详细流程伪代码〗, 要求:类自然语言但带控制结构(if-else、循环、异常),每个步骤标注前置后置条件。 输入信息:〖粘贴某个功能的输入输出和业务规则〗 输出格式: 1.函数/方法名称与描述 2.输入参数表 3.伪代码(缩进对齐) 4.主要异常及处理方式 5.后置结果说明 【模板9:单体测试用例设计】
适用场景:为单个函数或模块编写单元测试用例
模板内容:你是一位资深技术文档专家。
请根据以下输入,生成〖单体测试用例表〗,
要求:
覆盖正常场景、边界值、异常输入,
每个用例包含用例ID、场景描述、输入数据、预期输出、覆盖的边界条件。
输入信息:〖粘贴模块名称和功能描述〗 输出格式: 1.用例汇总表 2.正常流程用例 3.边界值用例(最小值、最大值、空值等) 4.异常流程用例(错误格式、超范围、依赖失败)
🌰实例:输入“函数功能:计算折扣价,原价price(正数,0-10000),折扣discount(0.5-0.9,步长0.05),返回price * discount,保留两位小数。” → AI输出用例:正常输入(100,0.8)→80.00,边界(0,0.5)→0.00,边界(10000,0.9)→9000.00,异常( -10,0.8)→报错,异常(100,1.2)→报错,异常(100,0.73)→应四舍五入或拒绝。
你是一位资深技术文档专家。
请根据以下输入,生成〖单体测试用例表〗,
要求:
覆盖正常场景、边界值、异常输入,
每个用例包含用例ID、场景描述、输入数据、预期输出、覆盖的边界条件。
输入信息:〖粘贴模块名称和功能描述〗 输出格式: 1.用例汇总表 2.正常流程用例 3.边界值用例(最小值、最大值、空值等) 4.异常流程用例(错误格式、超范围、依赖失败) 【模板10:测试数据设计】
适用场景:需要构造一批有代表性的测试数据
模板内容:你是一位资深技术文档专家。
请根据以下输入,生成〖测试数据设计文档〗,
要求:提供三组数据——典型有效数据、边界数据、无效异常数据,每组说明使用场景。
输入信息:〖粘贴数据结构或字段规则〗 输出格式: 1.有效等价类数据示例(2-3组) 2.边界值数据(上下限附近) 3.异常数据(类型错误、越界、空、特殊字符) 4.数据与用例的映射建议
🌰实例:输入“用户注册表单:用户名(4-20位字母数字下划线),密码(8-16位,含大小写数字),年龄(18-60整数)。” → AI输出有效数据(”john_123”,”Abc12345”,25),边界数据(”a”4,”a”20,年龄18和60),异常数据(”jo”,空字符串,密码全数字,年龄17或61,特殊符号如”<script>”)。
你是一位资深技术文档专家。
请根据以下输入,生成〖测试数据设计文档〗,
要求:提供三组数据——典型有效数据、边界数据、无效异常数据,每组说明使用场景。
输入信息:〖粘贴数据结构或字段规则〗 输出格式: 1.有效等价类数据示例(2-3组) 2.边界值数据(上下限附近) 3.异常数据(类型错误、越界、空、特殊字符) 4.数据与用例的映射建议 【模板11:集成测试与接口测试用例】
适用场景:测试模块间交互或系统间接口
模板内容:你是一位资深测试专家。
请根据以下输入,生成〖集成测试/接口测试用例集〗,
要求:每个用例包含调用顺序、输入参数、预期响应、
验证点(状态码、数据一致性),覆盖正常、异常和数据依赖场景。
输入信息:〖粘贴接口清单或模块依赖关系〗 输出格式: 1.测试场景列表(按端到端流程) 2.正常集成流程用例 3.异常集成(超时、依赖模块返回错误) 4.数据传递验证用例
🌰实例:输入“订单服务调用库存服务扣减库存,调用支付服务创建支付单。库存不足时订单创建失败。” → AI输出正常流程用例:创建订单→扣库存成功→创建支付单→返回订单号。异常用例:库存服务返回库存不足→订单状态为失败,不回滚支付(未调用)。超时场景:库存服务超时→订单超时失败,补偿日志。
你是一位资深测试专家。
请根据以下输入,生成〖集成测试/接口测试用例集〗,
要求:每个用例包含调用顺序、输入参数、预期响应、
验证点(状态码、数据一致性),覆盖正常、异常和数据依赖场景。
输入信息:〖粘贴接口清单或模块依赖关系〗 输出格式: 1.测试场景列表(按端到端流程) 2.正常集成流程用例 3.异常集成(超时、依赖模块返回错误) 4.数据传递验证用例 【模板12:用户手册与操作说明】
适用场景:编写最终用户看的操作指南
模板内容:你是一位技术文档专家。
请根据以下输入,生成〖用户手册〗,
要求:从用户视角,步骤清晰(使用序号),每个功能配目的、前置条件和操作步骤,另附FAQ。
输入信息:〖粘贴系统的主要功能点和常见问题〗 输出格式: 1.简介与安装配置(文字步骤) 2.登录与主界面布局 3.各功能操作步骤(截图位置用[截图]占位) 4.常见问题FAQ(3-5条) 5.故障排查简单指引
🌰实例:输入“文件上传功能:点击上传按钮选择文件,支持图片和pdf,最大10MB,上传后显示文件名和大小。” → AI输出操作手册:步骤1登录后进入工作区,步骤2点击“上传”按钮,步骤3从本地选择文件(仅显示图片和pdf),步骤4等待进度条完成,步骤5可看到文件列表。FAQ包含“上传失败怎么办(检查文件大小/格式)”和“能否批量上传(当前版本仅支持单个)”。
你是一位技术文档专家。
请根据以下输入,生成〖用户手册〗,
要求:从用户视角,步骤清晰(使用序号),每个功能配目的、前置条件和操作步骤,另附FAQ。
输入信息:〖粘贴系统的主要功能点和常见问题〗 输出格式: 1.简介与安装配置(文字步骤) 2.登录与主界面布局 3.各功能操作步骤(截图位置用[截图]占位) 4.常见问题FAQ(3-5条) 5.故障排查简单指引 💡 使用技巧
在【输入信息】里附带约束条件:比如“这份需求文档是给外包团队用的”或“用户手册面向非技术人员”,AI会自动调整语言风格和详细程度,减少二次修改。
要求AI补全边界和异常:在提示词末尾加上“请补充我可能遗漏的边界条件和异常场景”,你会发现AI能多列出3-5条你自己想不到的情况。
用已有模板生成同模式的其他文档:先让AI按【模板1】生成一份需求规格说明书,然后告诉它“请按照相同的章节结构和表格风格,为另一个功能生成文档”,AI会保持格式一致,省去手动调整的时间。
分步生成,避免一次输出太泛:比如写用户手册时,先让AI用【模板12】生成操作步骤,再单独问“针对第三步上传文件,列出3个用户常见问题和解决方案”,比一次生成更细致。
让AI扮演不同读者角色:在提示词开头加一句“假设你是一名刚入职的新人,第一次看这份设计文档”,AI会指出哪些术语没解释、哪些依赖关系不清晰,帮你发现文档的表述盲区。
对照模板做文档自检:把写完的文档喂给AI,然后问“对照【模板4】的结构,我这份非功能需求文档缺了哪些部分?”AI会帮你找出遗漏的章节,当自动化审稿人用。
📢 结尾引导
✅ 关注本公众号,后台回复 “模板” 获取完整合集索引(包括代码审查、Bug修复、性能优化等分类)。✅ 文章持续更新,欢迎收藏并分享给需要的队友。✅ 下一期预告:《程序员AI提示词模板:代码重构篇》
让 AI 真正成为你的结对编程伙伴。
夜雨聆风