| name | test-case-writer-plus |
| description | 专为跨境电商ERP业务设计，支持多平台通用测试用例生成，并能针对特定平台（如UpSeller）进行深入设计；根据API定义或需求文档自动生成高质量测试用例，覆盖多平台订单同步、库存管理、商品同步、物流发货、财务对账、VIP套餐、采购单管理、税务合规等核心场景；当用户需要生成测试用例、编写测试用例文档、设计测试覆盖方案或进行缺陷驱动测试时使用 |
测试用例生成器
执行入口
立即跳转到执行引擎：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 必须加载）
Pattern 层（按优先级加载）
规则与约束
格式规范
质量保障
知识支撑（按需加载）
缺陷根因分析已整合到 knowledge/common.md 中，不再单独引用。
平台特定规则（UpSeller）
UpSeller 平台规则文件暂未部署到 references/platforms/upseller/，相关业务知识已整合到 knowledge/ 模块文件中。模板资源中的 VIP、采购、税务用例模板可直接使用。
模板资源（Templates）
专项测试领域（按需加载）
关键禁令
-
图片处理强制流程（最容易遗漏）
- 检测 → 提取 → AI视觉分析 → 输出到
extracted/images-content.md
- 闸门未通过禁止进入下一步
- 参考：
references/guides/image-extraction-guide.md
-
需求验证强制步骤
- 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/19 → Step 115；新增歧义清单收集输出；修正输出文件头部规范；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） |
