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

技能概览#

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

text

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

---

快速决策#

用户输入执行动作上传文档 + 要生成测试用例读取文件 → 拆解需求 → 生成用例 → 输出 XMind只上传文档，未说目的主动询问：是否需要生成测试用例？已有需求列表（文字粘贴）直接进行需求拆解，跳过文件读取只要 XMind，不要表格直接输出 XMind，省略 Markdown 表格指定某些测试类型优先生成指定类型，其余按需补充

---

第一步：读取需求文档#

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

执行步骤：

bash

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

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

脚本支持的格式：

格式处理方式.txt / .md直接读取 UTF-8 文本.docxpython-docx 提取段落与表格.pdfpypdf 逐页提取文本.xlsx / .xlsm / .xlspandas 读取所有工作表.csvpandas 读取并格式化为文本表格

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

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

---

第二步：拆解需求点#

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

text

需求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 变化）

⑤ 用户体验测试#

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

• 错误引导：提示语是否明确告知如何修正

• 流程连贯性：完成操作后跳转是否合理

---

用例格式标准#

每条用例输出以下字段：

字段说明用例IDTP-序号，如 TP-001所属模块对应需求模块测试类型正向/逆向/边界/业务规则/兼容/性能/体验用例标题简洁描述"做什么-预期是什么"前置条件测试前系统需满足的状态测试步骤编号步骤，操作具体可执行测试数据具体输入值（边界值、特殊字符等）预期结果明确可验证的结果描述优先级P0/P1/P2/P3

优先级标准：

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

---

用例数量参考#

需求规模预期用例数单个表单/弹窗1530 条单个功能模块3080 条完整业务流程80200 条完整系统需求文档200500 条

---

第四步：导出 XMind#

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

执行步骤：

bash

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

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

脚本接口：

参数说明test_cases测试用例列表，字段含 module / type / title / priority / precondition / steps / expectedproject_name根节点名称，默认 "测试用例"``output_dir输出目录，默认 /mnt/user-data/outputs

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

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

---

输出物清单#

输出物格式说明需求拆解表Markdown 表格（内联展示）展示在对话中测试用例集Markdown 表格（内联展示）展示在对话中XMind 文件.xmind 文件（可下载）用 present_files 分享

---

参考文档#

文档路径何时读测试覆盖策略详解references/test-coverage.md需要某类测试的详细设计方法时