OpenTest

规范驱动测试流程，推荐四步：需求文档 → 需求分析和梳理 → 测试点 → 生成测试用例。可在命令行直接使用（与 OpenSpec 类似），也可在 Cursor 中配合技能（opentest-new、opentest-analysis、opentest-points 等）使用。

安装

npm install -g @raina-npm/opentest

或使用 npx 免安装运行：

npx @raina-npm/opentest init
npx @raina-npm/opentest new 用户登录

安装后命令行仍使用 opentest（如 opentest init、opentest new <name>）。
详细说明见 使用说明。

命令行用法

在任意项目根目录执行：

| 命令 | 说明 | |------|------| | opentest init | 初始化：复制技能到 .claude/skills/，创建 opentest/changes/、opentest/archive/ | | opentest new <name> | 新建测试变更（创建目录与 proposal.md 模板） | | opentest analysis [--name <name>] | 在当前变更下创建 requirements-analysis.md 模板 | | opentest points [--name <name>] | 创建 specs 目录与占位场景文件 | | opentest generate Excel\|XMind [--name <name>] | 根据 testcases.json 生成用例到 artifacts/ | | opentest report [--name <name>] | 创建 report.md 模板 | | opentest archive [--name <name>] | 将当前变更归档到 archive/ | | opentest list | 列出未归档与已归档变更 | | opentest --help | 显示帮助 | | opentest --version | 显示版本 |

若只有一个未归档变更，analysis、points、generate、report、archive 可不写 --name。

快速开始

# 1. 初始化
opentest init

# 2. 新建一次测试
opentest new 用户登录

# 3. 需求分析与测试点（或直接编辑生成的文件）
opentest analysis --name 用户登录
opentest points --name 用户登录

# 4. 若有 testcases.json，生成用例
opentest generate Excel --name 用户登录
# 或同时生成 Excel 与 XMind
opentest generate Excel XMind

# 5. 归档
opentest archive --name 用户登录

在 Cursor 中使用

初始化后，在 Cursor 中可与 AI 使用对应技能（与技能列表中的名称一致）：

• opentest-new — 新建测试变更
• opentest-analysis — 需求分析与梳理
• opentest-points — 写测试点/场景
• opentest-generate Excel / opentest-generate XMind — 生成用例（AI 会从 specs 生成 testcases.json 再调用脚本）
• opentest-report — 写测试报告
• opentest-archive — 归档

Python 依赖（可选）

若需生成 Excel 格式用例，请安装：

pip install openpyxl

XMind 生成无需额外依赖。

目录结构

opentest/
  changes/           # 各次测试变更
    <name>/          # proposal、requirements-analysis、specs、artifacts、report
    archive/         # 已归档的变更

License

MIT