# api-tester

Adopt this skill: https://proskills.md/skills/other/laolaoshiren-claude-code-skills-zh-skills-api-tester

Page: https://proskills.md/skills/other/laolaoshiren-claude-code-skills-zh-skills-api-tester
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/api-tester/SKILL.md
size: 5504
sha: 756ad13b9b0d0774894654b334cd89dd99988982
upstream: https://github.com/laolaoshiren/claude-code-skills-zh/blob/main/skills/api-tester/SKILL.md

````text
---
name: api-tester
description: 依据真实 OpenAPI、路由实现和现有测试生成并验证 API 测试。用于用户要求测试接口、补集成测试、验证 API 契约、生成回归用例或排查接口兼容性时；区分“生成测试”和“执行请求”的授权，不猜测状态码、响应结构或 SLA，不在未确认环境中发送写请求。
---

# API 测试助手

## 核心原则

- 只把可核验的 OpenAPI、代码、类型、调用方或现有测试当作契约证据。
- 生成测试不等于执行测试；读取接口定义不等于可以访问真实服务。
- 保护现有数据、凭据和用户修改，优先使用隔离且可清理的测试环境。

## 工作流程

### 1. 读取项目与接口证据

先读取适用的仓库规则、测试说明、Git 状态和项目脚本，再按实际存在情况检查：

- OpenAPI / Swagger 文件及其引用的 Schema。
- 路由、controller、handler、DTO、验证器和错误处理中间件。
- 客户端类型、调用方、公开文档和现有 API 测试。
- 测试配置、fixture、认证方式、环境变量模板和数据清理机制。

记录规范、实现与现有测试之间的不一致。无法确定哪个行为才是期望契约时，列出证据并请求确认，不用新测试固化猜测。

### 2. 建立契约矩阵

为目标 endpoint 记录：

| 项目 | 证据 |
|------|------|
| method 与 path | OpenAPI 或路由位置 |
| 认证与权限 | security scheme、中间件或调用方 |
| 请求参数与约束 | Schema、DTO 或验证器 |
| 已声明响应 | 状态码、响应结构与 header |
| 副作用与幂等性 | 实现、文档或调用链 |
| 测试环境与清理 | fixture、事务或 teardown |

不要默认每个接口都应返回 `400`、`401`、`403`、`404`、`422` 或 `500`。只有契约已声明或代码路径真实可达时才生成对应断言。

### 3. 明确环境与授权

在执行任何请求前确认：

- Base URL、环境归属以及是否为 local、test、staging 或 production。
- 测试账号、权限范围和凭据来源。
- 是否允许执行 POST、PUT、PATCH、DELETE、上传、支付、通知等有副作用操作。
- 测试数据隔离、唯一标识、清理或事务回滚方案。

用户只要求“生成测试”时只产出代码。生产环境、共享 staging、第三方服务及任何可能改变真实数据的执行都必须获得明确授权。GET 也不能仅凭 method 判定无副作用。

### 4. 选择项目锁定的工具

- 优先运行仓库已有的 test、OpenAPI lint 或 contract test script。
- 读取 package manager、lockfile 和已安装版本后再选择命令。
- 不用裸 `npx`、全局工具或临时下载的最新版解析规范。
- 缺少依赖时先报告；安装工具、更新 lockfile 或修改测试配置需要单独授权。
- 使用真正的 YAML / JSON / OpenAPI 解析器，不用 `grep` 推断嵌套 Schema。

### 5. 设计有依据的用例

按目标契约选择必要场景：

- 成功路径：使用最小合法输入验证状态、结构和关键语义。
- 边界路径：只测试 Schema 或实现中真实存在的长度、范围、枚举、格式和必填约束。
- 认证与权限：只覆盖已声明的身份、角色和资源归属规则。
- 失败与回归：覆盖可达错误路径、已知缺陷或兼容性要求。
- 幂等、分页、并发、重试与超时：仅在接口契约包含这些语义时测试。

断言外部可观察行为，避免绑定内部函数调用。随机数据应固定 seed，并避免真实个人信息、客户数据和生产标识。

### 6. 实现最小测试

- 沿用项目现有框架、目录、fixture、命名和断言风格。
- 单元测试可隔离网络、时间和第三方服务；集成测试使用受控服务或临时资源。
- 对写操作使用唯一数据，并在成功、失败和中断路径都执行清理。
- 不为让测试通过而擅自修改生产代码、接口规范或认证配置。
- 使用跨平台路径和项目脚本；平台专属命令需说明 Windows / Linux 适用范围。

### 7. 执行与复验

1. 先检查命令是否会下载依赖、访问外部服务或改变共享状态。
2. 运行最小目标测试，记录命令、环境、退出状态和真实响应摘要。
3. 按风险运行相关测试、类型检查或完整测试。
4. 检查 Git diff 和环境状态，确认没有残留测试数据、快照、日志、Token 或无关生成物。
5. 将基线已有失败与本轮新增失败分开报告。

没有实际运行时，只能说明“已生成、未验证”。没有明确 SLA 和受控测量条件时，不添加固定耗时断言或声称性能达标。

## 安全边界

- 不在命令、日志、fixture 或报告中写入真实 Token、Cookie、密码和个人数据。
- 未经明确授权，不访问生产环境、真实客户账号、付费 API 或受监管系统。
- 压测、模糊测试、大批量数据生成和安全探测需要单独授权及限流方案。
- 遇到权限不足、环境不明、清理方案缺失或响应可能含敏感信息时停止执行并报告。

## 输出

```markdown
## API 测试结果

- 目标接口与契约证据：
- 环境与授权范围：
- 新增或修改文件：

## 用例

| 场景 | 契约依据 | 是否执行 | 结果 |
|------|----------|----------|------|

## 验证

- 实际命令与退出状态：
- 数据清理：
- 基线已有失败：
- 未确认契约与限制：
```
````

## File: README.md
upstream: https://github.com/laolaoshiren/claude-code-skills-zh/blob/main/README.md

````text
# 🛠️ Claude Code Skills 中文精选集

> 🚀 最实用的 Claude Code Skills / Agents / Plugins 合集 | 精选 443+ | 按场景分类 | 复制即装 | 持续更新

[![Stars](https://img.shields.io/github/stars/laolaoshiren/claude-code-skills-zh?style=social)](https://github.com/laolaoshiren/claude-code-skills-zh)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Skills](https://img.shields.io/badge/skills-443%2B-green.svg)](#original-skills)
[![Updated](https://img.shields.io/badge/updated-2026--11--11-brightgreen.svg)](https://github.com/laolaoshiren/claude-code-skills-zh/commits/main)
[![Website](https://img.shields.io/badge/website-claude--skills.bt199.com-6c5ce7.svg)](https://claude-skills.bt199.com)

**中文开发者最好的 Claude Code Skills 资源站。** 不只是列表，更包含可直接安装的原创技能包。

## 🀄 为什么是「中文」精选

- 📖 **说明用中文**：每条都写清解决什么场景、怎么安装、有什么限制和风险，不用先啃一遍英文 README。
- 🇨🇳 **中文场景单独成类**：公众号、小红书、飞书、企业微信、B 站、抖音等国内平台技能有独立分类，不用在英文列表里大海捞针。
- 🎁 **原创中文技能**：本仓库自研、针对中文语境优化的 Skill，一条命令装完。
- ✅ **收录看中文价值**：每个条目都要说明「对中文用户有什么用」，纯英文且说不清价值的项目不放在热门位。

## ⚡ 一条命令安装全部原创技能

在 Claude Code 里输入（需要 2.1+）：

```bash
/plugin marketplace add laolaoshiren/claude-code-skills-zh
/plugin install zh-skills@claude-code-skills-zh
```

装完后，当你让它审查代码、写 README、跑 API 测试、做重构或性能分析时，对应技能会自动触发。

> 不想用插件也行：`git clone https://github.com/laolaoshiren/claude-code-skills-zh.git && cp -r claude-code-skills-zh/skills/* ~/.claude/skills/`

<!-- fact-summary -->
## 📌 一句话事实

**claude-code-skills-zh（Claude Code Skills 中文精选集）** 是面向中文开发者的 Claude Code Skills / Agents / Plugins 精选仓库：**443+** 个精选技能按场景分类（平台运营、开发效率、内容创作、学术科研、AI Agent、金融/商业、中文专属等），另含 **21 个**可直接安装的原创中文技能，复制即装，MIT 许可，持续更新。

**English:** claude-code-skills-zh is a curated GitHub repository of 443+ Claude Code Skills, Agents and Plugins for Chinese-speaking developers, organized by scenario with Chinese documentation, plus 21 original install-ready skills (zh-code-reviewer, zh-readme, api-tester, and more). MIT licensed, updated continuously.

- 仓库：https://github.com/laolaoshiren/claude-code-skills-zh
- 官网：https://claude-skills.bt199.com
- 适合：使用 Claude Code、Codex、Gemini CLI、Cursor 的中文开发者与团队

---

适合这几类人直接拿去用：
- 👨‍💻 想给 Claude Code **快速补齐专业能力** 的开发者
- 📦 想找 **中文可读、复制即装** skills 的个人开发者 / 团队
- 🎯 想用现成技能解决 **代码审查、README、API 测试、性能分析、重构建议** 等高频场景的人

> 🆕 **新上架**：[ai-video-producer](skills/ai-video-producer/) — 把一句话选题做成可发布的 AI 视频。八阶段流水线（调研 → 提案 → 脚本 → 分镜 → 素材 → 剪辑 → 合成 → 导出），内置中文口播语速、中文字幕断句、抖音/B站/小红书多平台尺寸，以及「反盲盒抽卡」的成本门禁；零基础与专业两档都能用。

**✨ 如果你是第一次接触这个仓库，建议先看这 5 个最值得马上装的原创技能：**
- 🔍 [zh-code-reviewer](skills/zh-code-reviewer/) — 中文代码审查，直接输出中文审查报告
- 📝 [zh-readme](skills/zh-readme/) — 先分析项目，再写更像人写的中文 README
- 🧪 [api-tester](skills/api-tester/) — 依据真实契约，在确认环境与授权后生成并验证 API 测试
- ♻️ [refactor-advisor](skills/refactor-advisor/) — 找坏味道，给出可执行重构建议
- ⚡ [perf-profiler](skills/perf-profiler/) — 用可复现基线和 profiler 证据定位性能瓶颈

🔗 **官网**：[claude-skills.bt199.com](https://claude-skills.bt199.com)

---

<!-- quick-nav -->
## 🧭 快捷导航

| 分类 | 一句话说明 | 常见场景 |
|------|-----------|----------|
| [🏆 热门与高潜](#cat-star) | 社区高星与高潜项目 | 想先看最好的 |
| [📣 平台运营 / 自媒体](#cat-platform) | 公众号、小红书、飞书、企业微信 | 国内平台运营 |
| [💻 开发效率](#cat-dev) | 代码审查、测试、重构、CI/CD、脚手架 | 提升编码效率 |
| [🎨 内容创作](#cat-creative) | 写作、视频、设计、PPT | 做内容与设计 |
| [🔬 学术科研](#cat-academic) | 论文、数据分析、科研工作流 | 科研与数据分析 |
| [🤖 AI Agent](#cat-agent) | 多 Agent 编排、记忆、浏览器自动化、技能市场 | 搭 Agent 工作流 |
| [💰 金融 / 商业](#cat-finance) | 投研、财报、增长与商业化 | 金融与商业分析 |
| [🌏 中文专属](#cat-chinese) | 为中文场景专门打造 | 找中文优化项目 |

**其他常用入口：** [🎁 原创技能](#original-skills) · [📦 快速安装](#original-install) · [⚡ 30 秒上手](#quick-start) · [📖 什么是 Skills](#what-is-skills) · [✍️ 自己写 Skill](#how-to-create) · [🤝 贡献](#contributing) · [📊 维护手册](docs/MAINTENANCE.md)

> 💡 用 `Ctrl/Cmd + F` 按关键词定位，或访问 [官网](https://claude-skills.bt199.com) 用 Tab 分类筛选。

---

## 📊 同类仓库对比

星数为查询时点数据，仅供了解生态规模，会随时间变化；本仓库自身星数以顶部动态徽章为准。

| 仓库 | Stars | 规模 | 语言 | 定位 |
|---|---|---|---|---|
| [anthropics/skills](https://github.com/anthropics/skills) | 182.7K | 官方技能集 | 英文 | Anthropic 官方出品，通用场景 |
| [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) | 77.6K | 1000+ | 英文 | 大而全的英文精选列表 |
| [hesreallyhim/awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | 56.2K | 资源大全 | 英文 | 偏 Claude Code 整体资源导航 |
| [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills) | 36.1K | 1000+ | 英文 | 官方团队与社区技能合集 |
| [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills) | 28.5K | 380 | 英文 | 工程 / 产品 / 营销方向分类 |
| **claude-code-skills-zh（本仓库）** | 见[顶部徽章](https://github.com/laolaoshiren/claude-code-skills-zh) | 438+ 精选 + 20 原创 | **中文** | 按中文开发者场景分类，含国内平台技能与原创中文技能 |

怎么选：想找英文生态的完整清单，看上面几个大型仓库；需要中文说明、国内平台场景（公众号 / 小红书 / 飞书 / 企业微信）和复制即装的原创技能，用本仓库。两者可互补，不冲突。

---

## 🚀 为什么这个仓库值得现在就收藏

- **不是只做导航**：既有高质量第三方精选，也有能直接安装的原创技能
- **中文友好**：很多说明直接面向中文开发者，不用自己二次理解
- **高频场景覆盖全**：代码审查、文档、测试、安全、性能、重构、CI/CD 都覆盖
- **持续维护**：定期补新技能、更新 README、官网和分类结构

---

<a id="what-is-skills"></a>
## 📖 什么是 Claude Code Skills？

Claude Code Skills 是可复用的指令模块，让 Claude Code 拥有特定领域的专业能力。只需一个 `SKILL.md` 文件，就能让 Claude 变成代码审查专家、安全审计师、文档写手…

<a id="quick-start"></a>
### ⚡ 30 秒上手建议

第一次用，直接装上面列的 5 个原创技能即可（`zh-code-reviewer`、`zh-readme`、`api-tester`、`refactor-advisor`、`perf-profiler`），然后：

```bash
# GitHub 原生地址
git clone https://github.com/laolaoshiren/claude-code-skills-zh.git
cp -r claude-code-skills-zh/skills/* ~/.claude/skills/

# 国内镜像（GitHub 访问困难时使用）
git clone https://gh-proxy.com/https://github.com/laolaoshiren/claude-code-skills-zh.git
cp -r claude-code-skills-zh/skills/* ~/.claude/skills/

# 或直接下载 ZIP（无需 git）
# https://github.com/laolaoshiren/claude-code-skills-zh/archive/main.zip
# 国内镜像：https://gh-proxy.com/https://github.com/laolaoshiren/claude-code-skills-zh/archive/main.zip
```

---

## ⭐ 精选第三方技能

> **怎么读这份列表**：每条描述都以「对中文用户有什么用」为落点，而不是照搬英文简介。带 **🇨🇳** 标记的项目提供中文文档或中文官网；没有标记的项目多为英文文档，但描述里会写明它对中文读者的实际收益——如果连收益都说不清，就不会被收录。

<a id="cat-star"></a>
### 🏆 热门与高潜技能

| 技能 | 说明 | ⭐ |
|------|------|-----|
| [everything-claude-code](https://github.com/affaan-m/ECC) | 🧠 把 Claude Code 变成完整开发环境的全栈技能系统：Skills、记忆、安全与研究驱动开发；想一次补齐整套工作流、又愿意读英文文档的中文开发者可以把它当地图 | 299.8K+ |
| [agentic-awesome-skills](https://github.com/sickn33/agentic-awesome-skills) | 📚 1,900+ 可安装技能库，兼容 Claude Code / Cursor / Codex / Gemini CLI；适合在多个 Agent 之间找可迁移技能的读者，先在这里检索再决定装哪个 | 49.4K+ |
| [ClawX](https://github.com/ValueCell-ai/ClawX) 🇨🇳 | 🖥️ OpenClaw 桌面图形界面：把 CLI Agent 编排变成可视化桌面体验，**中文官网与快速开始完整**，不习惯终端的用户可以先用它入门 | 7.6K+ |
| [obsidian-skills](https://github.com/kepano/obsidian-skills) | 🧠 Obsidian 官方生态技能包：Markdown / Bases / JSON Canvas / CLI / Defuddle，兼容 Claude Code / Codex / OpenCode；用 Obsidian 搭中文知识库的可以直接接入现有笔记流 | 51.2K+ |
| [caveman](https://github.com/JuliusBrussee/caveman) | 🪨 用最少的 token 说最短的话，节省 65% token；按 token 计费或经常撞上下文上限的用户，收益最直观 | 118.5K+ |
| [career-ops](https://github.com/career-ops-hq/career-ops) | 💼 AI 求职系统：14 种技能模式 + Go 仪表盘 + PDF 生成；投递海外岗位、需要批量管理 JD 与简历版本时效率提升明显 | 81.3K+ |
| [graphify](https://github.com/Graphify-Labs/graphify) | 🕸️ 将代码、文档和数据结构转为可查询知识图谱；接手大型遗留项目时，可以先让它把代码库梳理成图谱再动手 | 144.7K+ |
| [marketingskills](https://github.com/coreyhaines31/marketingskills) | 📈 营销技能包：CRO、文案、SEO、数据分析、增长工程；做增长与投放的团队可直接套用框架，中文文案仍需按国内平台习惯本地化 | 59.3K+ |
| [planning-with-files](https://github.com/OthmanAdi/planning-with-files) | 📋 Manus 风格的持久化 Markdown 规划工作流；长任务跨会话容易丢上下文，用它把计划落在文件里最省心 | 28K+ |
| [humanizer](https://github.com/blader/humanizer) | ✍️ 消除 AI 写作痕迹，让文本更自然；主要针对英文写作，中文场景建议用下面的 Humanizer-zh | 66.8K+ |
| [Claude-Code-Game-Studios](https://github.com/Donchitos/Claude-Code-Game-Studios) | 🎮 49 个 AI 代理 + 72 个工作流，完整游戏开发工作室；适合独立开发者快速搭出策划、美术、程序协作流程 | 37.2K+ |
| [open-saas](https://github.com/wasp-lang/open-saas) | 🔥 免费 SaaS 模板，React + Node + Prisma，AI-ready；想做副业或小产品验证时，省掉搭脚手架的一周 | 16.3K+ |
| [ai-guide](https://github.com/liyupi/ai-guide) 🇨🇳 | 🇨🇳 程序员鱼皮 AI 资源大全：Claude Code / Cursor / DeepSeek 全攻略，**纯中文内容**，适合刚接触 AI 编程、想先建立整体认知的读者 | 22K+ |
| [claude-skills](https://github.com/alirezarezvani/claude-skills) | 📦 232+ 技能包，支持 Claude Code / Codex / Gemini CLI / Cursor；按工程、产品、营销分类，适合先挑一套现成能力再按需裁剪 | 29.5K+ |
| [notebooklm-p
````
