❌ python-docx - Word 文档解析

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

核心功能

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

支持的输入方式

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

内置高级功能

功能	说明	脚本
🔍 依赖检测	自动检测并提示安装依赖	checkdependencies.py
📤 多格式导出

CSV/Markdown/JSON/XMind/TestLink | exporttestcases.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：基本用法

请帮我生成测试用例：

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

示例 2：指定高级提示词

请帮我生成测试用例：

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

【特殊要求】

• - 提示词配置：advanced-prompt
• 格式：CSV

示例 3：上传文档

请帮我从这个文档生成测试用例：
[上传：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/diffrequirements.py oldreq.txt new_req.txt testcases.json

输出增量更新计划

config_manager.py - 配置管理

bash

查看配置

python scripts/config_manager.py view

修改配置

python scripts/configmanager.py set defaultformat markdown

重置配置

python scripts/config_manager.py reset

导出格式说明

格式	适用场景	工具支持
CSV	Excel 导入、测试管理工具	✅
Markdown

文档、Git 仓库 | ✅ | | JSON | API 集成、自动化测试 | ✅ | | XMind | 思维导图、评审展示 | ✅ | | TestLink XML | TestLink 导入 | ✅ |

质量评分维度

维度	权重	说明
覆盖率	20%	需求点覆盖百分比
可执行性

20% | 步骤清晰度、可重复性 | | 独立性 | 20% | 用例间依赖程度 | | 可维护性 | 20% | 命名规范、结构清晰 | | 完备性 | 20% | 测试类型分布 |

配置项说明

json
{
default_prompt: default-prompt, // 默认提示词
default_format: csv, // 默认导出格式
defaultpriorityrules: {...}, // 优先级规则
required_fields: [...], // 必填字段
mincasesper_feature: 3, // 每功能点最少用例数
enablequalitycheck: true, // 启用质量检查
autogeneratetestdata: 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

文件结构

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：依赖缺失

❌ python-docx - Word 文档解析

解决：pip install python-docx pdfplumber openpyxl

问题 2：质量评分低

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

问题 3：导出的中文乱码

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

版本信息

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