230-test-case-dev

name: 230-test-case-dev description: 自动化测试开发。当需要开发自动化测试时触发：(1)按类型逐批交付测试脚本, (2)覆盖API/E2E/压力/安全测试, (3)执行脚本并验证通过。 alwaysApply: false author: "axeon(23231269@qq.com)" version: "3.0.0"

自动化测试开发

项目环境检测

从当前目录向上查找 project-info.md，最多 3 层，找到后记为 PROJECT_ROOT。详见 检测方法与前置检查。未找到 → 提示用户先执行 0-init。

角色职责

输入

字段一致性原则

全链路字段命名一致，E2E 测试无需额外 data-testid。

四类测试技术栈

架构约定速查表

选择器策略

API 测试断言

JMeter 配置

工作流程

Phase 0: 需求分析

Phase 1: 环境准备

cd PROJECT_ROOT/test/scripts
pnpm init
pnpm add @playwright/test @faker-js/faker
pnpm playwright install

Playwright 配置（API + E2E 双项目）：

export default defineConfig({
  projects: [
    { name: 'api', testDir: './api', use: { baseURL: process.env.API_BASE_URL } },
    { name: 'e2e', testDir: './e2e', use: { baseURL: process.env.WEB_BASE_URL, ...devices['Desktop Chrome'] } },
  ],
});

Phase 2: 逐类型完整交付

四类测试天然独立（不同目录），按类型逐批交付。每类测试的用例设计和脚本实现同步完成。

2.1 API 测试

用例规范：TC-API-{module}-{seq}，每个接口 ≥ 1 正常 + 1 异常用例。

2.2 E2E 测试

用例规范：TC-E2E-{module}-{seq}，每个页面 ≥ 1 冒烟用例。

2.3 JMeter 压测

SLA 指标模板见 load-metrics.md，JMeter 完整模板见 jmeter-template.md。

2.4 安全测试

安全检查清单见 security-checklist.md，脚本示例见 security-scan.md。

Phase 3: 执行脚本 + 全量验证

全量验证：

cd PROJECT_ROOT/test/scripts
pnpm tsc --noEmit                                    # TypeScript 编译无错误
grep -rn 'data-testid' . --include="*.ts" | wc -l   # 0 行
pnpm playwright test --list                           # 所有用例可列出

开发模式

完成标准

• test/design/ 下四类测试设计文档齐全
• API 测试覆盖所有 Controller 接口，三重断言
• E2E 测试覆盖所有页面，字段一致性选择器
• JMeter 4 种场景齐全，SLA 指标合理
• 安全测试 OWASP Top 10 覆盖
• bin/ 执行脚本齐全
• pnpm tsc --noEmit 通过，无 data-testid
• pnpm playwright test 全部通过

⚠️ 完成验证（强制，全自动执行）

1. 强制执行全量验证（Phase 3 检查项）
2. 强制调用 231-test-case-dev-review
3. 不通过（< 95）→ 自动修复 → 重新评审（最多 5 轮）
4. 通过（≥ 95）→ 向用户报告最终结果

全自动执行：中间不暂停、不询问、不汇报。未通过前禁止结束。

参考

• 测试用例模板
• 设计方法
• 压测SLA指标模板
• 安全测试检查清单
• 脚本示例
• JMeter脚本模板
• 安全扫描脚本