devlab-srv-test-apilisted
Install: claude install-skill seed-forge/harness-ai-kit
# Service API 测试专家技能
**专注后端微服务 API 的自动化测试能力。**
支持 REST/GraphQL/OpenAPI 规范的接口测试，覆盖身份认证、数据一致性、链路追踪等核心场景。
---
## 触发条件
当用户提到以下关键词时触发此 Skill：
- "API 测试" / "接口测试" / "interface testing"
- "OpenAPI 测试" / "Swagger 测试"
- "微服务集成测试" / "microservice integration test"
- "REST API 验证" / "GraphQL schema test"
- "认证授权测试" / "authn/authz testing"
---
## 技术栈依赖
### 核心 CLI
```bash
# Node.js 环境
npm install -D jest supertest supertest-fetch
# Python 环境（可选）
pip install pytest requests-mock
# Java 环境（可选）
mvn add dependency:rest-assured
```
### 辅助工具
```bash
# Mock Server（推荐）
npm install -D msw
# 数据生成
npm install -D faker @faker-js/faker
# Schema 验证
npm install -D ajv zod
```
---
## 功能范围
### Phase 1: API Schema 分析与测试点提取
**输入**：
- OpenAPI/Swagger YAML 文档
- （可选）现有 API 客户端代码
- （可选）业务需求描述
**输出**：
- `specs/api-endpoints.md` — 接口清单与测试点
- `specs/data-contracts.md` — 数据模型定义
- `specs/auth-scenarios.md` — 认证授权场景
#### Step 1.1: OpenAPI 解析算法
```typescript
interface OpenAPIAnalysis {
endpoints: {
method: 'GET' | 'POST' | 'PUT' | 'DELETE';
path: string;
operationId: string;
summary: string;
parameters: Parameter[];
requestBody?: RequestBody;
responses: Response[];
security?: SecurityRequirement[];
}[];
schemas: {
[key: string]: {
type: 'object' | 'array' | 'string' | 'number' | 'boolean';
properties?: Record<string, any>;
required?: string[];
};
};
securitySchemes: {
[key: string]: {
type: 'apiKey' | 'http' | 'oaut