req-to-testcase（要求测试用例）

需求文档 → 全面测试用例 → XMind 技能

技能概览

本技能完成以下完整工作流：

上传需求文档
     ↓
解析并拆解需求点（识别功能点、业务规则、约束条件）
     ↓
多维度生成测试用例（5大测试类型，全面覆盖）
     ↓
导出 XMind .xmind 文件（可直接打开）

快速决策

第一步：读取需求文档

使用 scripts/read_requirement_file.py 统一读取所有支持格式的需求文档，无需手动判断文件类型。

执行步骤：

# 1. 确认上传的文件名
ls /mnt/user-data/uploads/

# 2. 调用读取脚本（自动识别格式并提取文本）
python scripts/read_requirement_file.py /mnt/user-data/uploads/<文件名>

脚本支持的格式：

脚本位于 scripts/read_requirement_file.py，将提取的纯文本输出到 stdout，直接作为第二步的需求拆解输入。

若脚本报告缺少依赖，按提示执行 pip install <包名> --break-system-packages 后重试。

第二步：拆解需求点

将原始需求文本结构化，识别以下要素：

需求ID  | 模块    | 功能描述           | 业务规则 / 约束                  | 优先级
--------|---------|-------------------|----------------------------------|-------
REQ-001 | 用户注册 | 用户填写信息完成注册 | 邮箱唯一、密码>=8位、手机号格式验证 | P0
REQ-002 | 商品搜索 | 按关键词搜索商品    | 支持模糊匹配、结果按销量排序        | P1

拆解规则：

1. 每个独立功能点单独成一条需求
2. 显式的业务规则（格式、范围、唯一性等）逐一记录
3. 隐式约束（空值处理、并发、超时等）要主动推断补充
4. 识别数据流：输入→处理→输出，每个环节都是测试点

第三步：多维度生成测试用例

必须覆盖的 5 大测试类型（详细策略见 references/test-coverage.md）：

① 正向功能测试

验证功能在正常输入下按预期运行。

• 典型场景：主流程走通
• 关键点：按需求描述一一验证，不遗漏任何功能点

② 逆向 / 异常测试

验证系统对错误输入、异常状态的处理。

• 空值、null、缺失必填项
• 错误格式（邮箱不含@、手机号含字母等）
• 非法操作（重复提交、越界操作等）

③ 边界值测试

在输入范围的边界处验证行为。

• 最小值、最小值-1、最大值、最大值+1
• 字符串：空串、1字符、最大长度、最大长度+1
• 数值：0、负数、小数、整数边界
• 日期：最早日期、最晚日期、跨年/跨月

④ 业务规则测试

验证需求中明确或隐含的业务逻辑。

• 唯一性约束（重复注册、重复提交）
• 状态机流转（订单状态只能正向流转）
• 计算逻辑（金额、折扣、积分计算）
• 关联规则（A 操作触发 B 变化）

⑤ 用户体验测试

• 操作反馈：加载中、成功/失败提示是否清晰

• 错误引导：提示语是否明确告知如何修正
• 流程连贯性：完成操作后跳转是否合理

用例格式标准

每条用例输出以下字段：

优先级标准：

• P0（冒烟）：核心主流程，每次发版必跑（约 10-15%）
• P1（高优）：主要功能路径，重要业务规则（约 30-40%）
• P2（一般）：边界值、异常处理、次要功能（约 35-45%）
• P3（低优）：兼容性细节、UI 美观、体验优化（约 5-10%）

用例数量参考

第四步：导出 XMind

使用 scripts/xmind_tools2.py 将测试用例列表生成兼容 XMind8 与 XMind2020 的 .xmind 文件。

执行步骤：

# 1. 安装依赖（首次使用）
pip install xmind --break-system-packages

# 2. 调用生成脚本
python scripts/xmind_tools2.py

脚本接口：

脚本位于 scripts/xmind_tools2.py，返回生成文件的绝对路径。 生成完毕后使用 present_files 工具分享文件。

若脚本报告缺少依赖，按提示执行 pip install xmind --break-system-packages 后重试。

输出物清单

参考文档