api-lazy-tester

name	api-lazy-tester
description	接口测试 - 帮懒人测试接口。触发：用户请求测试接口、测试新写的接口
argument-hint	["描述要测试的接口或模块"]
disable-model-invocation	true
allowed-tools	Bash, Read, Glob, Grep
effort	medium

接口测试，交给 AI

当用户请求测试接口时，按以下流程执行。

完整工作流（自动）

Step 0: 获取 baseUrl（自动）

如果用户没有提供 baseUrl，尝试自动读取：

方式 1: 从配置文件读取

# 读取 application.yml 中的 server.servlet.context-path 和 server.port
grep -E "server:(.|[\n\r])*port:" src/main/resources/application.yml
grep -E "server:(.|[\n\r])*servlet:(.|[\n\r])*context-path:" src/main/resources/application.yml

# 常见位置
# - src/main/resources/application.yml
# - src/main/resources/application-local.yml
# - src/main/resources/application-dev.yml
# - .env

方式 2: 从启动类读取

# 找 @SpringBootApplication 类的端口配置
grep -r "server.port" src/main/

方式 3: 默认值

• 如果都找不到，使用 http://localhost:8080

Step 1: 发现新接口

当用户说"测试新写的接口"时，首先执行：

# 找出本次新增/修改的文件
git diff --name-only HEAD~1

# 或对比分支（更准确）
git diff --name-only origin/main...HEAD

找到新增的 *Controller.java 文件，重点关注。

Step 2: 读取接口定义

按优先级读取接口信息：

优先级 1: OpenAPI/Swagger

find . -type f \( -name "openapi.yaml" -o -name "openapi.json" -o -name "swagger.yaml" -o -name "swagger.json" \) 2>/dev/null

优先级 2: Controller 源码

# 找到新写的 Controller（从 git diff 结果）
git diff --name-only HEAD~1 | grep -i controller

# 读取新增的接口方法
grep -A 10 "@RequestMapping\|@GetMapping\|@PostMapping\|@PutMapping\|@DeleteMapping" 新增的Controller文件

优先级 3: DTO 源码

# 找到相关的 DTO
git diff --name-only HEAD~1 | grep -i -E "(DTO|Entity|Request|Response|VO)"

Step 3: 生成测试用例

根据接口定义生成测试数据：

// 正常用例 - 最小合法数据
{"username": "a", "password": "123456"}

// 边界用例 - 根据注解
// @NotNull → 传 null / 不传该字段
// @Size(min=2) → 传 "a"（1字符）
// @Min(0) → 传 -1
// @Pattern(regexp="^\\d+$") → 传 "abc"

// 负例
// 空字符串 ""
// 空对象 {}

Step 4: 执行测试

使用脚本执行请求：

${CLAUDE_SKILL_DIR}/scripts/test-api.sh \
  -m POST \
  -u "http://localhost:8080/api/xxx" \
  -t "Bearer 用户提供的token" \
  -b '{"测试数据"}' \
  -T 30

Step 5: 输出报告

测试结果输出为可读格式：

✅ POST /api/user/login - 通过 3/3
├── 正常登录 - 200 ✓
├── 用户名为空 - 400 ✓
└── 密码错误 - 401 ✓

用户输入处理

用户输入	AI 行为
只说"测试新接口"	自动读取配置文件获取 baseUrl + git diff 找接口
"测试 POST /api/xxx"	直接测指定接口
"测试 localhost:8080 的接口"	使用用户提供的 baseUrl
"测试 http://api.com 接口"	使用用户提供的 baseUrl

注意: token 必须由用户提供（无法自动获取）

重要约束

1. token 必须由用户提供 - 禁止自动获取
2. 禁止执行 DELETE - 除非用户明确确认
3. 先测试读接口 - GET 优先，再测写接口
4. 默认超时 30 秒

脚本参数速查

参数	说明	示例
-m	HTTP 方法	GET/POST/PUT/DELETE
-u	完整 URL	https://api.com/api/login
-t	Token	Bearer xxx
-b	请求体	'{"key":"value"}'
-T	超时秒	30

快速验证

# 先验证脚本可用
${CLAUDE_SKILL_DIR}/scripts/test-api.sh -m GET -u "https://jsonplaceholder.typicode.com/posts/1" -t "test"

相关文档

• 快速开始
• AI 接口测试工作流
• 使用说明