xmind-testcase-generator

AI 编程助手插件 — XMind 测试用例生成器

支持 Claude Code / Cursor / Windsurf / GitHub Copilot 等主流 AI 编程工具。

功能

• 根据需求文档自动生成标准化 XMind 测试用例文件
• 内置完整的用例编写规范（优先级、步骤编号、前置条件、粒度原则等）
• 零依赖，仅使用 Python 标准库
• 一键安装到多个 AI 工具

安装

npm install -g xmind-testcase-generator

然后在项目目录下运行安装向导：

npx xmind-testcase-generator-setup
# 或
cd your-project && bash node_modules/xmind-testcase-generator/scripts/setup.sh

安装向导会让你选择要配置的工具：

请选择要安装的工具（可多选，用空格分隔）:

  1) Claude Code    (.claude/ + skills/)
  2) Cursor          (.cursor/rules/)
  3) Windsurf        (.windsurfrules)
  4) GitHub Copilot  (.github/copilot-instructions.md)
  a) 全部安装

手动安装

也可以手动复制规则文件到对应位置：

| AI 工具 | 复制目标 | |---------|---------| | Claude Code | skills/write-cases/SKILL.md | | Cursor | .cursor/rules/xmind-testcase.md | | Windsurf | 追加到 .windsurfrules | | GitHub Copilot | 追加到 .github/copilot-instructions.md |

规则源文件统一在 rules/xmind-testcase.md。

使用

在 AI 工具中使用

安装后，在任意 AI 编程工具的对话中直接说：

• "根据这个需求文档写测试用例"
• "帮我写 XX 模块的 XMind 用例"
• "生成用例"

AI 会自动按照规范：

1. 分析需求文档，提取功能点、交互规则、边界条件
2. 编写 build_cases() 用例数据
3. 执行 gen_xmind.py 生成 .xmind 文件
4. 输出用例统计（总数、smoke 数、占比）

在 Claude Code 中使用 skill

/write-cases

独立使用脚本

# 1. 复制 gen_xmind.py 到工作目录
cp node_modules/xmind-testcase-generator/scripts/gen_xmind.py .

# 2. 修改 build_cases() 函数
# 3. 执行
python3 gen_xmind.py

用例规范摘要

| 项目 | 规范 | |------|------| | 优先级 | P1(smoke ~20%) / P3(normal ~80%)，每条必标，不使用 P2 | | 步骤编号 | 1、操作步骤 → 子节点 1、预期结果 | | 前置条件 | F4 备注（note 参数），不混入步骤 | | 平台标签 | 空=全平台, ai=iOS+Android, as=Android+Server, f=FE | | 层级 | 需求→模块→子模块→(深层子tab)→测试点→步骤→预期 | | #开头 | 忽略该节点及所有子节点 |

详细规范见 rules/xmind-testcase.md。

快速示例

from gen_xmind import case, sub_module, module, generate_xmind, P1, P3

def build_cases():
    sub1 = [
        case("登录功能正常", [
            ("输入正确账号密码", ""),
            ("点击登录按钮", "登录成功，跳转首页"),
        ], P1),

        case("密码错误提示", [
            ("输入正确账号和错误密码", ""),
            ("点击登录按钮", "提示'密码错误，请重试'"),
        ]),
    ]

    modules_list = [module("登录模块", [
        sub_module("基础登录", sub1),
    ])]

    return "XX需求-登录", modules_list, "XX需求_登录_用例.xmind"

文件结构

xmind-testcase-generator/
├── .claude-plugin/
│   └── plugin.json              # Claude Code 插件配置
├── skills/
│   └── write-cases/
│       ├── SKILL.md              # Claude Code 技能定义
│       └── reference.md          # gen_xmind.py API 参考
├── rules/
│   └── xmind-testcase.md        # 通用规范（所有工具共用）
├── scripts/
│   ├── gen_xmind.py              # XMind 生成脚本
│   └── setup.sh                  # 多工具安装向导
├── package.json
├── LICENSE
└── README.md

支持的工具

| 工具 | 规则文件位置 | 安装方式 | |------|------------|---------| | Claude Code | .claude/ + skills/write-cases/SKILL.md | setup 选项 1 | | Cursor | .cursor/rules/xmind-testcase.md | setup 选项 2 | | Windsurf | .windsurfrules | setup 选项 3 | | GitHub Copilot | .github/copilot-instructions.md | setup 选项 4 |

依赖

• Python 3.6+（仅标准库，无需 pip install）
• 任意 AI 编程助手（推荐 Claude Code / Cursor）

License

MIT