test-case-xmind

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

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

脚本

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

在 skill 目录下调用：

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

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