- slug
- testcase-generator-excel-xlsx
- name
- testcase-generator
- version
- 1.0.0
- description
- 用来生成用例的技能，针对已有的用例库和提供的prd进行分析交互，最终输出生成的用例，会区分新增和更新，生成2个excel文件.
- author
- melissa.lu
- license
- MIT-0
测试用例生成器 (testcase-generator)
根据产品需求文档（PRD）生成和更新测试用例，遵循产品测试用例库风格规范。
触发场景
- "根据PRD生成测试用例"
- "更新测试用例"
- "分析这个需求的测试点"
- "帮我写测试用例"
- "这个PRD需要哪些用例"
多产品架构
本 Skill 支持多个产品（UHost、UPHost、私有专区等），每个产品有独立配置。
产品列表
| 产品 | 用例库 | 说明 |
|---|---|---|
uhost | 主机(306) + GPU(69) + 镜像(56) | 431 条总计 |
uphost | (待配置) | |
privatezone | (待配置) |
切换产品
使用 --product 参数指定产品：
version_manager.py --product uhost
case_generator.py --product uhost核心能力
- PRD解析 - 读取和理解产品需求文档
- 测试点分析 - 自动梳理功能点、边界条件、异常场景
- 用例库对比 - 查找可复用的现有用例，避免重复
- 用例生成 - 按照产品标准格式生成新增用例
- 用例更新 - 生成更新说明，标注修改位置和原因
- 版本管理 - 支持用例库版本检查和增量更新
工作流程
🔍 阶段0: 用例库版本检查（必须）
每次执行前，必须先检查用例库是否为最新版本。
步骤：
- 读取产品配置
python3 scripts/version_manager.py --product uhost- 显示版本信息，询问用户确认
📚 当前 [产品名] 用例库版本：
- CPU用例库: 306 条 (最后更新: YYYY-MM-DD)
- GPU用例库: 69 条 (最后更新: YYYY-MM-DD)
- 镜像用例库: 56 条 (最后更新: YYYY-MM-DD)
- 总计: 431 条
❓ 这是最新版本吗？
- 如果是，输入 "是" 继续
- 如果不是，请提供更新的用例文件- 如果用户提供更新文件
- 读取更新文件（支持增量更新） - 按 UUID 覆盖现有用例 - 更新用例库元数据 - 重新统计用例数量
- 确认后继续流程
📖 阶段1: PRD解析
目标: 理解需求，提取核心功能点和变更详情
步骤：
- 读取PRD文件
- 支持格式: PDF, Word, Markdown, 纯文本 - 如果是图片，使用 OCR 提取文字
- 提取关键信息
- 需求背景 - 功能变更点 - 涉及的模块/页面 - 涉及的接口 - 计费相关变更 - 特殊规则
- 生成 PRD 摘要
- 保存到 ~/.openclaw/workspace/memory/{需求名称}_PRD摘要.md - 包含：标题、版本、核心变更、涉及范围
🎯 阶段2: 测试点分析
目标: 根据PRD梳理详细的测试场景和验证点
步骤：
- 按模块分类测试点
- 前端交互测试 - 功能流程测试 - 接口测试 - 计费测试 - 存量数据处理 - 异常场景
- 识别测试类型
- 创建/查询/更新/删除 (CRUD) - 边界值测试 - 权限验证 - 性能测试 - 兼容性测试
- 梳理测试点清单
- 每个功能点对应的测试场景 - 前置条件 - 验证点 - 优先级（P0/P1/P2/P3）
- 生成测试点分析文档
- 保存到 ~/.openclaw/workspace/memory/{需求名称}_测试点分析.md - 包含：测试场景矩阵、待确认问题清单
- 人机交互确认 ⚠️
📋 测试点分析完成，共梳理 XX 个测试场景
❓ 是否有遗漏的场景？是否有不清楚的地方需要确认？📚 阶段3: 用例库对比
目标: 查找可复用的现有用例，判断需要新增还是更新
步骤：
- 读取产品用例库（根据 config.yaml 中的路径）
- CPU 用例库 - GPU 用例库（如适用） - 镜像用例库（如适用）
- 按关键词搜索相关用例
- 搜索范围：用例名称、所属模块、步骤描述 - 关键词：需求涉及的功能、模块、操作
- 分析匹配结果
- 完全匹配: 可直接更新现有用例 - 部分匹配: 需要增加步骤或验证点 - 无匹配: 需要新增用例
- 生成对比分析报告
- 保存到 ~/.openclaw/workspace/memory/{需求名称}_用例对比分析.md - 包含： - 可复用的现有用例列表 - 需要更新的用例及更新点 - 需要新增的用例清单
- 人机交互确认 ⚠️
📊 用例对比完成
- 可复用/更新: XX 条
- 需要新增: XX 条
❓ 确认对比结果？是否有需要调整的地方？✍️ 阶段4: 生成用例文件
目标: 按照产品标准格式生成新增用例和更新说明
步骤：
4.1 生成新增用例
- 创建 Excel 文件
- 文件名: {output_dir}/{需求名称}_新增用例.xlsx
- 表头（12列）
用例ID | 用例名称 | 所属模块 | 标签 | 前置条件 | 备注 | 步骤描述 | 预期结果 | 用例等级 | 用例类型 | 是否支持自动化 | 是否支持拨测- 填写规则
- 用例ID: 留空 ⚠️ - 所属模块: 在生成的模块路径前加 /ai 前缀 ⚠️ - 例: /ai/镜像常规/镜像常规/功能/自制镜像tab下/导入镜像 - 步骤描述: 使用【数字】标记，如 【1】【2】【3】 - 预期结果: 使用【数字】标记，与步骤一一对应 - 前置条件: 使用数字编号，如 1. 2. 3. - 用例等级: P0/P1/P2/P3（根据重要性） - 用例类型: 1=功能，2=界面，3=接口 - 是否支持自动化: 1=是，2=否 - 是否支持拨测: 1=是，2=否
4.2 生成更新用例
- 创建 Excel 文件
- 文件名: {output_dir}/{需求名称}_更新用例.xlsx
- 表头（17列）
用例ID | 用例名称 | 所属模块 | 标签 | 前置条件 | 备注 | 步骤描述 | 预期结果 | 用例等级 | 用例类型 | 是否支持自动化 | 是否支持拨测 | 更新类型 | 更新位置 | 原内容 | 更新后内容 | 更新原因- 填写规则
- 前12列：保留原用例的完整信息 - 更新类型: 如"增加步骤"、"更新预期结果"、"修改前置条件" - 更新位置: 如"步骤【N】后"、"预期结果【N】" - 原内容: 现有用例的相关内容片段 - 更新后内容: 更新后的完整内容 - 更新原因: 为什么要更新，关联的需求点
- 颜色标注
- 不同用例库来源用不同颜色底色区分 - 方便人工审核
产品配置说明
每个产品的配置存储在 ~/.openclaw/products/{product}/config.yaml
配置结构
product: uhost
display_name: "UHost 主机"
case_libraries:
cpu:
path: /path/to/UHost-cpu.xlsx
name: "CPU用例库"
count: 306
gpu:
path: /path/to/UHost-gpu.xlsx
name: "GPU用例库"
count: 69
image:
path: /path/to/UHost-image.xlsx
name: "镜像用例库"
count: 56
total_cases: 431
last_updated: "2026-04-09"新增产品
- 创建目录:
~/.openclaw/products/{product}/ - 添加
config.yaml - 复制风格规范:
references/ - 可选: 添加
templates/
格式规范
步骤描述规范
【1】第一步操作描述
【2】第二步操作描述
【3】第三步操作描述
...
【N】第N步操作描述- 使用中文全角方括号【】
- 每个步骤独立一行，用 `\
` 分隔
- 步骤描述要具体，包含操作对象、操作动作、参数值
- 平均步骤数: 10.4 步
预期结果规范
【1】第一步预期结果
【2】第二步预期结果
【3】第三步预期结果
...
【N】第N步预期结果- 步骤编号与步骤描述一一对应
- 描述要明确，可验证
- 如果一个步骤有多个验证点，使用子编号：
【4】1. 验证点1
2. 验证点2
3. 验证点3前置条件规范
1.前置条件1
2.前置条件2
3.前置条件3- 使用数字编号 + 点号
- 每个条件独立一行，用 `\
` 分隔
- 88.2%的用例使用数字编号
模块路径规范
/一级模块/二级模块/三级模块/.../N级模块- 以
/开头和分隔 - 主流层级：3-5层（96.9%）
- 新增用例: 在路径前加 /ai 前缀
用例名称规范
功能模块-具体操作-场景说明- 使用连字符
-分隔（81.4%的用例） - 简洁明了，包含核心操作动词
- 例:
创建主机-登录设置、主机操作-重装系统-登录及其他
用例等级规范
- P0 (6.9%): 冒烟/核心流程/阻塞性
- P1 (21.6%): 主要功能/高频场景
- P2 (49.0%): 标准功能/常规场景 ⭐ (最常见)
- P3 (22.5%): 边缘场景/辅助功能
用例类型规范
- 类型1 (85.6%): 功能测试 ⭐⭐⭐
- 类型2 (1.3%): 界面/UI测试
- 类型3 (13.1%): 接口测试
输出目录
- 默认:
~/.openclaw/workspace/ - 文件命名格式:
- {需求名称}_新增用例.xlsx - {需求名称}_更新用例.xlsx - {需求名称}_测试点分析.md - {需求名称}_用例对比分析.md
版本历史
- v1.0 (2026-04-08): 初始版本，基于 Windows镜像收费 需求实践总结
- v1.1 (2026-04-09): 改造为多产品架构，支持配置化
维护人: 球球 🦊