Smithery is now a part of Arcade.dev! Read more in our announcement here
基于需求文档（xls/csv）生成专业游戏测试用例，支持完整用例和快速测试点两种模式。当用户提到"游戏测试"、"测试用例生成"、"需求转测试用例"、上传需求文档或原型时使用此技能。
将游戏需求文档（xls/csv/文本/图片）转换为标准化测试用例，支持两种生成模式：
输出格式：Markdown（可导入Xmind）或 Excel
询问用户选择模式：
请选择测试用例生成模式：
1. 完整模式 - 生成规范的测试用例集（含编号、前置条件、操作步骤、预期结果）
2. 快速模式 - 仅生成测试点列表（快速评审用）
默认：完整模式
支持的输入格式：
解析策略：
结构化文档（xls/csv）：
文本描述：
原型图片：
输出需求映射表：
| 需求ID | 需求描述 | 来源 | 测试点数量 | 备注 |
|--------|----------|------|-----------|------|
| REQ-001 | 用户登录 | 需求文档第3行 | 8 | 含第三方登录 |
1. 模块分类 按游戏功能模块组织：
2. 场景覆盖原则 每个功能点至少覆盖3种场景：
3. 用例结构（使用模板：templates/full-template.md）
## 用例编号：模块-功能编号-场景类型
**测试类型**：功能/性能/兼容性/安全
**优先级**：高/中/低
**前置条件**：
- 条件1
- 条件2
**操作步骤**：
1. 具体操作（精确到"点击XX按钮"）
2. 具体操作（精确到"输入XX内容"）
**预期结果**：
- 可量化的验证点
- 无歧义的判断标准
**异常分支**：
- 异常情况描述及预期处理
4. 用例编号规则
模块缩写-功能编号-场景类型LOG-001-N（登录模块-第1个功能-正常场景）5. 优先级定义
使用模板：templates/quick-template.md
输出结构：
# 模块名称
## 核心测试点
- [ ] 测试点描述（含验证标准）
- [ ] 测试点描述（含验证标准）
## 边界场景
- [ ] 测试点描述
- [ ] 测试点描述
## 异常场景
- [ ] 测试点描述
- [ ] 测试点描述
## 待确认项
- ❓ 模糊需求描述 → 推荐方案
必检项：
待确认项处理： 对模糊/冲突/缺失需求标注：
## 待确认项
### 问题1：登录方式未明确
**描述**：需求未说明是否支持第三方登录
**方案A**：仅支持账号密码登录
**方案B**：支持微信/QQ第三方登录
**推荐**：方案B（符合行业惯例）
**影响用例**：LOG-003、LOG-004
Markdown输出（默认）：
scripts/convert_to_xmind.py）Excel输出（可选）：
使用脚本：scripts/convert_to_excel.py
Excel表结构：
| 用例编号 | 模块 | 功能点 | 测试类型 | 优先级 | 前置条件 | 操作步骤 | 预期结果 | 异常分支 |
|---|
转换命令示例：
# 转换为Excel
python scripts/convert_to_excel.py output.md -o 测试用例集.xlsx
# 转换为Xmind格式
python scripts/convert_to_xmind.py output.md -o 测试用例.xmind
完整模式输出：
# [游戏名称] 测试用例集
**版本**：v1.0
**测试模块**：XXX模块
**生成时间**：2026-01-27
## 📋 需求映射表
[需求点 → 用例编号 → 覆盖场景]
## 📦 测试用例集
### 模块1：账号系统
#### 功能1.1：用户登录
##### 用例 LOG-001-N：正常登录流程
[完整用例内容]
##### 用例 LOG-001-B：边界测试 - 密码长度上限
[完整用例内容]
##### 用例 LOG-001-E：异常测试 - 网络中断
[完整用例内容]
## ❓ 待确认项
[问题描述 + 方案对比 + 推荐方案]
## 📊 统计信息
- 总用例数：XX
- 高优先级：XX
- 中优先级：XX
- 低优先级：XX
- 待确认项：XX
快速模式输出：
# [游戏名称] 测试点清单
**版本**：v1.0
**生成时间**：2026-01-27
## 模块1：账号系统
### 用户登录
- [ ] 正确账号密码登录成功，进入游戏主界面
- [ ] 错误密码提示"密码错误"，不允许登录
- [ ] 密码输入32位（上限）正常登录
- [ ] 网络断开提示"网络连接失败"
- [ ] 连续5次密码错误触发账号锁定
### 第三方登录
- [ ] 微信授权登录成功，自动绑定游戏账号
- [ ] 取消微信授权返回登录页，不创建账号
...
## ❓ 待确认项
- 登录方式是否包含手机验证码登录？
- 账号锁定时长未明确（建议30分钟）
识别标准：需求文档中不同章节描述矛盾 处理方式：
## ⚠️ 需求冲突
**冲突点**：用户等级上限
- 需求第3章描述：等级上限100级
- 原型图显示：等级上限150级
**协调方案**：
- 方案A：采用100级（文档为准）
- 方案B：采用150级（原型为准）
**推荐**：方案A，并补充说明：若后续版本提升上限，需修改UI显示范围
**临时处理**：生成两套边界测试用例（100级和150级）
当需求包含原型图时：
### UI测试点（基于原型图）
- [ ] "立即登录"按钮位于屏幕下方，蓝色背景白色文字
- [ ] 账号输入框显示提示文字"请输入账号"，字体灰色
- [ ] 密码输入框内容显示为圆点，支持明文/密文切换图标
- [ ] 忘记密码链接位于密码框右侧，字体12px蓝色
如需求涉及性能要求：
### 性能测试用例 PERF-001-N
**测试类型**：性能
**优先级**：高
**测试场景**：100人同时在线战斗
**性能指标**：
- 服务器响应时间 ≤ 200ms
- 客户端帧率 ≥ 30fps
- 内存占用 ≤ 512MB
**测试步骤**：
1. 启动性能监控工具
2. 模拟100个玩家同时进入战斗场景
3. 持续测试5分钟
4. 记录性能数据
**预期结果**：
- 所有指标均在阈值范围内
- 无崩溃、无卡顿
对于相似功能（如不同道具的使用逻辑），使用参数化：
### 用例模板：道具使用 ITEM-USE-N
**参数**：道具类型、使用效果、冷却时间
**测试数据**：
| 道具类型 | 使用效果 | 冷却时间 |
|---------|---------|---------|
| 生命药水 | 恢复50%HP | 30秒 |
| 魔法药水 | 恢复50%MP | 30秒 |
| 复活石 | 原地复活 | 无 |
对于可自动化的用例添加标签：
**自动化程度**：🤖 可自动化 / ⚠️ 半自动化 / 👤 纯手工
用例 LOG-001-N：正常登录流程 🤖
用例 COMBAT-005-N：战斗特效表现 👤
合格标准：
