# Test Case Writer Plus

> 专为跨境电商ERP业务设计，支持多平台通用测试用例生成，并能针对特定平台（如UpSeller）进行深入设计；根据API定义或需求文档自动生成高质量测试用例，覆盖多平台订单同步、库存管理、商品同步、物流发货、财务对账、VIP套餐、采购单管理、税务合规等核心场景；当用户需要生成测试用例、编写测试用例文档、设计测试覆盖方案或进行缺陷驱动测试时使用

- Skill: `penghang1223/test-case-writer-plus` (Agent Skill, multi-file: 56 files)
- Install (CLI): `npx skillmds@latest add penghang1223/test-case-writer-plus`
- Raw SKILL.md: https://api.skillmd.com/api/skills/penghang1223/test-case-writer-plus/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: penghang1223 (https://skillmd.com/u/penghang1223)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/penghang1223/test-case-writer-plus

---


# 测试用例生成器

## 执行入口

**立即跳转到执行引擎**：[execution-engine.md](references/system/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](references/system/execution-engine.md) | 唯一执行入口控制器 |
| [pattern-registry.md](references/system/pattern-registry.md) | Pattern 注册与路由 |
| [quality-checks.md](references/quality/quality-checks.md) | 6项强制质量校验 |

### Pattern 层（按优先级加载）
| 文档 | Pattern 数量 |
|------|-------------|
| [risk-patterns.md](references/patterns/risk-patterns.md) | 19种风险模式（LEVEL_1） |
| [api-test-patterns.md](references/patterns/api-test-patterns.md) | 8种API模式（LEVEL_2） |
| [business-test-patterns.md](references/patterns/business-test-patterns.md) | 7种业务模式（LEVEL_2） |
| [ui-test-patterns.md](references/patterns/ui-test-patterns.md) | 3种UI验证模式（LEVEL_2.5） |
| [error-patterns.md](references/patterns/error-patterns.md) | 10种错误模式（LEVEL_3） |

### 规则与约束
| 文档 | 职责 |
|------|------|
| [generation-engine.md](references/rules/generation-engine.md) | 用例生成规则 |
| [coverage-engine.md](references/rules/coverage-engine.md) | 覆盖率验证 |
| [priority-engine.md](references/rules/priority-engine.md) | 优先级判定 |

### 格式规范
| 文档 | 职责 |
|------|------|
| [input-schema.md](references/schemas/input-schema.md) | 输入格式规范 |
| [output-schema.md](references/schemas/output-schema.md) | 输出格式规范 |
| [modes-config.md](references/schemas/modes-config.md) | 工作模式配置 |

### 质量保障
| 文档 | 职责 |
|------|------|
| [deduplicate-guide.md](references/quality/deduplicate-guide.md) | 用例去重 |
| [normalize-guide.md](references/quality/normalize-guide.md) | 格式规范化 |

### 知识支撑（按需加载）
| 文档 | 职责 |
|------|------|
| [business-models.md](references/base/business-models.md) | 业务模型抽象 |
| [test-methods.md](references/base/test-methods.md) | 测试方法论 |

> 缺陷根因分析已整合到 `knowledge/common.md` 中，不再单独引用。

### 平台特定规则（UpSeller）

UpSeller 平台规则文件暂未部署到 `references/platforms/upseller/`，相关业务知识已整合到 `knowledge/` 模块文件中。模板资源中的 VIP、采购、税务用例模板可直接使用。

### 模板资源（Templates）
| 文档 | 职责 |
|------|------|
| [xmind-template.md](assets/templates/xmind-template.md) | XMind格式模板 |
| [test-plan-template.md](assets/templates/test-plan-template.md) | 测试计划模板 |
| [test-report-template.md](assets/templates/test-report-template.md) | 测试报告模板 |
| [order-sync-test-cases.md](assets/templates/order-sync-test-cases.md) | 订单同步用例模板 |
| [inventory-sync-test-cases.md](assets/templates/inventory-sync-test-cases.md) | 库存同步用例模板 |
| [upseller-vip-subscription-test-cases.md](assets/templates/upseller-vip-subscription-test-cases.md) | VIP套餐用例模板 |
| [upseller-procurement-test-cases.md](assets/templates/upseller-procurement-test-cases.md) | 采购单用例模板 |
| [upseller-tax-compliance-test-cases.md](assets/templates/upseller-tax-compliance-test-cases.md) | 税务合规用例模板 |

### 专项测试领域（按需加载）

| 文档 | 职责 | 触发关键词 |
|------|------|-----------|
| [performance-testing.md](references/performance/performance-testing.md) | 性能测试策略 | "性能"、"并发"、"大数据量" |
| [security-testing.md](references/security/security-testing.md) | 安全测试 | "安全"、"SQL注入"、"XSS"、"权限" |
| [reconciliation-testing.md](references/finance/reconciliation-testing.md) | 财务对账测试 | "对账"、"财务"、"汇率"、"结算" |
| [product-sync-testing.md](references/products/product-sync-testing.md) | 商品同步测试 | "商品同步"、"SKU映射"、"多平台同步" |
| [regression-testing-guide.md](references/regression/regression-testing-guide.md) | 回归测试策略 | "回归"、"冒烟测试"、"影响分析" |
| [automation-testing-guide.md](references/automation/automation-testing-guide.md) | 自动化测试转化 | "自动化"、"脚本转化"、"CI/CD" |
| [data-generation-guide.md](references/data-generation/data-generation-guide.md) | 测试数据生成 | "测试数据"、"数据生成"、"数据脱敏" |
| [defect-management-guide.md](references/defect-management/defect-management-guide.md) | 缺陷管理规范 | "缺陷管理"、"缺陷分级"、"缺陷跟踪" |
| [compatibility-testing.md](references/compatibility/compatibility-testing.md) | 兼容性测试 | "兼容性"、"浏览器"、"移动端" |

---

## 关键禁令

1. **图片处理强制流程**（最容易遗漏）
   - 检测 → 提取 → AI视觉分析 → 输出到 `extracted/images-content.md`
   - 闸门未通过禁止进入下一步
   - 参考：`references/guides/image-extraction-guide.md`

2. **需求验证强制步骤**
   - Step 3 必须向用户确认需求身份和目录匹配
   - 不确认不继续

3. **不允许跳过任何步骤**
   - 必须首先加载 execution-engine.md
   - 必须通过 pattern-registry.md 获取路由规则
   - Risk Pattern 必须智能匹配

---

## 强制约束

1. **执行入口**：必须首先加载 execution-engine.md
2. **Pattern 路由**：必须通过 pattern-registry.md 获取路由规则
3. **图片处理**：Step 4 图片分析闸门必须通过
4. **风险匹配**：Step 8 必须根据业务对象智能匹配 Risk Pattern
5. **质量保障**：Step 10 去重与规范化是强制步骤
6. **覆盖验证**：Step 12 6项强制校验必须执行

---

## 快速开始示例

**用户只需**：把需求文档放在 input/ 目录，告诉我文档路径。

**AI自动完成**：创建需求目录 → 复制文档 → 数据提取 → 生成测试用例

```
为 "input/prd/订单功能PRD.docx" 生成测试用例
```

AI 将自动：
1. 读取源文档，生成目录 `requirements/REQ-XXX-订单功能`
2. 执行数据提取（Word → Markdown/JSON，图片提取）
3. 按 execution-engine.md 的 15 步流程生成测试用例
4. 输出到 `output/current/test-cases/订单功能-xmind.md`

---

## 注意事项

### 图片处理错误案例分析（CRM需求）

**问题**：
1. 没有从Word文档提取内嵌图片
2. 没有进行AI视觉分析
3. 图片没有放到output/images/目录
4. 生成的测试用例缺少界面元素验证

**根因**：
- Step 2 图片处理流程不明确
- 没有强制检查点
- 未建立images-content.md文件

**解决方案**（已更新到流程）：
1. **新增检查点**：Step 4 增加3个图片处理强制检查点
2. **新增文档**：`references/guides/image-extraction-guide.md`
3. **更新检查清单**：执行检查清单增加8项图片相关检查
4. **明确流程**：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~9 → Step 1~15；新增歧义清单收集输出；修正输出文件头部规范；cc-connect 歧义流程不遗漏 |
| 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） |