# Test Case Xmind

> 根据产品需求文档、前端技术文档、后端技术文档、交互稿、接口说明、截图和相关项目资料生成结构化软件测试用例；校验用例格式；按“用例标题/前置条件/步骤/预期结果”模板导出 .xmind 脑图文件。适用于生成 QA 测试用例、验收用例、功能用例、回归用例、边界用例，或根据一个或多个输入文档生成 XMind 测试用例脑图。

- Skill: `xiaoce-xiaoce/test-case-xmind` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add xiaoce-xiaoce/test-case-xmind`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiaoce-xiaoce/test-case-xmind/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xiaoce-xiaoce (https://skillmd.com/u/xiaoce-xiaoce)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xiaoce-xiaoce/test-case-xmind

---


# 测试用例 XMind

## 概览

使用本 skill 将产品和技术资料转换成结构化测试用例，并导出 `.xmind` 文件。

用户的真实使用方式是：提供一个或多个输入文档，然后要求 Codex 使用本 skill 生成测试用例。不要要求用户手动运行脚本，除非用户正在调试或维护这个 skill。Codex 应该在生成结构化用例后自动调用脚本完成校验和导出。

用例必须包含：

- 用例标题
- 前置条件
- 步骤
- 每个步骤对应的预期结果

一条用例只有一个前置条件组，可以包含多个步骤。每个步骤必须且只能对应一个预期结果。

## 工作流程

1. 收集用户提供的源文档，检查所有会影响行为、数据、页面状态、权限、接口、校验、异常处理或边界场景的输入。
2. 在编写结构化用例 JSON 前，阅读 `references/case_schema.md`。
3. 在决定覆盖范围前，阅读 `references/coverage_rules.md`。
4. 根据 schema 生成结构化 `cases.json`。
5. 运行 `scripts/validate_cases.py` 校验 JSON，并修复所有错误。
6. 运行 `scripts/export_xmind.py` 生成 `.xmind` 文件。
7. 生成 `.xmind` 后结束操作。不要再生成 HTML 预览页，也不要尝试自动打开浏览器。

`.xmind` 文件是主要交付物。

## 输入文档分析

当用户提供多个源文档时，要交叉分析它们，而不是分别做摘要：

- 需求文档用于识别用户价值、业务规则和验收标准。
- 前端技术文档用于识别页面状态、路由、前端校验、浏览器约束和可见行为。
- 后端技术文档用于识别接口契约、持久化规则、权限、异步任务、幂等性和失败模式。
- 交互稿/原型用于识别页面流转、组件状态、文案、错误展示位置、空状态、加载态和禁用态。

如果文档之间存在冲突，优先在用例备注或假设中记录你的判断。只有当冲突会阻碍继续生成有价值的用例时，才向用户提问。

## 覆盖要求

生成可执行、可评审的测试用例。优先保证有意义的覆盖，而不是堆砌大量重复用例。

需要覆盖：

- 核心成功路径
- 必填项和校验失败
- 边界值
- 空状态、加载态和错误态
- 不同权限和角色差异
- 接口失败，以及可重试/不可重试错误
- 前后端数据一致性
- 如果源文档提到兼容性或响应式要求，也要覆盖相关场景

## 结构化输出

导出前先将用例保存为 JSON。最小示例：

```json
{
  "title": "登录功能测试用例",
  "modules": [
    {
      "name": "登录",
      "cases": [
        {
          "title": "使用有效账号和密码登录成功",
          "precondition": "已存在一个注册用户，且用户已打开登录页面。",
          "steps": [
            {
              "action": "输入有效账号和密码，并提交登录表单。",
              "expected": "用户认证成功，并跳转到默认落地页。"
            }
          ]
        }
      ]
    }
  ]
}
```

## 脚本

脚本是给 Codex 自动调用的稳定工具，不是用户的主要操作入口。用户只需要提供文档并提出生成请求。

在 skill 目录下调用：

```bash
python3 scripts/validate_cases.py cases.json
python3 scripts/export_xmind.py cases.json --output test-cases.xmind
```

这些脚本只使用 Python 标准库，避免安装额外依赖。