Gemini测试用例清单提示词融入真实场景实战指南

Gemini生成的测试用例需绑定具体角色、时间、交付物及真实接口与设计资源，采用用户异常流、后台数据边界、跨角色协同三类操作链，并强制包含可观察失败信号和标准化Markdown表格格式。

说实话，用Gemini生成测试用例时，最头疼的就是输出像教科书一样规整但毫无上下文——“验证用户登录功能”“检查密码长度是否为6–20位”……开发拿到手里还得自己琢磨业务场景，等于白干。问题出在哪？提示词里没有钉入真实的交付场景。只要把角色、时间、交付物、接口和设计资源一股脑塞进去，Gemini输出的东西立马就能落地。

让Gemini生成的测试用例一眼就能看出是为谁、在哪、解决什么问题而写的

你需要用Gemini生成测试用例清单，但当前输出全是“验证用户登录功能”“检查密码长度是否为6–20位”这类教科书式条目，没有业务上下文、没有角色动作、没有环境约束，开发拿到后还得二次翻译才能写代码。必须把真实交付场景钉进提示词里，否则它永远在抽象层打转。

第一步：锁定具体角色+正在做的具体事

在提示词开头直接写明：“你是一位刚接手‘智能错题本’SaaS产品V2.3版本迭代的QA工程师，本周三下午要向研发团队提交‘学情分析卡片导出’模块的冒烟测试清单。”

这句不是可有可无的铺垫——【若不绑定具体人、具体时间、具体交付物，Gemini会默认按通用Web系统逻辑生成用例，比如出现‘兼容IE11’这种已下线的浏览器】。

紧接着补一句硬约束：“所有用例必须基于该模块真实上线接口文档（路径：/api/v2/student/analytics/export）和前端Figma组件库（ID: F-EDU-ANALYTICS-CARD-EXPORT-2026Q2）。”

第二步：用真实操作链替代功能点罗列

不要写“验证导出按钮是否可用”，要写成以下三类真实操作链：

方法一：用户端异常流还原
“学生点击‘周复习卡→导出PDF’按钮后，网络突然中断（模拟弱网），观察前端是否显示‘导出失败，请重试’toast且按钮恢复可点击状态。”

方法二：后台数据边界触发
“在Notion测试数据库中将学生当周错题数设为9999题→触发后端限流阈值→调用/api/v2/student/analytics/export?format=pdf&week=2026W24→确认返回HTTP 429及Retry-After头。”

方法三：跨角色协同断点
“班主任在PC端导出班级TOP10错题汇总PDF → 同步到企业微信工作台 → 教务主任在iOS企业微信中打开该文件 → 检查是否保留原始红笔批注图层（非图片嵌入）。”

第三步：强制加入可验证的失败信号

每个用例末尾必须附带一条“失败时你肉眼可见的异常表现”，例如：

① “失败信号：PDF第一页空白，且控制台报错‘TypeError: Cannot read property ‘render’ of undefined’”；

② “失败信号：企业微信内打开后显示‘文件损坏’，但同一PDF在Chrome中可正常查看”；

③ “失败信号：导出耗时超过8秒，Sentry未捕获错误，但Prometheus中http_request_duration_seconds_bucket{le="8"}占比骤降至21%”。

这一步不能省——【没有失败信号的用例等于没写，开发无法快速判断是环境问题还是代码缺陷】。

第四步：嵌入真实协作痕迹与交付格式

在提示词中明确要求：“输出为Markdown表格，共5列：用例编号｜前置条件（引用Notion模板ID: NT-EDU-TEST-2026Q2）｜执行步骤（含curl命令示例）｜预期结果（精确到DOM节点class名或API字段名）｜失败信号（见上一步）。”

示例行必须包含真实终端行为：
“TC-ANL-07｜已在Notion模板中配置学生ID=stu_882731｜curl -H 'X-Auth: test-token' 'https://api.edu.ai/v2/student/analytics/export?format=xlsx&student_id=stu_882731'｜响应body含sheet_name='薄弱知识点分布'且cell A1='数学-函数-单调性'｜失败信号：Excel打开后sheet_name显示为'Sheet1'”。