前言¶
后端接口一多，功能用例、契约校验和性能摸底往往拆在不同工具里：Postman 管调用，OpenAPI 文档另开一页，测试设计还要对照历史踩坑记录。在 Cursor、Claude Code 等带 Skills 的 Agent 里，更常见的是口头描述「帮我测登录」，却缺少统一的测试定义和陷阱检查清单。
下面介绍 SkillHub 社区技能 API测试自动化专家版（坐标 @user_b91ca78d/api-test-automation-pro，当前版本 1.0.0）。它把 REST/GraphQL 功能测试、文档解析、YAML 用例、性能与契约测试，以及测试点与陷阱知识库收进一套 Skill 工作流，适合在对话里按场景触发，而不是单独再搭一套脚本工程。
这是什么¶
API测试自动化专家版 是 SkillHub 分类 dev-programming 下的社区来源（community）技能，发布者为 user_b91ca78d。页面标注 requires_api_key=false，安装本 Skill 本身不强制配置第三方 API Key。
一句话定位：面向 API 接口测试 的自动化协作专家，覆盖从用例设计、文档对齐到性能与契约验证的多种任务；具体执行仍依赖你当前 Agent 环境与本地/目标服务可达性。
官方入口：
- SkillHub 展示页：https://www.skillhub.cn/skills/user_b91ca78d/api-test-automation-pro
- API 元数据地址：https://api.skillhub.cn/user_b91ca78d/api-test-automation-pro
截至资料抓取时，该技能在 SkillHub 上评分为 100000，下载 1668 次（安装计数为 0，以页面统计为准）。
核心功能¶
以下能力均来自官方简介，未在公开页展开实现细节的部分不展开臆测。
-
REST / GraphQL 功能测试
支持按接口语义组织功能验证，适合登录、注册、CRUD 等常见场景（与下方 TRIGGER 关键词一致）。 -
Spring Doc / OpenAPI 解析
可从 Spring Doc 或 OpenAPI 描述出发，减少手工对照路径、参数与响应结构的时间。 -
YAML 测试定义
支持用 YAML 形式描述测试，便于版本管理与在 Agent 对话中迭代用例。 -
性能测试
在同一 Skill 主题下可发起性能相关测试任务（具体指标与工具链以 Skill 内说明为准）。 -
契约测试
用于校验实现与文档/约定是否一致，适合联调与发布前检查。 -
测试点分析
协助从需求或接口面梳理测试点，补全边界与异常路径。 -
180 陷阱知识库
内置陷阱知识库，可在「陷阱检查」类对话中对照常见接口测试误区。
官方给出的 TRIGGER 关键词（用于自然语言触发意图）：测试API、接口测试、测登录、测注册、测CRUD、测试设计、陷阱检查、性能测试、契约测试。
安装与启用¶
SkillHub 页面给出的安装方式是：让 Agent 依照官方安装文档，安装坐标 @user_b91ca78d/api-test-automation-pro。通用流程如下。
1、确认 SkillHub CLI¶
先检查是否已安装 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明与命令来源：https://skillhub.cn/install/skillhub.md
2、安装到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；装到默认 ./skills/ 可能无法被识别。
skillhub install user_b91ca78d/api-test-automation-pro --dir <你的 skills 目录>
常用路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
Cursor 示例：
skillhub install user_b91ca78d/api-test-automation-pro --dir ~/.cursor/skills/
也可将下面提示直接发给已支持 Skills 的 AI，由其按 https://skillhub.cn/install/skillhub.md 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_b91ca78d/api-test-automation-pro。
经过上面的步骤后，在对应客户端中启用或刷新 Skills（若环境要求重启 Agent，按客户端说明操作）。
典型用法¶
公开页面未提供完整可复制的一键用例仓库；典型用法应围绕 TRIGGER 与 任务类型 在对话中说明上下文。建议每次带上：基址 URL、鉴权方式、OpenAPI/Spring Doc 位置或片段，以及期望覆盖的场景。
-
功能场景
例如：「对接口做 接口测试，覆盖 测登录 与 测注册，并补充失败密码、重复注册。」
Agent 在加载本 Skill 后，可按 REST/GraphQL 与 YAML 测试定义组织步骤。 -
CRUD 与测试设计
例如：「根据 OpenAPI 做 测试设计，对资源 测CRUD，列出边界与权限相关测试点。」 -
契约与陷阱
例如：「做 契约测试，对照当前实现与文档；再做 陷阱检查，用知识库扫一遍常见遗漏。」 -
性能
例如：「对查询列表接口做 性能测试，说明并发与持续时间假设。」
以上表述仅为触发方式示例；实际输出格式、脚本或 YAML 结构以安装后的 SKILL.md 及 Skill 内指引为准。
适用场景与注意¶
适合谁
- 需要在 IDE Agent 里快速拉起接口测试设计、用例草稿与检查清单的后端/测试工程师。
- 项目已有或计划提供 OpenAPI / Spring Doc，希望减少手工抄接口表的工作。
- 希望在同一对话里串联功能、契约、性能与陷阱审查，而不是切换多个 disconnected 工具。
限制与注意
- 技能为社区来源，升级与行为变更以 SkillHub 上 v1.0.0 及后续版本为准。
- requires_api_key=false 仅表示 Skill 元数据未要求 SkillHub API Key；你测的目标服务仍可能需要 Token、Cookie 或内网 VPN。
- 性能与契约测试能否在你环境中落地，取决于 Agent 是否允许执行相应命令、以及目标服务是否允许压测。
- 公开资料未承诺与特定 CI 或测试框架绑定；落地到流水线时需自行对接生成物（如 YAML、脚本）。
结尾¶
API测试自动化专家版 把接口功能、文档解析、YAML 用例、性能、契约、测试点分析与陷阱知识库收敛到一个 Skill 坐标，适合用 TRIGGER 关键词在对话里分场景推进。若你要从 SkillHub 安装或查看详情，请访问：https://www.skillhub.cn/skills/user_b91ca78d/api-test-automation-pro
