testcase-generator

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生成登录模块测试用例：

1. 解析PRD内容，识别登录模块功能需求
2. 生成功能测试用例（正向为主）
3. 调用 scripts/write_excel_from_json.py 输出 Excel 文件
4. 输出：登录模块测试用例.xlsx

---

注意事项

1. 文档质量：输入文档越完整，生成用例越准确
2. 人工评审：生成后建议人工评审业务细节
3. 字段限制：如有字段限制文档请一并提供
4. 用例筛选：用触发词精准控制用例类型