@raina-npm/opentest 1.0.1

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

@@ -0,0 +1,46 @@
+---
+name: opentest
+description: OpenTest 流程总览 - 了解规范驱动测试流程及各步骤对应的技能。当用户问 OpenTest 是什么、OpenTest 流程、或希望按「先规划再生成」做测试但未指定具体步骤时使用。执行具体步骤请使用 opentest-new、opentest-scope、opentest-spec、opentest-generate、opentest-report、opentest-archive。
+---
+
+# OpenTest 规范驱动测试（总览）
+
+## 概述
+
+OpenTest 是一套面向 AI 的**规范驱动测试（Spec-driven Testing）**流程：先通过结构化产物（proposal、scope、strategy、specs）与用户对齐「测什么、怎么测」，再直接生成用例资产，最后可归档。每个测试工作独立目录：`opentest/changes/<name>/`。
+
+**理念**：先约定再生成；可与 OpenSpec 等开发侧规范对应。
+
+## 各步骤与对应技能
+
+执行具体步骤时，请使用下表中对应的技能（每个技能可独立加载、直接执行）：
+
+| 步骤 | 技能名 | 触发示例 | 产物/动作 |
+|------|--------|----------|-----------|
+| 新建 | **opentest-new** | /ottest:new 用户登录、新建测试变更 | 创建 changes/<name>/、proposal.md、specs/、artifacts/ |
+| 范围 | **opentest-scope** | /ottest:scope、写测试范围 | scope.md |
+| 策略与场景 | **opentest-spec** | /ottest:spec、/ottest:ff、写测试策略和场景 | strategy.md、specs/*.md |
+| 生成 | **opentest-generate** | /ottest:generate Excel、/ottest:generate XMind | 根据 strategy+specs 直接生成 .xlsx 或 .xmind，输出到 artifacts/ |
+| 报告 | **opentest-report** | /ottest:report、写测试报告 | report.md |
+| 归档 | **opentest-archive** | /ottest:archive、归档测试 | 移动到 changes/archive/<date>-<name>/ |
+
+## 目录结构
+
+```
+opentest/
+  changes/
+    <name>/           # 当前变更：proposal、scope、strategy、specs、artifacts、report
+    archive/          # 已归档：<date>-<name>/
+```
+
+首次使用前若无 `opentest/changes`，可在项目根运行：`.claude/skills/opentest/scripts/init_opentest.py`。
+
+## 共享资源
+
+- **产物模板与字段说明**：[.claude/skills/opentest/references/artifact-templates.md](.claude/skills/opentest/references/artifact-templates.md)
+- **斜杠命令详细说明**：[.claude/skills/opentest/references/commands-reference.md](.claude/skills/opentest/references/commands-reference.md)
+- **初始化脚本**：[.claude/skills/opentest/scripts/init_opentest.py](.claude/skills/opentest/scripts/init_opentest.py)
+
+## 用例生成
+
+opentest-generate 根据 strategy.md 和 specs/*.md 直接生成用例，支持 Excel（.xlsx）或 XMind（.xmind）格式，输出到当前变更的 `artifacts/`。不依赖外部技能，使用内置脚本完成生成。

package/.claude/skills/opentest/references/artifact-templates.md

@@ -0,0 +1,130 @@
+# OpenTest 产物模板
+
+本文档提供 proposal、scope、strategy、specs 的 Markdown 模板与字段说明，供 AI 生成或更新产物时参考。
+
+---
+
+## proposal.md
+
+**用途**：说明本次测试工作的背景、被测对象与目标。
+
+```markdown
+# 测试提案：<标题>
+
+## 被测对象
+- 功能/模块/版本：（简要描述）
+- 关联需求或 OpenSpec：（如有）路径或链接
+
+## 测试目标
+- 为什么做这次测试（发布前验证、回归、新功能等）
+- 期望达成的结果（如：核心流程覆盖、接口契约验证）
+
+## 范围概要
+- 在范围内：（一两句话）
+- 不在范围内：（如有）
+```
+
+---
+
+## scope.md
+
+**用途**：明确测试范围、边界与依赖。
+
+```markdown
+# 测试范围：<标题>
+
+## 在范围内
+- 功能/模块列表
+- 测试类型（功能/接口/性能/兼容等）及优先级
+
+## 不在范围内
+- 明确排除的功能或场景
+
+## 风险与重点
+- 高风险区域
+- 必须覆盖的核心场景
+
+## 依赖
+- 需求文档/接口文档路径
+- 环境、数据、账号等依赖
+```
+
+---
+
+## strategy.md
+
+**用途**：测试策略与通过标准。
+
+```markdown
+# 测试策略：<标题>
+
+## 测试类型
+- 功能测试：范围与重点
+- 接口测试：范围与重点
+- 其他（性能/兼容/安全等）：如有
+
+## 测试层级
+- 单元/接口/集成/E2E 等与本次相关的层级
+
+## 通过标准
+- 用例通过率要求
+- 必须通过的场景或用例列表
+- 准入/准出条件（如有）
+```
+
+---
+
+## specs/<feature>.md
+
+**用途**：按功能或需求拆分的测试场景与验收条件。
+
+```markdown
+# 场景：<功能/模块名>
+
+## 场景概述
+- 简要说明该功能要测什么
+
+## 场景与验收条件
+
+### 场景 1：<名称>
+- **类型**：正向 / 负向 / 边界 / 异常
+- **前置条件**：
+- **步骤**：
+- **预期结果**：
+- **优先级**：P0 / P1 / P2
+
+### 场景 2：…
+（同上）
+
+## 数据与边界
+- 关键边界值、异常输入（如有）
+```
+
+---
+
+## report.md（可选）
+
+**用途**：测试执行结果摘要。
+
+```markdown
+# 测试报告：<标题>
+
+## 执行概要
+- 执行时间、环境
+- 总用例数、通过/失败/阻塞
+
+## 通过率与覆盖率
+- 按模块或类型的通过率
+- 需求/场景覆盖情况
+
+## 缺陷摘要
+- 严重/一般/轻微数量或列表（可简写）
+
+## 结论与建议
+- 是否达到通过标准
+- 遗留风险或后续建议
+```
+
+---
+
+使用说明：生成产物时不必严格照抄模板，可根据项目习惯增删章节；核心是保持「范围 → 策略 → 场景」的连贯性与可追溯性。用例生成通过 `/ottest:generate Excel` 或 `/ottest:generate XMind` 直接输出到 artifacts/。

package/.claude/skills/opentest/references/commands-reference.md

@@ -0,0 +1,85 @@
+# OpenTest 斜杠命令参考
+
+本文档对 `/ottest` 系列命令做详细说明与示例，便于 AI 与用户一致理解语义。
+
+---
+
+## 命令总览
+
+| 命令 | 别名/变体 | 说明 |
+|------|------------|------|
+| `/ottest:new <被测对象>` | 无 | 新建一次测试工作，创建变更目录与 proposal |
+| `/ottest:scope` | 无 | 生成或更新测试范围 scope.md |
+| `/ottest:spec` | `/ottest:ff` | 生成策略与场景（strategy.md + specs/*.md） |
+| `/ottest:generate Excel` 或 `XMind` | 无 | 根据 strategy+specs 直接生成用例，输出到 artifacts/ |
+| `/ottest:report` | 无 | 生成或更新测试报告 report.md |
+| `/ottest:archive` | 无 | 将当前变更归档到 archive/ |
+
+---
+
+## /ottest:new \<被测对象\>
+
+- **含义**：开始一次新的测试工作。
+- **参数**：被测对象可以是功能名、模块名、版本号等，建议简短英文或拼音（如 `user-login`、`release-2.0`）。
+- **行为**：
+  - 确定变更名（将空格/特殊字符替换为 `-`）。
+  - 创建 `opentest/changes/<name>/`，以及子目录 `specs/`、`artifacts/`。
+  - 若项目下尚无 `opentest/changes`，先创建。
+  - 编写 `proposal.md` 初稿，包含被测对象、测试目标、可选关联需求/OpenSpec。
+- **示例**：
+  - 用户：「/ottest:new 用户登录」→ 创建 `opentest/changes/user-login/` 并写 proposal。
+  - 用户：「用 OpenTest 为 dark mode 建一个测试」→ 等同 `/ottest:new add-dark-mode`。
+
+---
+
+## /ottest:scope
+
+- **含义**：明确本次测试的范围、边界与依赖。
+- **行为**：在**当前变更目录**下生成或更新 `scope.md`。若用户未先执行 new，需先确认或创建当前变更目录。
+- **内容要点**：在范围 / 不在范围、风险与重点、依赖（需求、接口文档、环境）。
+
+---
+
+## /ottest:spec 与 /ottest:ff
+
+- **含义**：生成测试策略与场景（类似 OpenSpec 的「fast-forward」一次性产出）。
+- **行为**：
+  - 在当前变更目录下生成 `strategy.md`（测试类型、层级、通过标准）。
+  - 在 `specs/` 下按功能或需求生成若干场景文件（如 `login.md`），每文件包含场景与验收条件（正向/负向/边界）。
+- **输入**：可依赖 proposal、scope 以及用户补充说明。
+
+---
+
+## /ottest:generate [Excel|XMind]
+
+- **含义**：根据 strategy 与 specs 直接生成测试用例。
+- **参数**：`Excel` 生成 .xlsx，`XMind` 生成 .xmind；可省略则默认 Excel；可写 `Excel,XMind` 同时生成两种格式。
+- **行为**：
+  - 读取当前变更的 `strategy.md`、`specs/*.md`。
+  - 从 specs 中解析场景与验收条件，转换为结构化用例。
+  - 调用 `opentest-generate` 内置脚本生成 .xlsx 或 .xmind 文件。
+  - 将生成文件放入当前变更的 `artifacts/`。
+  - 在回复中列出生成的文件路径与简要说明。
+- **示例**：`/ottest:generate Excel`、`/ottest:generate XMind`、`/ottest:generate Excel,XMind`
+
+---
+
+## /ottest:report
+
+- **含义**：编写或更新测试执行结果摘要。
+- **行为**：在当前变更目录下生成或更新 `report.md`，内容可包括执行概要、通过率、覆盖率、缺陷摘要、结论与建议。具体字段可按项目习惯调整。
+
+---
+
+## /ottest:archive
+
+- **含义**：结束本次测试工作并归档。
+- **行为**：将当前变更目录整体移动到 `opentest/changes/archive/<date>-<name>/`（日期建议 YYYY-MM-DD），并告知用户归档路径。归档后该变更视为已完成。
+
+---
+
+## 「当前变更」的确定
+
+- 若用户明确说「对 xxx 做 scope / spec / …」，则当前变更为 `opentest/changes/xxx/`。
+- 若仅有一个未归档的变更目录，可默认其为当前变更。
+- 若有多个未归档变更，应询问用户要对哪一个执行命令，或让用户用「对 \<name\> 做 /ottest:scope」等形式指定。

package/.claude/skills/opentest/scripts/init_opentest.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""
+OpenTest 初始化脚本：在项目根目录创建 opentest 目录结构。
+
+用法（在项目根目录执行）：
+    python scripts/init_opentest.py
+    或指定项目根：
+    python scripts/init_opentest.py --root /path/to/project
+
+创建结构：
+    opentest/
+      changes/          # 存放各次测试变更
+      archive/         # 归档目录（可选，首次 new 时也可创建）
+"""
+import argparse
+import os
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Initialize OpenTest directory structure")
+    parser.add_argument(
+        "--root",
+        default=os.getcwd(),
+        help="Project root directory (default: current working directory)",
+    )
+    args = parser.parse_args()
+    root = os.path.abspath(args.root)
+
+    opentest = os.path.join(root, "opentest")
+    changes = os.path.join(opentest, "changes")
+    archive = os.path.join(opentest, "archive")
+
+    created = []
+    for d in (opentest, changes, archive):
+        if not os.path.isdir(d):
+            os.makedirs(d, exist_ok=True)
+            created.append(d)
+
+    if created:
+        print("Created:", ", ".join(created))
+    else:
+        print("OpenTest directories already exist under:", opentest)
+    print("You can now use /ottest:new <name> to create a new test change.")
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,20 @@
+---
+name: opentest-apply
+description: [已废弃] OpenTest 曾用步骤，已由 opentest-generate 替代。请使用 /ottest:generate Excel 或 /ottest:generate XMind 根据 strategy+specs 直接生成用例。
+---
+
+# opentest-apply：已废弃
+
+本技能已废弃，由 **opentest-generate** 替代。OpenTest 流程已简化为：
+
+```
+new → scope → spec → generate → report → archive
+```
+
+如需生成测试用例，请使用 **opentest-generate**：
+
+- `/ottest:generate Excel` — 根据 strategy.md 和 specs/*.md 生成 .xlsx 用例
+- `/ottest:generate XMind` — 生成 .xmind 思维导图
+- `/ottest:generate Excel,XMind` — 同时生成两种格式
+
+opentest-generate 不依赖外部技能，使用内置脚本完成生成，输出到当前变更的 `artifacts/`。

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

@@ -0,0 +1,27 @@
+---
+name: opentest-archive
+description: OpenTest 归档 - 将当前测试变更移动到 archive 目录。当用户要归档测试、结束本次测试工作、或执行 /ottest:archive 时使用。将 opentest/changes/<name>/ 移动到 opentest/changes/archive/<date>-<name>/。
+---
+
+# opentest-archive：归档测试变更
+
+## 职责
+
+将当前 OpenTest 变更目录整体移动到 `opentest/changes/archive/<date>-<name>/`，完成本次测试工作的收尾；归档名建议带日期（如 `2025-02-11-add-dark-mode`）。
+
+## 当前变更目录
+
+- 若用户指定了变更名，使用 `opentest/changes/<name>/`。
+- 若未指定且项目下仅有一个非归档变更目录，则默认使用该目录。
+- 若有多个未归档变更，询问用户要归档哪一个。
+
+## 执行步骤
+
+1. **确定当前变更目录**（按上规则），记为 `<name>`。
+2. **确定归档名**：`<date>-<name>`，其中日期建议为 YYYY-MM-DD（可用当前日期）。
+3. **移动目录**：将 `opentest/changes/<name>/` 整体移动到 `opentest/changes/archive/<date>-<name>/`。若 `opentest/changes/archive/` 不存在，先创建。
+4. **告知用户**：归档后的路径 `opentest/changes/archive/<date>-<name>/`，并说明该变更已结束，可开始新的测试工作（使用 opentest-new）。
+
+## 产物
+
+- 原 `opentest/changes/<name>/` 不再存在；其内容现位于 `opentest/changes/archive/<date>-<name>/`。

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

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

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

@@ -0,0 +1,75 @@
+---
+name: opentest-generate
+description: OpenTest 用例生成 - 根据 strategy.md 和 specs/*.md 直接生成 Excel 或 XMind 格式的测试用例。当用户要生成用例、执行 /ottest:generate Excel 或 /ottest:generate XMind 时使用。不依赖外部技能，使用内置脚本完成生成。
+---
+
+# opentest-generate：用例生成
+
+## 职责
+
+读取当前变更的 `strategy.md` 和 `specs/*.md`，根据用户指定的格式（Excel 或 XMind）直接生成测试用例文件，输出到当前变更的 `artifacts/` 目录。不依赖 excel-test-case-generator、xmind-test-case-generator 等外部技能，使用本技能内置脚本完成生成。
+
+## 当前变更目录
+
+- 若用户指定了变更名，使用 `opentest/changes/<name>/`。
+- 若未指定且项目下仅有一个非归档变更目录，则默认使用该目录。
+- 若有多个未归档变更，询问用户要对哪一个执行。
+
+## 输出格式
+
+- **Excel**：生成 .xlsx 文件，包含用例编号、用例名称、前置条件、测试步骤、预期结果、优先级等标准字段。
+- **XMind**：生成 .xmind 思维导图，按功能模块组织，包含正向用例、负向用例、边界值用例、异常用例等分类。
+
+可同时生成两种格式，如 `/ottest:generate Excel,XMind`。
+
+## 执行步骤
+
+1. **确定当前变更目录**（按上规则）。
+2. **读取上下文**：读取 `strategy.md`、`specs/*.md`（以及可选的 scope.md、proposal.md）。
+3. **从 specs 提取测试用例**：解析每个 spec 文件中的「场景与验收条件」，将其转换为结构化测试用例列表。每个用例包含：
+   - 功能/模块（来自 spec 文件名或场景概述）
+   - 用例名称
+   - 类型：正向 / 负向 / 边界 / 异常
+   - 前置条件、步骤、预期结果
+   - 优先级：P0 / P1 / P2
+4. **生成 testcases.json**：在变更目录或 artifacts/ 下写入临时 `testcases.json`，供脚本读取。格式示例：
+
+   ```json
+   [
+     {
+       "feature": "登录",
+       "name": "正常登录-有效账号密码",
+       "type": "正向",
+       "preconditions": "系统已启动，用户已注册",
+       "steps": "1. 打开登录页\n2. 输入正确账号密码\n3. 点击登录",
+       "expected_result": "登录成功，跳转首页",
+       "priority": "P0"
+     }
+   ]
+   ```
+
+5. **调用生成脚本**：
+   - **Excel**：执行
+     ```powershell
+     python .claude/skills/opentest-generate/scripts/generate_excel.py --input <变更目录>/testcases.json --output <变更目录>/artifacts/<name>_cases.xlsx
+     ```
+   - **XMind**：执行
+     ```powershell
+     python .claude/skills/opentest-generate/scripts/generate_xmind.py --input <变更目录>/testcases.json --output <变更目录>/artifacts/<name>_cases.xmind --title "测试用例"
+     ```
+6. **清理**：可删除临时 testcases.json，或保留供用户审查。
+7. **告知用户**：列出生成的文件路径及简要说明。
+
+## 依赖
+
+- **Excel**：需要 `openpyxl`（`pip install openpyxl`）
+- **XMind**：无额外依赖，使用内置 ZIP + content.json 格式生成，兼容 XMind Zen
+
+若 Excel 生成失败且提示缺少 openpyxl，请运行 `pip install openpyxl`。
+
+## 产物
+
+- `opentest/changes/<name>/artifacts/<name>_cases.xlsx`（Excel 格式）
+- `opentest/changes/<name>/artifacts/<name>_cases.xmind`（XMind 格式）
+
+文件名可根据变更名或用户指定调整。

package/.claude/skills/opentest-generate/requirements.txt

@@ -0,0 +1,2 @@
+# opentest-generate 依赖（仅 Excel 生成需要）
+openpyxl>=3.0.0

package/.claude/skills/opentest-generate/scripts/generate_excel.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""
+OpenTest Excel 用例生成脚本：根据 testcases.json 生成 .xlsx 测试用例文档。
+
+用法：
+    python generate_excel.py --input testcases.json --output artifacts/cases.xlsx
+"""
+import argparse
+import json
+import os
+import sys
+
+
+def create_excel_with_openpyxl(test_cases: list, output_path: str) -> None:
+    """使用 openpyxl 创建 Excel 文件。"""
+    try:
+        from openpyxl import Workbook
+        from openpyxl.styles import Font, PatternFill, Alignment, Border, Side
+        from openpyxl.utils import get_column_letter
+    except ImportError:
+        print("错误：需要安装 openpyxl，请运行：pip install openpyxl", file=sys.stderr)
+        sys.exit(1)
+
+    wb = Workbook()
+    sheet = wb.active
+    sheet.title = "测试用例"
+
+    headers = ["用例编号", "用例名称", "功能模块", "类型", "前置条件", "测试步骤", "预期结果", "优先级", "执行结果"]
+    header_fill = PatternFill(start_color="4472C4", end_color="4472C4", fill_type="solid")
+    header_font = Font(bold=True, color="FFFFFF", size=11)
+
+    for col_idx, header in enumerate(headers, 1):
+        cell = sheet.cell(row=1, column=col_idx)
+        cell.value = header
+        cell.font = header_font
+        cell.fill = header_fill
+        cell.alignment = Alignment(horizontal="center", vertical="center")
+
+    column_widths = [12, 35, 12, 10, 25, 40, 30, 10, 12]
+    for col_idx, width in enumerate(column_widths, 1):
+        sheet.column_dimensions[get_column_letter(col_idx)].width = width
+
+    for row_idx, tc in enumerate(test_cases, 2):
+        tc_id = f"TC-{row_idx - 1:03d}"
+        name = tc.get("name", "")
+        feature = tc.get("feature", "")
+        tc_type = tc.get("type", "")
+        preconditions = tc.get("preconditions", "")
+        steps = tc.get("steps", "")
+        expected = tc.get("expected_result", tc.get("expected", ""))
+        priority = tc.get("priority", "P1")
+        sheet.cell(row=row_idx, column=1, value=tc_id)
+        sheet.cell(row=row_idx, column=2, value=name)
+        sheet.cell(row=row_idx, column=3, value=feature)
+        sheet.cell(row=row_idx, column=4, value=tc_type)
+        sheet.cell(row=row_idx, column=5, value=preconditions)
+        sheet.cell(row=row_idx, column=6, value=steps)
+        sheet.cell(row=row_idx, column=7, value=expected)
+        sheet.cell(row=row_idx, column=8, value=priority)
+        sheet.cell(row=row_idx, column=9, value="")
+
+    os.makedirs(os.path.dirname(output_path) or ".", exist_ok=True)
+    wb.save(output_path)
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Generate Excel test cases from JSON")
+    parser.add_argument("--input", "-i", required=True, help="Path to testcases.json")
+    parser.add_argument("--output", "-o", required=True, help="Output .xlsx path")
+    args = parser.parse_args()
+
+    with open(args.input, encoding="utf-8-sig") as f:
+        test_cases = json.load(f)
+
+    if not isinstance(test_cases, list):
+        print("错误：JSON 应为用例数组", file=sys.stderr)
+        sys.exit(1)
+
+    create_excel_with_openpyxl(test_cases, args.output)
+    print(f"已生成：{args.output}")
+
+
+if __name__ == "__main__":
+    main()

package/.claude/skills/opentest-generate/scripts/generate_xmind.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+"""
+OpenTest XMind 用例生成脚本：根据 testcases.json 生成 .xmind 测试用例思维导图。
+
+用法：
+    python generate_xmind.py --input testcases.json --output artifacts/cases.xmind --title "测试用例"
+"""
+import argparse
+import json
+import os
+import sys
+from collections import defaultdict
+
+
+def build_xmind_structure(test_cases: list, root_title: str) -> list:
+    """将扁平用例列表组织为 XMind 层级结构。"""
+    by_feature = defaultdict(lambda: defaultdict(list))
+    for tc in test_cases:
+        feature = tc.get("feature", "未分类")
+        tc_type = tc.get("type", "其他")
+        name = tc.get("name", "")
+        by_feature[feature][tc_type].append(name)
+
+    type_order = ["正向", "负向", "边界", "异常", "其他"]
+    root = {"title": root_title, "children": []}
+    for feature in sorted(by_feature.keys()):
+        feat_node = {"title": f"{feature} - 测试用例", "children": []}
+        for tc_type in type_order:
+            cases = by_feature[feature].get(tc_type)
+            if not cases:
+                continue
+            type_node = {"title": f"{tc_type}用例", "children": []}
+            for name in cases:
+                type_node["children"].append({"title": name, "children": []})
+            feat_node["children"].append(type_node)
+        for tc_type, cases in by_feature[feature].items():
+            if tc_type not in type_order:
+                type_node = {"title": f"{tc_type}用例", "children": []}
+                for name in cases:
+                    type_node["children"].append({"title": name, "children": []})
+                feat_node["children"].append(type_node)
+        root["children"].append(feat_node)
+
+    return [root]
+
+
+def create_xmind_manual(structure: list, output_path: str) -> None:
+    """手动创建 XMind Zen 格式（ZIP + content.json）。"""
+    import zipfile
+
+    def to_xmind_json(nodes: list) -> list:
+        result = []
+        for i, node in enumerate(nodes):
+            child = {
+                "id": f"topic-{id(node)}",
+                "title": node.get("title", ""),
+                "children": {"attached": to_xmind_json(node.get("children", []))},
+            }
+            result.append(child)
+        return result
+
+    root = structure[0] if structure else {}
+    content = {
+        "root": {
+            "id": "root",
+            "title": root.get("title", "测试用例"),
+            "children": {"attached": to_xmind_json(root.get("children", []))},
+        }
+    }
+
+    os.makedirs(os.path.dirname(output_path) or ".", exist_ok=True)
+    with zipfile.ZipFile(output_path, "w", zipfile.ZIP_DEFLATED) as zf:
+        zf.writestr("content.json", json.dumps(content, ensure_ascii=False, indent=2))
+        zf.writestr(
+            "metadata.json",
+            json.dumps({"creator": {"name": "OpenTest", "version": "1.0"}}, ensure_ascii=False),
+        )
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Generate XMind test cases from JSON")
+    parser.add_argument("--input", "-i", required=True, help="Path to testcases.json")
+    parser.add_argument("--output", "-o", required=True, help="Output .xmind path")
+    parser.add_argument("--title", "-t", default="测试用例", help="Root topic title")
+    args = parser.parse_args()
+
+    with open(args.input, encoding="utf-8-sig") as f:
+        test_cases = json.load(f)
+
+    if not isinstance(test_cases, list):
+        print("错误：JSON 应为用例数组", file=sys.stderr)
+        sys.exit(1)
+
+    structure = build_xmind_structure(test_cases, args.title)
+    create_xmind_manual(structure, args.output)
+
+    print(f"已生成：{args.output}")
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,33 @@
+---
+name: opentest-new
+description: OpenTest 新建测试工作 - 创建一次测试变更目录并编写 proposal。当用户要新建 OpenTest 测试工作、创建测试变更、或执行 /ottest:new 时使用。创建 opentest/changes/<name>/ 及 proposal.md、specs/、artifacts/。
+---
+
+# opentest-new：新建测试工作
+
+## 职责
+
+新建一次 OpenTest 测试工作：创建变更目录并编写测试提案初稿。
+
+## 确定变更名
+
+- 从用户输入中提取被测对象（功能名、模块名、版本号等）。
+- 将名称规范为短名：英文或拼音，空格与特殊字符替换为 `-`（如「用户登录」→ `user-login`，`release 2.0` → `release-2.0`）。
+
+## 执行步骤
+
+1. **确保根目录存在**：若项目下没有 `opentest/changes`，先创建（或运行 `.claude/skills/opentest/scripts/init_opentest.py`，工作目录为项目根）。
+2. **创建变更目录**：`opentest/changes/<name>/`，以及子目录 `specs/`、`artifacts/`。
+3. **编写 proposal.md**：在变更目录下创建 `proposal.md`，包含：
+   - 被测对象（功能/模块/版本）
+   - 测试目标与原因
+   - 可选：关联的 OpenSpec 或需求路径
+   - 模板与字段说明见：`.claude/skills/opentest/references/artifact-templates.md` 中的「proposal.md」小节。
+
+4. **告知用户**：变更目录路径及下一步可执行「写测试范围」或 `/ottest:scope`。
+
+## 产物
+
+- `opentest/changes/<name>/proposal.md`
+- `opentest/changes/<name>/specs/`（空目录）
+- `opentest/changes/<name>/artifacts/`（空目录）