| name | testcase-review |
| description | 测试用例评审工具 - 对比现有测试用例与需求文档，找出用例缺失或需要补充的地方。核心能力：支持Excel格式用例与Word/PDF/PRD/图片格式需求文档的比对分析，智能识别功能覆盖缺口，输出用例补充建议。触发场景：评审用例、用例补充、对比需求、检查用例完整性、需求覆盖分析、补充测试点、缺漏用例 |
测试用例评审
快速参考
输入文件识别
| 文件类型 | 说明 |
|---|
| 测试用例 | .xlsx Excel文件，第一行应为表头 |
| 需求文档 | .docx (Word), .pdf, .md, .txt, 图片(.png/.jpg) |
输出内容
| 输出类型 | 说明 |
|---|
| 缺失用例 | 需求中有但用例中未覆盖的功能点 |
| 补充建议 | 按模块/优先级分类的用例补充清单 |
| 覆盖率报告 | 各模块用例覆盖率百分比统计 |
核心功能
1. 文档解析
Excel用例解析：
- 读取Excel文件，自动识别表头行
- 提取字段：用例编号、所属模块、用例标题、测试步骤、预期结果
- 识别模块分组和优先级分布
需求文档解析：
- Word (.docx)：提取文本段落和表格内容
- PDF (.pdf)：提取文本内容（使用PyMuPDF）
- Markdown (.md)：直接解析标题层级和列表项
- 图片 (.png/.jpg)：使用AI视觉理解提取功能描述
2. 比对分析
覆盖率计算：
模块覆盖率 = (用例中已覆盖的功能点数 / 需求中该模块总功能点数) × 100%
缺口识别：
- 需求中有明确功能描述，但用例中无对应测试点
- 用例中测试步骤与需求描述不一致
- 缺少异常场景或边界条件测试
3. 输出报告
评审报告结构：
## 用例评审报告
### 覆盖率概览
| 模块 | 需求功能点数 | 已有用例数 | 覆盖率 |
|-----|-------------|-----------|--------|
### 缺失用例清单
#### [模块名称]
1. **[功能点]** - 缺失原因说明
- 建议用例类型：功能测试/边界测试/异常测试
- 建议优先级：P0/P1/P2
### 补充建议
...
工作流程
1. 收集文件 → 确认用例文件和需求文档路径
2. 解析用例 → 提取Excel中的模块、用例标题、测试步骤
3. 解析需求 → 提取需求文档中的功能点
4. 比对分析 → 匹配功能点与用例，识别缺口
5. 生成报告 → 输出结构化评审报告
触发方式
完整评审（推荐）
用户：请评审现有测试用例与需求文档的覆盖情况
→ 同时加载用例Excel和需求文档
→ 全量比对分析
→ 输出完整评审报告
专项评审
用户：只检查登录模块的用例覆盖
→ 筛选登录相关用例
→ 提取登录模块需求
→ 针对性分析
单文件评审
用户：检查这个PRD还缺什么用例
→ 只加载需求文档
→ 根据需求内容生成建议补充的用例清单
脚本支持
scripts/read_excel.py
读取Excel测试用例，提取结构化数据：
python scripts/read_excel.py excel文件路径
输出JSON格式：
{
"modules": ["登录", "注册", "首页"],
"testcases": [
{
"case_id": "TC_001",
"module": "登录",
"title": "正确账号密码登录成功",
"type": "功能测试",
"priority": "P0",
"steps": "...",
"expected": "..."
}
]
}
scripts/read_docx.py
读取Word需求文档：
python scripts/read_docx.py docx文件路径
scripts/read_pdf.py
读取PDF需求文档：
python scripts/read_pdf.py pdf文件路径
参考文档
详细评审方法论请参考：
| 文档 | 说明 |
|---|
references/testcase-review-methodology.md | 测试用例评审标准与方法论 |
references/coverage-analysis.md | 覆盖率分析与缺口识别指南 |
示例
示例1：完整评审流程
用户：帮我对比评审一下现有用例和需求文档
AI：请提供以下文件路径：
- 测试用例Excel文件路径
- 需求文档路径（支持.docx/.pdf/.md/图片）
用户：用例是 登录模块测试用例.xlsx，需求是 需求文档.docx
AI：
1. 解析Excel用例 → 提取模块：登录、注册、设备列表、首页
2. 解析Word需求 → 提取功能模块及详细功能点
3. 比对分析 → 登录模块覆盖率85%，缺失边界测试2条
4. 输出评审报告
示例2：专项评审
用户：只检查首页模块的用例完整性
AI：
1. 筛选首页相关用例
2. 提取首页需求功能点
3. 针对性分析覆盖率
4. 输出首页专项评审报告
注意事项
- 文件完整性：确保用例Excel第一行是表头，需求文档包含完整功能描述
- 模块对应：用例中的"所属模块"需与需求文档模块结构对应
- 阈值设置：覆盖率低于70%的模块建议重点补充
- 优先级参考：P0用例必须覆盖核心主流程
