测试用例生成器
执行入口
立即跳转到执行引擎:execution-engine.md
本文档是轻量级引导。详细 15 步执行流程、约束、检查清单、文档加载顺序见执行引擎。
触发场景
当用户需要生成测试用例、编写测试用例文档、设计测试覆盖方案或进行缺陷驱动测试时激活。
核心目标
根据 API 定义或需求文档,自动生成结构化、高覆盖、可执行的测试用例。
数据流架构(精简)
raw-knowledge/ # 【L1】原始资料层(手动放入,禁止放蒸馏内容)
├── 01-product/
├── 02-order/
├── 03-procurement/
├── 04-inventory/
├── 05-customer-service/
├── 06-data/
├── 07-finance/
└── 99-common/
knowledge/ # 【L2】蒸馏知识层(LLM 自动维护)
├── _index.yaml # 模块索引
├── {module}.md # 模块知识文件
├── common.md # 通用知识
└── state-machines/ # 状态机文件
references/knowledge/ # 【L3】技能内置基线(随技能分发)
├── common.md # 通用业务规则与不变性
├── test-methodology.md # 标准测试方法论
└── README.md # 基线知识说明
input/ # 原始数据层(用户手动存放)
├── prd/
├── tech-design/
└── images/
requirements/ # 需求目录(AI自动生成)
└── REQ-XXX-需求名称/
├── input/
├── extracted/
└── output/
├── current/test-cases/ # 最新版本
└── versions/ # 历史版本
完整数据流:L3 基线 → L2 蒸馏知识 → input/ 原始 → requirements/REQ-XXX/ 处理+输出
核心文档索引
系统级(P0 必须加载)
| 文档 | 职责 |
|---|---|
| execution-engine.md | 唯一执行入口控制器 |
| pattern-registry.md | Pattern 注册与路由 |
| quality-checks.md | 6项强制质量校验 |
Pattern 层(按优先级加载)
| 文档 | Pattern 数量 |
|---|---|
| risk-patterns.md | 19种风险模式(LEVEL_1) |
| api-test-patterns.md | 8种API模式(LEVEL_2) |
| business-test-patterns.md | 7种业务模式(LEVEL_2) |
| ui-test-patterns.md | 3种UI验证模式(LEVEL_2.5) |
| error-patterns.md | 10种错误模式(LEVEL_3) |
规则与约束
| 文档 | 职责 |
|---|---|
| generation-engine.md | 用例生成规则 |
| coverage-engine.md | 覆盖率验证 |
| priority-engine.md | 优先级判定 |
格式规范
| 文档 | 职责 |
|---|---|
| input-schema.md | 输入格式规范 |
| output-schema.md | 输出格式规范 |
| modes-config.md | 工作模式配置 |
质量保障
| 文档 | 职责 |
|---|---|
| deduplicate-guide.md | 用例去重 |
| normalize-guide.md | 格式规范化 |
知识支撑(按需加载)
| 文档 | 职责 |
|---|---|
| business-models.md | 业务模型抽象 |
| test-methods.md | 测试方法论 |
缺陷根因分析已整合到
knowledge/common.md中,不再单独引用。
平台特定规则(UpSeller)
UpSeller 平台规则文件暂未部署到 references/platforms/upseller/,相关业务知识已整合到 knowledge/ 模块文件中。模板资源中的 VIP、采购、税务用例模板可直接使用。
模板资源(Templates)
| 文档 | 职责 |
|---|---|
| xmind-template.md | XMind格式模板 |
| test-plan-template.md | 测试计划模板 |
| test-report-template.md | 测试报告模板 |
| order-sync-test-cases.md | 订单同步用例模板 |
| inventory-sync-test-cases.md | 库存同步用例模板 |
| upseller-vip-subscription-test-cases.md | VIP套餐用例模板 |
| upseller-procurement-test-cases.md | 采购单用例模板 |
| upseller-tax-compliance-test-cases.md | 税务合规用例模板 |
专项测试领域(按需加载)
| 文档 | 职责 | 触发关键词 |
|---|---|---|
| performance-testing.md | 性能测试策略 | "性能"、"并发"、"大数据量" |
| security-testing.md | 安全测试 | "安全"、"SQL注入"、"XSS"、"权限" |
| reconciliation-testing.md | 财务对账测试 | "对账"、"财务"、"汇率"、"结算" |
| product-sync-testing.md | 商品同步测试 | "商品同步"、"SKU映射"、"多平台同步" |
| regression-testing-guide.md | 回归测试策略 | "回归"、"冒烟测试"、"影响分析" |
| automation-testing-guide.md | 自动化测试转化 | "自动化"、"脚本转化"、"CI/CD" |
| data-generation-guide.md | 测试数据生成 | "测试数据"、"数据生成"、"数据脱敏" |
| defect-management-guide.md | 缺陷管理规范 | "缺陷管理"、"缺陷分级"、"缺陷跟踪" |
| compatibility-testing.md | 兼容性测试 | "兼容性"、"浏览器"、"移动端" |
关键禁令
图片处理强制流程(最容易遗漏)
- 检测 → 提取 → AI视觉分析 → 输出到
extracted/images-content.md - 闸门未通过禁止进入下一步
- 参考:
references/guides/image-extraction-guide.md
- 检测 → 提取 → AI视觉分析 → 输出到
需求验证强制步骤
- Step 3 必须向用户确认需求身份和目录匹配
- 不确认不继续
不允许跳过任何步骤
- 必须首先加载 execution-engine.md
- 必须通过 pattern-registry.md 获取路由规则
- Risk Pattern 必须智能匹配
强制约束
- 执行入口:必须首先加载 execution-engine.md
- Pattern 路由:必须通过 pattern-registry.md 获取路由规则
- 图片处理:Step 4 图片分析闸门必须通过
- 风险匹配:Step 8 必须根据业务对象智能匹配 Risk Pattern
- 质量保障:Step 10 去重与规范化是强制步骤
- 覆盖验证:Step 12 6项强制校验必须执行
快速开始示例
用户只需:把需求文档放在 input/ 目录,告诉我文档路径。
AI自动完成:创建需求目录 → 复制文档 → 数据提取 → 生成测试用例
为 "input/prd/订单功能PRD.docx" 生成测试用例
AI 将自动:
- 读取源文档,生成目录
requirements/REQ-XXX-订单功能 - 执行数据提取(Word → Markdown/JSON,图片提取)
- 按 execution-engine.md 的 15 步流程生成测试用例
- 输出到
output/current/test-cases/订单功能-xmind.md
注意事项
图片处理错误案例分析(CRM需求)
问题:
- 没有从Word文档提取内嵌图片
- 没有进行AI视觉分析
- 图片没有放到output/images/目录
- 生成的测试用例缺少界面元素验证
根因:
- Step 2 图片处理流程不明确
- 没有强制检查点
- 未建立images-content.md文件
解决方案(已更新到流程):
- 新增检查点:Step 4 增加3个图片处理强制检查点
- 新增文档:
references/guides/image-extraction-guide.md - 更新检查清单:执行检查清单增加8项图片相关检查
- 明确流程:AI视觉分析 → 结构化输出 → 整合到prd.md
更新记录
| 日期 | 版本 | 更新内容 |
|---|---|---|
| 2025-04-10 | v1.0 | 初始版本,15步执行流程 |
| 2025-04-10 | v1.1 | 新增Step 3需求验证,AI视觉分析作为主方案 |
| 2025-04-13 | v1.2 | 补充完整Pattern体系(risk/api/business/error)、新增rules/引擎目录、完善schemas/和quality/ |
| 2025-04-14 | v1.3 | 补全所有文件引用:新增tech_design.py、xmind.py、assets/模板库、完整知识库结构、平台规则faq.md |
| 2026-05-13 | v1.4 | 统一15步编号:Step -1/0/0.5/0.6/1 |
| 2026-05-13 | v1.5 | 脚本与引用对齐:修正脚本名、删除不存在的引用、补全 knowledge 模块列表、统一 Step 编号、4项质量校验 |
| 2026-05-21 | v2.0 | 瘦身 SKILL.md + 拆分 execution-engine.md:SKILL.md 精简为索引入口,execution-engine.md 拆分为 5 个子文件(data-extraction-flow/image-gate-flow/generation-flow/output-version-flow/archive-push-flow) |