Test Case Creation

Test Case Creation

帮助AI在进行功能测试时，快速分析、总结测试方法，形成结构化的测试用例文档，方便跨项目复用。

技能目标

核心原则：当进行任何功能测试时（API测试、UI测试、E2E测试等），自动将测试过程形成结构化文档，保存到项目 tests/ 目录下，方便下次复用。

目录结构

测试用例是可执行的脚本文件，保存在项目的 tests/test-cases/ 目录下：

{项目根目录}/tests/
├── run.sh                    # 统一运行器
├── test-cases/              # 测试用例目录
│   ├── api/                # API测试
│   │   ├── webdav-list.sh
│   │   └── compress.sh
│   ├── ui/                 # UI测试
│   │   └── login.sh
│   └── performance/         # 性能测试
│       └── benchmark.sh
├── examples/                 # 各类语言示例（按需）
│   ├── php/                # PHP项目示例
│   ├── go/                 # Go项目示例
│   └── python/             # Python项目示例
└── reports/                  # 测试报告

注意：

• 优先使用Shell脚本（.sh）
• 其他语言根据项目需要自行创建（如PHP项目用PHP测试）
• 脚本头部包含知识库注释

通用变量占位符

认证方案

测试用例支持多种认证方式：

1. Bearer Token (JWT)

# Header认证
-H "Authorization: Bearer $TOKEN"

2. Basic Auth

# Base64编码的用户名密码
-H "Authorization: Basic $(echo -n 'user:password' | base64)"

3. API Key

# 常见形式
-H "X-API-Key: $API_KEY"
# 或
-H "X-Auth-Token: $API_KEY"

4. Cookie认证

# Cookie
-H "Cookie: session_id=$SESSION_ID"

5. OAuth2

# Access Token (与Bearer相同)
-H "Authorization: Bearer $ACCESS_TOKEN"

# 或携带refresh_token
-d "grant_type=refresh_token&refresh_token=$REFRESH_TOKEN"

认证变量

认证获取方式

触发场景

工作流程

接收测试任务
    │
    ▼
分析测试需求
    ├─ 测试类型 (API/UI/E2E/Integration/Stress)
    ├─ 测试优先级 (P0/P1/P2)
    └─ 涉及模块
    │
    ▼
搜索现有测试用例
    │ (在项目 tests/test-cases/ 目录下搜索)
    │
    ▼
选择模板并创建/更新用例
    ├─ 填写测试步骤
    ├─ 记录预期结果
    └─ 添加验证方法
    │
    ▼
保存到项目tests目录
    │ tests/test-cases/{类型}/{模块}/{名称}.md
    │
    ▼
更新项目索引
    │
    ▼
输出执行摘要

测试用例结构

每个测试用例是一个可执行的脚本文件，知识库通过注释形式包含在脚本头部：

#!/bin/bash
#========================================
# 测试用例: W7Panel登录测试
#========================================
#
# ## 测试信息
# | 项目 | 内容 |
# |------|------|
# | 测试类型 | UI |
# | 优先级 | P0 |
#
# ## 测试目的
# 验证用户登录功能
#
# ## 前置条件
# - [ ] 服务已启动
# - [ ] 验证码已禁用
#
# ## 测试步骤
# 1. 打开登录页
# 2. 填写用户名密码
# 3. 点击登录
# 4. 验证跳转
#
# ## 预期结果
# - 登录成功，跳转到首页
#
#========================================

# 测试代码开始
BASE_URL="${BASE_URL:-http://localhost:8080}"

agent-browser open "$BASE_URL"
# ...

注意：知识库以 # 注释开头，使用Markdown格式，方便阅读和检索。

分类标准

按测试类型

按功能模块

按优先级

输出格式

创建测试用例后，输出标准摘要：

✅ 测试用例已创建: examples/authentication/login.md

📋 测试摘要
├── 类型: API
├── 优先级: P0
├── 步骤数: 3
├── 预计耗时: 30秒
└── 依赖: $TOKEN, $BASE_URL

📝 快速执行
curl -X POST "$BASE_URL/api/login" -d '{"user":"admin"}'

🔍 查找相关测试
bash scripts/search.sh login

模板选择

注意：

• 优先使用Shell脚本（.sh）
• 其他语言根据项目需要自行创建（如PHP项目用PHP测试）
• 脚本头部包含知识库注释

辅助命令

# 创建新测试用例 (保存到项目 tests/test-cases/)
bash scripts/new-test.sh api login

# 搜索测试用例
bash scripts/search.sh login

# 搜索特定类型
bash scripts/search.sh --type api

# 搜索特定优先级
bash scripts/search.sh --priority P0

# 生成索引
bash scripts/index.sh

最佳实践

1. 测试前先搜索 - 避免重复创建已有用例
2. 使用通用变量 - 不硬编码具体值
3. 记录边界条件 - 便于回归测试
4. 及时更新 - 发现问题立即更新用例
5. 保持简洁 - 步骤清晰，避免冗余

测试报告

当测试完成后，需要生成测试报告，保存到项目的 tests/reports/ 目录下。

报告目录结构

{项目根目录}/tests/
├── test-cases/              # 测试用例
│   ├── api/
│   ├── ui/
│   └── performance/
├── reports/                  # 测试报告 (按分类)
│   ├── api/                # API测试报告
│   │   └── 2024-01-01-login.md
│   ├── ui/                 # UI测试报告
│   │   └── 2024-01-01-panel.md
│   └── performance/        # 性能测试报告
│       └── 2024-01-01-webdav.md
└── INDEX.md                # 测试用例索引

报告模板

---
id: {唯一标识}
title: {测试报告标题}
type: API | UI | Performance
date: {测试日期}
status: PASS | FAIL | PARTIAL
---

# {测试报告标题}

## 测试概要

| 项目 | 内容 |
|------|------|
| 测试日期 | YYYY-MM-DD |
| 测试类型 | API / UI / Performance |
| 测试结果 | PASS / FAIL / PARTIAL |
| 测试人员 | AI |

## 测试环境

| 环境 | 说明 |
|------|------|
| 服务地址 | $BASE_URL |
| Token | $TOKEN |

## 测试结果

### 通过项 ✅

- [ ] 测试项1
- [ ] 测试项2

### 失败项 ❌

- [ ] 测试项3
  - 错误信息: xxx
  - 截图: /path/to/screenshot.png

### 未通过项 ⚠️

- [ ] 测试项4
  - 原因: 待确认

## 问题清单

| 问题ID | 严重程度 | 描述 | 状态 |
|--------|----------|------|------|
| BUG-001 | High | 描述 | Open |
| BUG-002 | Medium | 描述 | Resolved |

## 测试截图

- [截图1](./screenshots/1.png)
- [截图2](./screenshots/2.png)

## 修改建议

{改进建议}

## 相关测试用例

- [测试用例链接](../test-cases/xxx.md)

报告分类

报告命名规范

{日期}-{模块}-{测试类型}.md

示例:
2024-01-01-login-api.md
2024-01-02-panel-ui.md
2024-01-03-webdav-perf.md

与agent-browser联动

测试用例通过 agent-browser 执行。

常用命令映射

测试用例执行示例

#!/bin/bash
# 执行测试用例

BASE_URL="${BASE_URL:-http://localhost:8080}"
WAIT_TIME="${WAIT_TIME:-5}"

# 打开页面
agent-browser open "$BASE_URL"
sleep $WAIT_TIME

# 获取可交互元素
agent-browser snapshot -i

# 执行操作
agent-browser fill @e1 "testuser"
agent-browser fill @e2 "password"
agent-browser click @e3

sleep 2

# 验证结果
agent-browser get url

# 关闭浏览器
agent-browser close

API测试执行

#!/bin/bash
# 执行API测试

BASE_URL="${BASE_URL:-http://localhost:8080}"
TOKEN="${TOKEN:-your_token}"

# GET请求
curl -X GET "$BASE_URL/api/data" \
  -H "Authorization: Bearer $TOKEN"

# POST请求
curl -X POST "$BASE_URL/api/data" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"test"}'