| name | test-case-xmind |
| description | 根据产品需求文档、前端技术文档、后端技术文档、交互稿、接口说明、截图和相关项目资料生成结构化软件测试用例；校验用例格式；按“用例标题/前置条件/步骤/预期结果”模板导出 .xmind 脑图文件。适用于生成 QA 测试用例、验收用例、功能用例、回归用例、边界用例，或根据一个或多个输入文档生成 XMind 测试用例脑图。 |
测试用例 XMind
概览
使用本 skill 将产品和技术资料转换成结构化测试用例，并导出 .xmind 文件。
用户的真实使用方式是：提供一个或多个输入文档，然后要求 Codex 使用本 skill 生成测试用例。不要要求用户手动运行脚本，除非用户正在调试或维护这个 skill。Codex 应该在生成结构化用例后自动调用脚本完成校验和导出。
用例必须包含：
一条用例只有一个前置条件组，可以包含多个步骤。每个步骤必须且只能对应一个预期结果。
工作流程
- 收集用户提供的源文档，检查所有会影响行为、数据、页面状态、权限、接口、校验、异常处理或边界场景的输入。
- 在编写结构化用例 JSON 前，阅读
references/case_schema.md。
- 在决定覆盖范围前，阅读
references/coverage_rules.md。
- 根据 schema 生成结构化
cases.json。
- 运行
scripts/validate_cases.py 校验 JSON，并修复所有错误。
- 运行
scripts/export_xmind.py 生成 .xmind 文件。
- 生成
.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 标准库，避免安装额外依赖。
