| name | testcase-generator |
| description | 测试用例生成器 - 根据PRD文档自动生成功能测试用例。
**核心能力**：支持PRD输入(Word/Markdown/PDF)、只输出Excel格式、多类型覆盖(功能/边界/异常)、智能用例筛选(正向/反向)
**触发词**： - 生成类："生成测试用例"、"创建用例"、"输出测试用例" - 筛选类："只要正向"、"不要异常"、"只要功能测试"
|
测试用例生成器
快速参考
输出格式
只输出 Excel 格式（.xlsx 文件），直接生成测试用例Excel。
用例类型筛选
| 筛选词 | 效果 |
|---|
| "只要正向"、"正向用例" | 只生成正向测试用例 |
| "不要异常"、"不要反向" | 排除异常/反向用例 |
| "只要功能" | 只生成功能测试用例 |
输入类型识别
| 类型 | 支持格式 |
|---|
| PRD文档 | .docx, .md, .txt, .pdf |
| 设计图 | .png, .jpg (需配合文字描述) |
| 在线文档 | 任意可访问的URL |
核心功能
1. 智能输入解析
自动识别输入文档类型，提取功能需求。
2. 测试覆盖维度
| 类型 | 覆盖内容 |
|---|
| 正向测试 | 核心业务流程验证 |
| 反向测试 | 异常输入、错误处理 |
| 边界值测试 | 输入边界、条件边界 |
| 等价类划分 | 测试数据合理分组 |
| 场景测试 | 跨模块业务流程、多模块联动场景 |
| 权限测试 | 未授权访问、越权操作、角色权限验证 |
| 网络异常测试 | 断网、超时、弱网环境处理 |
| 并发测试 | 重复提交、并发抢购、数据竞争 |
3. 字段规范
标准字段：
| 字段 | 必填 | 说明 |
|---|
| 用例编号 | ✓ | TC_模块_序号，如 TC_LOGIN_001 |
| 所属模块 | ✓ | 用例所属模块 |
| 用例标题 | ✓ | 简洁描述测试点 |
| 用例类型 | ✓ | 功能测试/边界测试/异常测试 |
| 优先级 | ✓ | P0/P1/P2 |
| 前置条件 | ✓ | 执行前需满足的条件 |
| 测试步骤 | ✓ | 逐条操作描述 |
| 预期结果 | ✓ | 每步对应的预期行为 |
4. 优先级定义
| 优先级 | 占比 | 定义 |
|---|
| P0 | 10-25% | 核心功能、主流程 |
| P1 | 30-60% | 重要功能、主流场景 |
| P2 | 10-25% | 边缘功能、特殊场景 |
工作流程
1. 解析输入文档 → 识别文档类型
2. 提取功能需求 → 识别字段和规则
3. 生成测试用例 → 应用测试设计方法论
4. **确保覆盖完整** → 正向+异常+边界+权限+网络+并发
5. 输出Excel文件 → 直接生成xlsx格式
Excel输出流程
当用例数量较多时（>10个），使用文件方式避免超限：
1. 生成测试用例 JSON 数组
2. write_to_file() 保存到临时 JSON 文件（如 testcases.json）
3. execute_command() 调用脚本转换格式
调用脚本：
python scripts/write_excel_from_json.py --data testcases.json --output output.xlsx
JSON格式要求：
{
"testcases": [
{
"case_id": "TC_LOGIN_001",
"module": "登录模块",
"case_name": "用例标题",
"case_type": "功能测试",
"priority": "P0",
"precondition": "前置条件",
"test_steps": "测试步骤",
"expected_result": "预期结果",
"remark": "备注"
}
]
}
模板支持
模板文件
assets/ 目录预置了标准模板：
| 模板文件 | 用途 |
|---|
测试用例模板.xlsx | 标准功能测试用例 Excel 格式 |
template-config.json | 模板配置定义 |
使用方式
Excel 输出时使用 测试用例模板.xlsx 作为格式基准。
依赖库
确保本地 Python 环境已安装以下库：
| 库名 | 安装命令 |
|---|
openpyxl | pip install openpyxl |
python-docx | pip install python-docx |
pypdf | pip install pypdf |
markdown | pip install markdown |
执行脚本：
python scripts/write_excel_from_json.py --data testcases.json --output output.xlsx
参考文档
详细标准和方法论请参考：
| 文档 | 说明 |
|---|
references/testcase-standard.md | 功能测试用例标准 |
示例
示例1：PRD生成Excel
根据PRD生成登录模块测试用例：
- 解析PRD内容，识别登录模块功能需求
- 生成功能测试用例（正向为主）
- 调用
scripts/write_excel_from_json.py 输出 Excel 文件
- 输出：
登录模块测试用例.xlsx
注意事项
- 文档质量：输入文档越完整，生成用例越准确
- 人工评审：生成后建议人工评审业务细节
- 字段限制：如有字段限制文档请一并提供
- 用例筛选：用触发词精准控制用例类型
