القائمة
根据产品需求文档、前端技术文档、后端技术文档、交互稿、接口说明、截图和相关项目资料生成结构化软件测试用例；校验用例格式；按“用例标题/前置条件/步骤/预期结果”模板导出 .xmind 脑图文件。适用于生成 QA 测试用例、验收用例、功能用例、回归用例、边界用例，或根据一个或多个输入文档生成 XMind 测试用例脑图。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
根据需求文档、测试用例、OpenAPI、Postman、Apipost、Swagger、Markdown 接口文档、后端文档或后端路由生成场景化接口自动化。适用于生成接口流程编排、scenarios.yaml/scenarios.json 场景文件、unittest/pytest 兼容的接口自动化测试，以及带数据依赖的端到端接口测试；不用于生成单元测试。
根据需求文档、UI 文档、截图、前端文档、已有测试用例（如 cases.json）或可访问的本地页面生成并执行浏览器 UI 场景验证。适用于驱动 Codex 内置浏览器进行点击、输入、导航、检查页面状态、截图取证、验证用户流程、生成 UI 检查报告、创建 ui-scenarios.json；也可在用户明确要求时导出 Playwright 测试。
| name | test-case-xmind |
| description | 根据产品需求文档、前端技术文档、后端技术文档、交互稿、接口说明、截图和相关项目资料生成结构化软件测试用例；校验用例格式；按“用例标题/前置条件/步骤/预期结果”模板导出 .xmind 脑图文件。适用于生成 QA 测试用例、验收用例、功能用例、回归用例、边界用例，或根据一个或多个输入文档生成 XMind 测试用例脑图。 |
使用本 skill 将产品和技术资料转换成结构化测试用例，并导出 .xmind 文件。
用户的真实使用方式是：提供一个或多个输入文档，然后要求 Codex 使用本 skill 生成测试用例。不要要求用户手动运行脚本，除非用户正在调试或维护这个 skill。Codex 应该在生成结构化用例后自动调用脚本完成校验和导出。
用例必须包含：
一条用例只有一个前置条件组，可以包含多个步骤。每个步骤必须且只能对应一个预期结果。
references/case_schema.md。references/coverage_rules.md。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 标准库，避免安装额外依赖。