测试用例生成技能（完整版）#

核心功能#

根据用户提供的需求描述或需求文档，自动生成专业、全面的测试用例。

支持的输入方式#

1. 直接文本描述 - 输入需求文字
2. 上传文档 - 支持 .txt / .docx / .pdf

内置高级功能#

功能说明脚本🔍 依赖检测自动检测并提示安装依赖check_dependencies.py📤 多格式导出CSV/Markdown/JSON/XMind/TestLinkexport_testcases.py📊 质量评分5 维度评估用例质量quality_score.py📋 测试数据生成自动生成配套测试数据generate_testdata.py🔎 用例评审去重检测、批量修改review_testcases.py🔄 增量更新需求变更对比分析diff_requirements.py⚙️ 配置管理查看/修改技能配置config_manager.py

快速开始#

1. 检查依赖#

bash

python scripts/check_dependencies.py

2. 生成测试用例#

提供需求描述，技能自动生成用例。

3. 导出用例#

bash

# 导出为 Markdown
python scripts/export_testcases.py markdown output.md < testcases.json

# 导出为 XMind
python scripts/export_testcases.py xmind output.xmind < testcases.json

# 导出为 TestLink
python scripts/export_testcases.py testlink output.xml < testcases.json

4. 质量评估#

bash

python scripts/quality_score.py testcases.json

5. 生成测试数据#

bash

python scripts/generate_testdata.py testcases.json testdata.json

使用示例#

示例 1：基本用法#

text

请帮我生成测试用例：

【需求描述】
用户登录功能：支持邮箱/手机号登录，密码长度 8-20 位...

示例 2：指定高级提示词#

text

请帮我生成测试用例：

【需求描述】
[需求内容]

【特殊要求】
- 提示词配置：advanced-prompt
- 格式：CSV

示例 3：上传文档#

text

请帮我从这个文档生成测试用例：
[上传：requirements.docx]

脚本工具说明#

check_dependencies.py - 依赖检测#

bash

# 检查依赖
python scripts/check_dependencies.py

# 输出：
# ✅ openpyxl - Excel 导出
# ❌ python-docx - Word 文档解析
# ⚠️  检测到缺失的依赖，请运行：pip install python-docx

export_testcases.py - 多格式导出#

bash

# 导出为 Markdown
python scripts/export_testcases.py markdown output.md < testcases.json

# 导出为 XMind（思维导图）
python scripts/export_testcases.py xmind output.xmind < testcases.json

# 导出为 JSON
python scripts/export_testcases.py json output.json < testcases.json

# 导出为 TestLink XML
python scripts/export_testcases.py testlink output.xml < testcases.json

quality_score.py - 质量评分#

bash

# 评估用例质量
python scripts/quality_score.py testcases.json

# 输出：
# 📊 覆盖率：   95.0/100
# ✅ 可执行性： 88.0/100
# 🔗 独立性：   92.0/100
# 📝 可维护性： 90.0/100
# 📋 完备性：   85.0/100
# 🎯 综合评分：90.0/100 - A (良好)

generate_testdata.py - 测试数据生成#

bash

# 生成 JSON 格式测试数据
python scripts/generate_testdata.py testcases.json testdata.json

# 生成 CSV 格式测试数据
python scripts/generate_testdata.py testcases.json testdata.csv csv

review_testcases.py - 用例评审#

bash

# 显示统计信息
python scripts/review_testcases.py testcases.json stats

# 检测相似用例
python scripts/review_testcases.py testcases.json duplicates

# 批量修改优先级
python scripts/review_testcases.py testcases.json update-priority 功能测试 P1

# 按优先级筛选
python scripts/review_testcases.py testcases.json filter-priority P0

diff_requirements.py - 增量更新#

bash

# 对比需求变更
python scripts/diff_requirements.py old_req.txt new_req.txt testcases.json

# 输出增量更新计划

config_manager.py - 配置管理#

bash

# 查看配置
python scripts/config_manager.py view

# 修改配置
python scripts/config_manager.py set default_format markdown

# 重置配置
python scripts/config_manager.py reset

导出格式说明#

格式适用场景工具支持CSVExcel 导入、测试管理工具✅Markdown文档、Git 仓库✅JSONAPI 集成、自动化测试✅XMind思维导图、评审展示✅TestLink XMLTestLink 导入✅

质量评分维度#

维度权重说明覆盖率20%需求点覆盖百分比可执行性20%步骤清晰度、可重复性独立性20%用例间依赖程度可维护性20%命名规范、结构清晰完备性20%测试类型分布

配置项说明#

json

{
  "default_prompt": "default-prompt",        // 默认提示词
  "default_format": "csv",                   // 默认导出格式
  "default_priority_rules": {...},           // 优先级规则
  "required_fields": [...],                  // 必填字段
  "min_cases_per_feature": 3,                // 每功能点最少用例数
  "enable_quality_check": true,              // 启用质量检查
  "auto_generate_testdata": true             // 自动生成测试数据
}

最佳实践#

1. 生成前检查依赖#

bash

python scripts/check_dependencies.py

2. 生成后评估质量#

bash

python scripts/quality_score.py testcases.json

3. 根据评分改进#

• 覆盖率<80：增加用例数量
• 可执行性<80：优化步骤描述
• 独立性<80：减少用例依赖
• 完备性<80：补充测试类型

4. 导出合适格式#

• 团队评审 → XMind
• 导入工具 → CSV/TestLink
• 文档归档 → Markdown
• 自动化 → JSON

文件结构#

text

test-case-generator/
├── SKILL.md                          # 技能说明
├── config.json                       # 配置文件
├── scripts/
│   ├── check_dependencies.py         # 依赖检测
│   ├── export_testcases.py           # 多格式导出
│   ├── quality_score.py              # 质量评分
│   ├── generate_testdata.py          # 测试数据生成
│   ├── review_testcases.py           # 用例评审
│   ├── diff_requirements.py          # 增量更新
│   └── config_manager.py             # 配置管理
└── references/
    ├── default-prompt.md             # 默认提示词
    ├── advanced-prompt.md            # 高级提示词
    ├── prompt-templates.md           # 提示词模板
    └── format-examples.md            # 格式示例

故障排查#

问题 1：依赖缺失#

text

❌ python-docx - Word 文档解析

解决： pip install python-docx pdfplumber openpyxl

问题 2：质量评分低#

解决：查看评分报告，按建议改进用例

问题 3：导出的中文乱码#

解决：使用 UTF-8 编码打开文件

版本信息#

• 版本：2.0（完整版）
• 更新：新增 8 项高级功能
• 兼容：Python 3.7+