test-case-writer-plus

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 必须加载）

文档	职责
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	兼容性测试	"兼容性"、"浏览器"、"移动端"

---

关键禁令

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/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）