前言¶

接口联调阶段最常见的问题是：文档里的接口清单和测试用例分属两套体系，改一个参数就要重新手测一遍，鉴权过期、幂等失效、并发写入这类问题往往到上线前才暴露。手动在 Postman 里点接口，难以覆盖边界值和错误响应；写一堆一次性脚本，又很快失去维护价值。

下面介绍的 Skill「API 接口测试」针对的就是这个问题：从 OpenAPI/Swagger 文档或用例 Schema 出发，把可自动化的接口用例变成可执行的测试脚本，并保留运行结果作为证据。

这是什么¶

「API 接口测试」是一个接口级测试 Skill，坐标 @user_fa905b36/api-testing，当前版本 0.5.0，来源为 community，发布者 user_fa905b36，分类 dev-programming。

它解决的问题是：接口用例的来源（接口文档、用例 Schema）和接口用例的执行（脚本、请求、断言、结果）之间存在断层。Skill 把这两端接起来，产出可执行的 API 测试脚本与运行结果。

需要明确的是它的边界：它不负责 Web UI 流程（这类需求对应 automated-e2e-testing），也不负责手动用例的编写（对应 test-case-writing）。

核心能力¶

根据官方简介，Skill 覆盖的测试维度包括：

1、参数：入参取值、必填性、类型与格式。
2、边界：边界值与临界条件。
3、鉴权：认证与权限校验路径。
4、幂等：重复提交、重试是否产生副作用。
5、并发：并发请求下的行为。
6、错误响应：异常入参与异常路径下的返回。
7、数据一致性：调用前后数据状态是否一致。

产出物是两份：可执行的 API 测试脚本，以及运行结果。

官方标注 requires_api_key=true，说明启用该 Skill 需要配置 API Key。

安装与启用¶

需要说明的是，本次抓取的官方页面未能获取到具体的安装命令，因此这里不给出处不明的命令。根据资料，Skill 基于通用 SKILL.md 格式，地址为：

https://api.skillhub.cn/user_fa905b36/api-testing

通用的启用方式是把 SKILL.md 及其附带文件放进 Agent 可读取的 Skills 目录，或在支持 SkillHub 的客户端里按坐标 @user_fa905b36/api-testing 添加。Cursor、Codex CLI、Claude Code 的具体接入方式以各自客户端的 Skills 支持情况为准，官方页面抓取失败的情况下不建议照抄网上的目录路径。

建议启用前先确认 API Key 已配置，并核对 Skill 分类是否与项目语言匹配（本项目为 dev-programming）。

典型用法¶

官方简介给出的工作链路是「文档/Schema → 可自动化用例 → 脚本 → 运行结果」。按这个链路，在项目中的实际用法可以拆成几步：

1、准备接口定义：把 OpenAPI/Swagger 文档或用例 Schema 放到 Agent 可读取的位置，作为用例来源。
2、梳理可自动化用例：从文档中识别出可以参数化执行的用例，覆盖上述参数、边界、鉴权、幂等、并发、错误响应与数据一致性维度。
3、生成测试脚本：由 Skill 产出可直接执行的 API 测试脚本，脚本中应包含请求构造与结果断言。
4、执行并留存结果：运行脚本，保留运行结果，作为本次接口测试的证据。

执行命令的具体内容取决于生成的脚本本身，官方资料未给出固定命令，这一步以生成出来的脚本为准。

适用场景与注意¶

适合的场景：接口定义已经以 OpenAPI/Swagger 文档或 Schema 形式存在，测试重点在参数、边界、鉴权、幂等、并发、错误响应和数据一致性，且希望测试脚本可以重复执行、长期维护。

不适合的场景：UI 层的端到端流程，请用 automated-e2e-testing；需要人工设计与评审的用例编写，请用 test-case-writing。

使用时的注意事项：

1、该 Skill 来源为 community，发布者 user_fa905b36，引入生产流程前建议先在小范围接口上试跑。
2、并发与幂等类用例可能产生真实副作用，建议在测试环境执行。
3、接口文档变更后，需要重新生成或更新测试脚本，否则脚本会与文档脱节。
4、资料中评分为 100000、下载 1436 次、安装 0，安装数为 0 意味着公开使用样本有限，效果验证需要自己跑。

结尾¶

「API 接口测试」的价值在于把接口级测试的用例生成与执行收进同一套流程，产出的脚本可以重复运行，运行结果可以直接作为验证依据。如果你的测试瓶颈在于接口用例分散在文档和脑子里、跑一次全靠手点，可以从这个 Skill 入手试一轮。

官方地址：https://api.skillhub.cn/user_fa905b36/api-testing