@raina-npm/opentest 1.0.1

package/.claude/skills/opentest-report/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: opentest-report
+description: OpenTest 测试报告 - 生成或更新 report.md 执行结果摘要。当用户要写测试报告、汇总执行结果、或执行 /ottest:report 时使用。在当前变更目录下产出 report.md（执行概要、通过率、覆盖率、缺陷摘要、结论与建议）。
+---
+
+# opentest-report：测试报告
+
+## 职责
+
+在当前 OpenTest 变更目录下生成或更新 `report.md`，汇总测试执行结果：执行概要、通过率与覆盖率、缺陷摘要、结论与建议。
+
+## 当前变更目录
+
+- 若用户指定了变更名，使用 `opentest/changes/<name>/`。
+- 若未指定且项目下仅有一个非归档变更目录，则默认使用该目录。
+- 若有多个未归档变更，询问用户要对哪一个执行。
+
+## 执行步骤
+
+1. **确定当前变更目录**（按上规则）。
+2. **收集信息**：若用户已提供执行结果（通过/失败数、缺陷列表等），据此填写；否则可先搭好 report 结构，留待用户补充数据。
+3. **生成或更新 report.md**：在变更目录下写入或更新 `report.md`，包含：
+   - 执行概要：执行时间、环境、总用例数、通过/失败/阻塞
+   - 通过率与覆盖率：按模块或类型的通过率、需求/场景覆盖情况
+   - 缺陷摘要：严重/一般/轻微数量或列表（可简写）
+   - 结论与建议：是否达到通过标准、遗留风险或后续建议
+   - 模板见：`.claude/skills/opentest/references/artifact-templates.md` 中的「report.md」小节。
+4. **告知用户**：文件路径及下一步可执行「归档测试」或 `/ottest:archive`。
+
+## 产物
+
+- `opentest/changes/<name>/report.md`

package/.claude/skills/opentest-scope/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: opentest-scope
+description: OpenTest 定义测试范围 - 生成或更新 scope.md。当用户要写测试范围、定义测什么不测什么、或执行 /ottest:scope 时使用。在当前变更目录下产出 scope.md（在范围/不在范围、风险、依赖）。
+---
+
+# opentest-scope：定义测试范围
+
+## 职责
+
+在当前 OpenTest 变更目录下生成或更新 `scope.md`，明确在范围/不在范围、风险与重点、依赖。
+
+## 当前变更目录
+
+- 若用户指定了变更名，使用 `opentest/changes/<name>/`。
+- 若未指定且项目下仅有一个非归档变更目录（即 `opentest/changes/` 下仅有一个非 `archive` 的子目录），则默认使用该目录。
+- 若有多个未归档变更，询问用户要对哪一个执行。
+
+## 执行步骤
+
+1. **确定当前变更目录**（按上规则）。
+2. **读取上下文**：若存在 `proposal.md`，可读取以保持与提案一致。
+3. **生成或更新 scope.md**：在变更目录下写入 `scope.md`，内容包含：
+   - 在范围内：功能/模块列表、测试类型及优先级
+   - 不在范围内：明确排除的功能或场景
+   - 风险与重点：高风险区域、必须覆盖的核心场景
+   - 依赖：需求文档/接口文档路径、环境、数据、账号等
+   - 模板与字段说明见：`.claude/skills/opentest/references/artifact-templates.md` 中的「scope.md」小节。
+
+4. **告知用户**：文件路径及下一步可执行「写测试策略和场景」或 `/ottest:spec`。
+
+## 产物
+
+- `opentest/changes/<name>/scope.md`

package/.claude/skills/opentest-spec/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: opentest-spec
+description: OpenTest 测试策略与场景 - 生成 strategy.md 和 specs 下的场景文件。当用户要写测试策略和场景、写测试规格、或执行 /ottest:spec、/ottest:ff 时使用。产出测试类型、层级、通过标准及按功能拆分的场景与验收条件。
+---
+
+# opentest-spec：策略与场景
+
+## 职责
+
+在当前 OpenTest 变更目录下生成 `strategy.md` 与 `specs/*.md`，定义测试类型、层级、通过标准及按功能拆分的场景与验收条件（正向/负向/边界）。
+
+## 当前变更目录
+
+- 若用户指定了变更名，使用 `opentest/changes/<name>/`。
+- 若未指定且项目下仅有一个非归档变更目录，则默认使用该目录。
+- 若有多个未归档变更，询问用户要对哪一个执行。
+
+## 执行步骤
+
+1. **确定当前变更目录**（按上规则）。
+2. **读取上下文**：若存在 `proposal.md`、`scope.md`，可读取以保持一致。
+3. **生成 strategy.md**：在变更目录下写入 `strategy.md`，包含：
+   - 测试类型（功能/接口/性能/兼容等）及范围与重点
+   - 测试层级（单元/接口/集成/E2E 等）
+   - 通过标准（用例通过率、必须通过的场景、准入/准出条件等）
+   - 模板见：`.claude/skills/opentest/references/artifact-templates.md` 中的「strategy.md」小节。
+4. **生成 specs/*.md**：在变更目录的 `specs/` 下按功能或需求拆分场景文件（如 `login.md`、`theme-toggle.md`），每文件包含：
+   - 场景概述
+   - 场景与验收条件（类型：正向/负向/边界/异常；前置条件、步骤、预期结果、优先级）
+   - 数据与边界（如有）
+   - 模板见：`.claude/skills/opentest/references/artifact-templates.md` 中的「specs/<feature>.md」小节。
+5. **告知用户**：产出路径及下一步可执行「写测试设计」或 `/ottest:design`。
+
+## 产物
+
+- `opentest/changes/<name>/strategy.md`
+- `opentest/changes/<name>/specs/<feature-a>.md`、`<feature-b>.md` 等

package/.claude/skills/opentest-tasks/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: opentest-tasks
+description: [已废弃] OpenTest 曾用步骤，已由简化流程替代。请使用 opentest-generate（/ottest:generate Excel 或 XMind）在 spec 后直接生成用例。
+---
+
+# opentest-tasks：已废弃
+
+本技能已废弃。OpenTest 流程已简化为：
+
+```
+new → scope → spec → generate → report → archive
+```
+
+任务步骤（tasks）已合并到生成步骤。如需生成测试用例，请使用 **opentest-generate**：
+
+- `/ottest:generate Excel` — 生成 .xlsx 用例
+- `/ottest:generate XMind` — 生成 .xmind 思维导图
+- `/ottest:generate Excel,XMind` — 同时生成两种格式

package/README.md

@@ -0,0 +1,91 @@
+# OpenTest
+
+规范驱动测试流程（Spec-driven Testing）——面向 AI 的「先规划再生成」测试工作流。可在**命令行**直接使用（与 OpenSpec 类似），也可在 Cursor 中配合斜杠命令使用。
+
+## 安装
+
+```bash
+npm install -g opentest
+```
+
+或使用 npx 免安装运行：
+
+```bash
+npx opentest init
+npx opentest new 用户登录
+```
+
+## 命令行用法
+
+在任意项目根目录执行：
+
+| 命令 | 说明 |
+|------|------|
+| `opentest init` | 初始化：复制技能到 `.claude/skills/`，创建 `opentest/changes/`、`opentest/archive/` |
+| `opentest new <name>` | 新建测试变更（创建目录与 proposal.md 模板） |
+| `opentest scope [--name <name>]` | 在当前变更下创建 scope.md 模板 |
+| `opentest spec [--name <name>]` | 创建 strategy.md 与 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` | 显示版本 |
+
+若只有一个未归档变更，`scope`、`spec`、`generate`、`report`、`archive` 可不写 `--name`。
+
+## 快速开始
+
+```powershell
+# 1. 初始化
+opentest init
+
+# 2. 新建一次测试
+opentest new 用户登录
+
+# 3. 写范围与策略（或直接编辑生成的文件）
+opentest scope --name 用户登录
+opentest spec --name 用户登录
+
+# 4. 若有 testcases.json，生成用例
+opentest generate Excel --name 用户登录
+# 或同时生成 Excel 与 XMind
+opentest generate Excel XMind
+
+# 5. 归档
+opentest archive --name 用户登录
+```
+
+## 在 Cursor 中使用
+
+初始化后，在 Cursor 中可与 AI 使用斜杠命令：
+
+- `/ottest:new <被测对象>` — 新建测试变更
+- `/ottest:scope` — 定义测试范围
+- `/ottest:spec` — 写测试策略与场景
+- `/ottest:generate Excel` / `/ottest:generate XMind` — 生成用例（AI 会从 strategy+specs 生成 testcases.json 再调用脚本）
+- `/ottest:report` — 写测试报告
+- `/ottest:archive` — 归档
+
+## Python 依赖（可选）
+
+若需生成 **Excel** 格式用例，请安装：
+
+```bash
+pip install openpyxl
+```
+
+XMind 生成无需额外依赖。
+
+## 目录结构
+
+```
+opentest/
+  changes/           # 各次测试变更
+    <name>/          # proposal、scope、strategy、specs、artifacts、report
+    archive/         # 已归档的变更
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,386 @@
+#!/usr/bin/env node
+/**
+ * OpenTest CLI - 命令行入口，与 OpenSpec 类似。
+ * 用法：opentest <子命令> [参数]
+ *   opentest init
+ *   opentest new <name>
+ *   opentest scope [--name <name>]
+ *   opentest spec [--name <name>]
+ *   opentest generate Excel|XMind [--name <name>]
+ *   opentest report [--name <name>]
+ *   opentest archive [--name <name>]
+ *   opentest list
+ */
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const PKG_ROOT = path.resolve(__dirname, '..');
+const CWD = process.cwd();
+const OPENTEST_ROOT = path.join(CWD, 'opentest');
+const CHANGES_DIR = path.join(OPENTEST_ROOT, 'changes');
+const ARCHIVE_DIR = path.join(OPENTEST_ROOT, 'archive');
+const SKILLS_SRC = path.join(PKG_ROOT, '.claude', 'skills');
+const SKILLS_DEST = path.join(CWD, '.claude', 'skills');
+const GENERATE_SCRIPTS = path.join(PKG_ROOT, '.claude', 'skills', 'opentest-generate', 'scripts');
+
+// ---------- 模板 ----------
+const PROPOSAL_TEMPLATE = `# 测试提案：<标题>
+
+## 被测对象
+- 功能/模块/版本：（简要描述）
+- 关联需求或 OpenSpec：（如有）路径或链接
+
+## 测试目标
+- 为什么做这次测试（发布前验证、回归、新功能等）
+- 期望达成的结果（如：核心流程覆盖、接口契约验证）
+
+## 范围概要
+- 在范围内：（一两句话）
+- 不在范围内：（如有）
+`;
+
+const SCOPE_TEMPLATE = `# 测试范围：<标题>
+
+## 在范围内
+- 功能/模块列表
+- 测试类型（功能/接口/性能/兼容等）及优先级
+
+## 不在范围内
+- 明确排除的功能或场景
+
+## 风险与重点
+- 高风险区域
+- 必须覆盖的核心场景
+
+## 依赖
+- 需求文档/接口文档路径
+- 环境、数据、账号等依赖
+`;
+
+const STRATEGY_TEMPLATE = `# 测试策略：<标题>
+
+## 测试类型
+- 功能测试：范围与重点
+- 接口测试：范围与重点
+- 其他（性能/兼容/安全等）：如有
+
+## 测试层级
+- 单元/接口/集成/E2E 等与本次相关的层级
+
+## 通过标准
+- 用例通过率要求
+- 必须通过的场景或用例列表
+- 准入/准出条件（如有）
+`;
+
+const SPEC_TEMPLATE = `# 场景：<功能/模块名>
+
+## 场景概述
+- 简要说明该功能要测什么
+
+## 场景与验收条件
+
+### 场景 1：<名称>
+- **类型**：正向 / 负向 / 边界 / 异常
+- **前置条件**：
+- **步骤**：
+- **预期结果**：
+- **优先级**：P0 / P1 / P2
+
+### 场景 2：…
+（同上）
+
+## 数据与边界
+- 关键边界值、异常输入（如有）
+`;
+
+const REPORT_TEMPLATE = `# 测试报告：<标题>
+
+## 执行概要
+- 执行时间、环境
+- 总用例数、通过/失败/阻塞
+
+## 通过率与覆盖率
+- 按模块或类型的通过率
+- 需求/场景覆盖情况
+
+## 缺陷摘要
+- 严重/一般/轻微数量或列表（可简写）
+
+## 结论与建议
+- 是否达到通过标准
+- 遗留风险或后续建议
+`;
+
+// ---------- 工具 ----------
+function copyDirRecursive(src, dest) {
+  if (!fs.existsSync(src)) return false;
+  fs.mkdirSync(dest, { recursive: true });
+  for (const e of fs.readdirSync(src, { withFileTypes: true })) {
+    const s = path.join(src, e.name);
+    const d = path.join(dest, e.name);
+    if (e.isDirectory()) copyDirRecursive(s, d);
+    else fs.copyFileSync(s, d);
+  }
+  return true;
+}
+
+function slug(name) {
+  return String(name)
+    .trim()
+    .replace(/\s+/g, '-')
+    .replace(/[^\w\u4e00-\u9fa5-]/g, '')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '') || 'untitled';
+}
+
+/** 获取未归档的变更目录列表 */
+function getNonArchivedChanges() {
+  if (!fs.existsSync(CHANGES_DIR)) return [];
+  const archivePath = path.join(CHANGES_DIR, 'archive');
+  return fs.readdirSync(CHANGES_DIR, { withFileTypes: true })
+    .filter(d => d.isDirectory() && d.name !== 'archive')
+    .map(d => d.name);
+}
+
+/** 解析「当前变更」：可选 --name，否则取唯一未归档 */
+function resolveChangeDir(args) {
+  let name = null;
+  for (let i = 0; i < args.length; i++) {
+    if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
+      name = slug(args[i + 1]);
+      break;
+    }
+  }
+  const list = getNonArchivedChanges();
+  if (name) {
+    if (!list.includes(name)) {
+      console.error('错误：未找到变更 "' + name + '"。可用：', list.join(', ') || '（无）');
+      process.exit(1);
+    }
+    return path.join(CHANGES_DIR, name);
+  }
+  if (list.length === 0) {
+    console.error('错误：没有未归档的变更。请先执行 opentest new <name>');
+    process.exit(1);
+  }
+  if (list.length > 1) {
+    console.error('错误：存在多个未归档变更，请用 --name 指定：', list.join(', '));
+    process.exit(1);
+  }
+  return path.join(CHANGES_DIR, list[0]);
+}
+
+function getChangeName(changeDir) {
+  return path.basename(changeDir);
+}
+
+// ---------- 子命令 ----------
+function cmdInit() {
+  console.log('OpenTest 初始化...\n');
+  if (!fs.existsSync(SKILLS_SRC)) {
+    console.error('错误：包内未找到 .claude/skills 目录。');
+    process.exit(1);
+  }
+  copyDirRecursive(SKILLS_SRC, SKILLS_DEST);
+  console.log('✓ 技能已复制到', path.relative(CWD, SKILLS_DEST));
+
+  for (const dir of [OPENTEST_ROOT, CHANGES_DIR, ARCHIVE_DIR]) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+      console.log('✓ 已创建', path.relative(CWD, dir));
+    }
+  }
+  console.log('\n完成。可用：opentest new <name> 新建测试变更。');
+  console.log('若需生成 Excel 用例，请安装：pip install openpyxl');
+}
+
+function cmdNew(args) {
+  const raw = args.filter(a => !a.startsWith('-')).join(' ').trim();
+  const name = raw ? slug(raw) : 'untitled';
+  const changeDir = path.join(CHANGES_DIR, name);
+  if (fs.existsSync(changeDir)) {
+    console.error('错误：变更已存在：', name);
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(CHANGES_DIR)) {
+    fs.mkdirSync(ARCHIVE_DIR, { recursive: true });
+    fs.mkdirSync(CHANGES_DIR, { recursive: true });
+  }
+
+  const specsDir = path.join(changeDir, 'specs');
+  const artifactsDir = path.join(changeDir, 'artifacts');
+  fs.mkdirSync(specsDir, { recursive: true });
+  fs.mkdirSync(artifactsDir, { recursive: true });
+
+  const title = raw || name;
+  const proposal = PROPOSAL_TEMPLATE.replace(/<标题>/g, title);
+  fs.writeFileSync(path.join(changeDir, 'proposal.md'), proposal, 'utf8');
+
+  console.log('✓ 已创建变更：', path.relative(CWD, changeDir));
+  console.log('  下一步：opentest scope --name ' + name + ' 或直接编辑 proposal.md / scope.md');
+}
+
+function cmdScope(args) {
+  const changeDir = resolveChangeDir(args);
+  const name = getChangeName(changeDir);
+  const scopePath = path.join(changeDir, 'scope.md');
+  const content = SCOPE_TEMPLATE.replace(/<标题>/g, name);
+  fs.writeFileSync(scopePath, content, 'utf8');
+  console.log('✓ 已写入', path.relative(CWD, scopePath));
+}
+
+function cmdSpec(args) {
+  const changeDir = resolveChangeDir(args);
+  const name = getChangeName(changeDir);
+  const strategyPath = path.join(changeDir, 'strategy.md');
+  const content = STRATEGY_TEMPLATE.replace(/<标题>/g, name);
+  fs.writeFileSync(strategyPath, content, 'utf8');
+  const specsDir = path.join(changeDir, 'specs');
+  if (!fs.existsSync(specsDir)) fs.mkdirSync(specsDir, { recursive: true });
+  const placeholderSpec = path.join(specsDir, 'main.md');
+  if (!fs.existsSync(placeholderSpec)) {
+    fs.writeFileSync(placeholderSpec, SPEC_TEMPLATE.replace(/<功能\/模块名>/, name), 'utf8');
+  }
+  console.log('✓ 已写入', path.relative(CWD, strategyPath));
+  console.log('✓ specs 目录已就绪');
+}
+
+function cmdReport(args) {
+  const changeDir = resolveChangeDir(args);
+  const name = getChangeName(changeDir);
+  const reportPath = path.join(changeDir, 'report.md');
+  const content = REPORT_TEMPLATE.replace(/<标题>/g, name);
+  fs.writeFileSync(reportPath, content, 'utf8');
+  console.log('✓ 已写入', path.relative(CWD, reportPath));
+}
+
+function cmdArchive(args) {
+  const changeDir = resolveChangeDir(args);
+  const name = getChangeName(changeDir);
+  const date = new Date().toISOString().slice(0, 10);
+  const archiveName = date + '-' + name;
+  const dest = path.join(CHANGES_DIR, 'archive', archiveName);
+  if (!fs.existsSync(path.join(CHANGES_DIR, 'archive'))) {
+    fs.mkdirSync(path.join(CHANGES_DIR, 'archive'), { recursive: true });
+  }
+  fs.renameSync(changeDir, dest);
+  console.log('✓ 已归档到', path.relative(CWD, dest));
+}
+
+function cmdList() {
+  const list = getNonArchivedChanges();
+  const archiveDir = path.join(CHANGES_DIR, 'archive');
+  let archived = [];
+  if (fs.existsSync(archiveDir)) {
+    archived = fs.readdirSync(archiveDir, { withFileTypes: true })
+      .filter(d => d.isDirectory())
+      .map(d => d.name);
+  }
+  console.log('未归档变更：', list.length ? list.join(', ') : '（无）');
+  console.log('已归档：', archived.length ? archived.join(', ') : '（无）');
+}
+
+function runPython(scriptName, scriptArgs) {
+  const scriptPath = path.join(GENERATE_SCRIPTS, scriptName);
+  if (!fs.existsSync(scriptPath)) {
+    console.error('错误：未找到脚本', scriptPath);
+    process.exit(1);
+  }
+  const py = process.platform === 'win32' ? 'python' : 'python3';
+  const result = spawnSync(py, [scriptPath, ...scriptArgs], {
+    stdio: 'inherit',
+  });
+  if (result.status !== 0) {
+    process.exit(result.status == null ? 1 : result.status);
+  }
+}
+
+function cmdGenerate(args) {
+  const formats = [];
+  const rest = [];
+  for (const a of args) {
+    if (a.toLowerCase() === 'excel') formats.push('excel');
+    else if (a.toLowerCase() === 'xmind') formats.push('xmind');
+    else rest.push(a);
+  }
+  if (formats.length === 0) formats.push('excel');
+
+  const changeDir = resolveChangeDir(rest);
+  const name = getChangeName(changeDir);
+  const jsonPath = path.join(changeDir, 'testcases.json');
+  const artifactsDir = path.join(changeDir, 'artifacts');
+  if (!fs.existsSync(jsonPath)) {
+    console.error('错误：未找到 testcases.json。请先在变更目录下准备 testcases.json，或使用 Cursor /ottest:generate 由 AI 从 strategy+specs 生成。');
+    process.exit(1);
+  }
+  if (!fs.existsSync(artifactsDir)) fs.mkdirSync(artifactsDir, { recursive: true });
+
+  const baseOut = path.join(artifactsDir, name + '_cases');
+  if (formats.includes('excel')) {
+    runPython('generate_excel.py', ['--input', jsonPath, '--output', baseOut + '.xlsx']);
+  }
+  if (formats.includes('xmind')) {
+    runPython('generate_xmind.py', ['--input', jsonPath, '--output', baseOut + '.xmind', '--title', '测试用例']);
+  }
+}
+
+function printHelp() {
+  console.log(`
+OpenTest CLI - 规范驱动测试
+
+用法: opentest <子命令> [参数]
+
+子命令:
+  init                    初始化：复制技能到 .claude/skills，创建 opentest 目录
+  new <name>              新建测试变更（创建目录与 proposal.md）
+  scope [--name <name>]   在当前变更下创建 scope.md 模板
+  spec [--name <name>]    创建 strategy.md 与 specs 模板
+  generate Excel|XMind [--name <name>]  根据 testcases.json 生成用例（需先有 testcases.json）
+  report [--name <name>]  创建 report.md 模板
+  archive [--name <name>] 将当前变更归档到 archive/
+  list                    列出未归档与已归档变更
+
+若仅有一个未归档变更，scope/spec/generate/report/archive 可不写 --name。
+`);
+}
+
+// ---------- 主入口 ----------
+function main() {
+  const argv = process.argv.slice(2);
+  const cmd = argv[0];
+  const args = argv.slice(1);
+
+  if (!cmd || cmd === '--help' || cmd === '-h') {
+    printHelp();
+    return;
+  }
+  if (cmd === '--version' || cmd === '-v') {
+    const pkg = require(path.join(PKG_ROOT, 'package.json'));
+    console.log(pkg.version);
+    return;
+  }
+
+  const commands = {
+    init: cmdInit,
+    new: cmdNew,
+    scope: cmdScope,
+    spec: cmdSpec,
+    generate: cmdGenerate,
+    report: cmdReport,
+    archive: cmdArchive,
+    list: cmdList,
+  };
+
+  const fn = commands[cmd];
+  if (!fn) {
+    console.error('未知子命令：', cmd);
+    printHelp();
+    process.exit(1);
+  }
+  fn(args);
+}
+
+main();

package/bin/init.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * OpenTest 初始化脚本
+ * 将技能复制到当前项目的 .claude/skills/，并创建 opentest 目录结构。
+ *
+ * 用法：
+ *   npx opentest-init
+ *   npm exec opentest-init
+ */
+const fs = require('fs');
+const path = require('path');
+
+const PKG_ROOT = path.resolve(__dirname, '..');
+const SKILLS_SRC = path.join(PKG_ROOT, '.claude', 'skills');
+const CWD = process.cwd();
+const SKILLS_DEST = path.join(CWD, '.claude', 'skills');
+const OPENTEST_ROOT = path.join(CWD, 'opentest');
+const CHANGES_DIR = path.join(OPENTEST_ROOT, 'changes');
+const ARCHIVE_DIR = path.join(OPENTEST_ROOT, 'archive');
+
+function copyDirRecursive(src, dest) {
+  if (!fs.existsSync(src)) {
+    console.error('错误：找不到技能目录', src);
+    process.exit(1);
+  }
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const e of entries) {
+    const s = path.join(src, e.name);
+    const d = path.join(dest, e.name);
+    if (e.isDirectory()) {
+      copyDirRecursive(s, d);
+    } else {
+      fs.copyFileSync(s, d);
+    }
+  }
+}
+
+function main() {
+  console.log('OpenTest 初始化...\n');
+
+  // 1. 复制技能到 .claude/skills/
+  if (!fs.existsSync(SKILLS_SRC)) {
+    console.error('错误：包内未找到 .claude/skills 目录，请检查安装。');
+    process.exit(1);
+  }
+
+  const skillsExist = fs.existsSync(SKILLS_DEST);
+  copyDirRecursive(SKILLS_SRC, SKILLS_DEST);
+  console.log('✓ 技能已复制到', path.relative(CWD, SKILLS_DEST));
+
+  // 2. 创建 opentest 目录结构
+  const created = [];
+  for (const dir of [OPENTEST_ROOT, CHANGES_DIR, ARCHIVE_DIR]) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+      created.push(path.relative(CWD, dir));
+    }
+  }
+  if (created.length) {
+    console.log('✓ 已创建目录:', created.join(', '));
+  } else {
+    console.log('✓ opentest 目录已存在');
+  }
+
+  // 3. Python 依赖提示
+  console.log('\n---');
+  console.log('OpenTest 初始化完成！');
+  if (!skillsExist) {
+    console.log('\n在 Cursor 中可使用斜杠命令：');
+    console.log('  /ottest:new <name>   - 新建测试变更');
+    console.log('  /ottest:scope        - 定义测试范围');
+    console.log('  /ottest:spec        - 写测试策略与场景');
+    console.log('  /ottest:generate Excel   - 生成 Excel 用例');
+    console.log('  /ottest:generate XMind  - 生成 XMind 用例');
+    console.log('  /ottest:report       - 写测试报告');
+    console.log('  /ottest:archive      - 归档本次测试');
+  }
+  console.log('\n提示：若需生成 Excel 用例，请先安装 Python 依赖：');
+  console.log('  pip install openpyxl');
+}
+
+main();