测试用例

适用场景

1 需求评审后快速产出功能测试用例初稿

2 版本迭代中补充回归测试用例

3 接口文档解析后生成API测试用例

4 结合历史缺陷数据生成边界与异常用例

核心Prompt（安装配置用）

你是一个企业级测试用例生成Agent，服务于软件测试团队。你的任务是根据用户提供的需求描述、接口定义或用户故事，自动生成结构化、可执行的测试用例。

角色设定：你是一位资深测试架构师，熟悉等价类划分、边界值分析、场景法、错误推测法等测试设计方法，了解功能测试、接口测试、回归测试的落地要求。

任务描述：读取用户输入的需求内容，识别功能点、输入条件、业务规则和异常分支，输出完整测试用例集。

输出格式：每条用例包含以下字段：用例编号、用例标题、所属模块、优先级（P0/P1/P2）、前置条件、测试步骤、预期结果、用例类型（功能/边界/异常/兼容）。使用Markdown表格输出，表头固定为：用例编号 | 用例标题 | 所属模块 | 优先级 | 前置条件 | 测试步骤 | 预期结果 | 用例类型。

约束条件：1）不得编造需求中不存在的功能；2）需求描述模糊时，列出待确认问题而非自行假设；3）优先覆盖核心主流程，再补充边界与异常；4）每条用例步骤需可独立执行；5）默认输出不少于15条用例，需求较小时按实际功能点覆盖；6）用例标题需简洁明确，避免重复。

若用户提供接口定义，额外输出请求参数校验、状态码、超时与幂等性用例。

所需工具 / API对接

需对接需求管理平台（Jira/禅道）读取需求；对接测试管理平台（TestRail/Xray）写入用例；对接LLM API（OpenAI/通义/文心）作为生成引擎；可选对接Git获取接口文档、Confluence获取PRD。

安装部署步骤

11. 环境准备：确认服务器可访问LLM API与需求/测试平台，Python 3.9+，执行 python -V 验证。

22. 安装依赖：pip install requests openai jira pytest，并创建项目目录 mkdir testcase-agent && cd testcase-agent。

33. 配置参数：新建config.yaml，填写llm_api_key、llm_base_url、jira_url、jira_token、testrail_url、testrail_key、default_priority等。

44. 导入Prompt：将core_prompt写入prompts/testcase_prompt.txt，代码中读取该文件作为system message。

55. 连接工具API：编写jira_client.py与testrail_client.py，分别实现需求拉取与用例写入，运行 python jira_client.py --test 验证连通。

66. 测试验证：执行 python agent.py --req-id DEMO-101 --dry-run，检查输出用例条数与字段完整性。

77. 上线部署：使用Docker打包，docker build -t testcase-agent:v1 .，docker run -d --env-file .env testcase-agent:v1。

88. 监控与迭代：接入日志与告警，记录生成用例采纳率，每周根据测试团队反馈优化Prompt。

配置参数

参数名	说明	默认值
`llm_model`	使用的LLM模型名称	gpt-4o-mini
`max_cases`	单次生成最大用例数	50
`default_priority`	默认优先级	P1
`language`	输出语言	zh-CN
`include_api`	是否生成接口测试用例	true

效果示例

输入：需求DEMO-101“用户登录支持手机号+验证码，验证码5分钟有效，连续错误3次锁定10分钟”。输出：生成18条用例，含正常登录、验证码过期、错误3次锁定、手机号格式错误、空验证码等，表格字段完整，P0用例6条，边界与异常用例8条，并列出2条待确认问题（锁定是否按账号、验证码是否可复用）。测试团队直接导入TestRail使用。

常见问题

Q1：生成的用例可以直接用吗？
A1：可作为初稿，建议测试工程师评审后使用，核心流程用例准确率较高，异常场景需结合业务补充。
Q2：需求描述很模糊怎么办？
A2：Agent会输出待确认问题列表，不会自行编造，需先与产品确认后再生成。
Q3：支持接口测试用例吗？
A3：支持，提供接口文档或OpenAPI即可生成参数校验、状态码、超时与幂等性用例。
Q4：数据安全如何保障？
A4：建议私有化部署LLM或使用企业版API，需求数据不出内网，日志脱敏存储。
Q5：如何提升生成质量？
A5：持续补充历史缺陷与业务规则到Prompt，并建立用例采纳率指标进行迭代。

企业落地建议

建议先以小范围试点，选择1-2个迭代版本，由测试骨干评审生成用例质量。部署方式优先私有化或企业API，避免需求外泄。成本主要为LLM调用费与服务器，按50人测试团队估算，月度API成本约数百至数千元。注意建立人工评审环节，Agent定位为提效工具而非替代测试设计，同时将历史缺陷库纳入上下文可显著提升异常用例覆盖率。