mcpField
A
api-test-restassure

api-test-restassure

github.com/naodeng测试与质量28570 次安装今天更新
代码仓库

关于 api-test-restassure

为使用 REST Assured 的团队提供 API 测试规划与产出指导,适合偏 Java 的项目。它依据已知信息生成 smoke 断言,并要求显式处理假设、缺口和凭据。

主要功能

  1. 01生成 REST Assured 自动化测试结构
  2. 02要求端点与预期状态码明确
  3. 03缺少必要数据时生成失败工件
  4. 04按风险优先安排测试场景
  5. 05使用占位符或环境变量处理凭据

适用场景

  1. 01为 Java 项目规划 API 测试
  2. 02为 REST Assured 项目生成 smoke 测试
  3. 03识别测试需求中的假设与信息缺口

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/naodeng/awesome-qa-skills --skill api-test-restassure

安装后在 Claude Code 中输入/api-test-restassure确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
agents/
openai.yaml
evals/
eval.yaml
evals/cases/
basic-success.yaml
edge-bad-or-neighbor.yaml
edge-incomplete-input.yaml
review-repair-regression.yaml
evals/graders/
review-repair-regression.py
examples/
sample.curl
sample.insomnia.json
sample.openapi.yaml
sample.opencollection.json
sample.postman_collection.json
sample.wsdl
examples/bruno/
sample.bru
examples/ci/
github-actions-restassure.yml
Jenkinsfile.restassure
output-templates/
template-markdown.md
prompts/
api-test-restassure.md
references/
framework-spec.md
generator-contract.md
report-schema.md
setup-and-ci.md
references/local/
api-testing.md
scripts/
api_case_contract.py
generate_restassured_tests.py
parse_api_sources.py
run.sh
scripts/templates/restassured/
pom.xml
scripts/templates/restassured/src/test/java/com/example/api/
BaseApiTest.java

详细介绍

原文在翻译后有更新,译文可能不是最新。

api-test-restassure (EN)

中文版: 请参阅对应的中文技能。

使用场景

  • 需要将 API 输出用于基于 REST Assured 的自动化测试。
  • 项目基于 Java,或已使用 REST Assured。

生成与执行边界

生成器只会针对已知字段生成冒烟断言:必须提供非空的端点和明确的 expected_statuses;expected_json 和有来源依据的 max_response_ms 为可选项。缺少数据、参数/变量未解析或包含架构断言时,将生成不完整的脚手架并以非零状态码退出。请阅读 references/generator-contract.md;明确配置目标和凭据。

工作流

  1. 阅读并遵循 Progressive disclosure 下列出的主提示词(覆盖范围、结构、质量标准)。
  2. 仅添加会影响结果的项目背景:范围、环境、约束、风险、依赖项、预期交付物。
  3. 如果输入不完整,请先提供可用的初稿,并明确标注假设和信息缺口。
  4. 默认使用 Markdown;仅在用户提出要求时切换格式。

核心约束

  • 按风险/业务影响确定优先级,不要一视同仁。
  • 区分已确认的事实和当前假设。
  • 不要编造用户未提供的端点、字段、环境或根本原因。
  • 对认证信息/密钥使用占位符或环境变量语义;切勿硬编码真实凭据。
  • 确保输出可执行:场景具体、优先级明确、后续步骤清晰。

渐进式披露

  • 生成输出前,请阅读并遵循 prompts/api-test-restassure.md(最低覆盖范围、输出结构、质量标准)。
  • 有适用的现成模板时:使用 output-templates/ 下匹配的文件。
  • 用户需要示例或与现有资源保持一致时:阅读相关的 examples/。
  • 对于深入的框架/故障排查/架构说明:只阅读 references/ 下相关文件,不要加载整个目录。
  • 对于格式转换或辅助检查:优先使用现有的 scripts/,而不是从头实现。
  • 评估/回归此技能时:使用 skill-up 和 evals/。

交付前检查清单

  • 遵循主提示词的输出结构
  • 最低覆盖重点:测试套件结构、通用设置、认证处理、优先级端点、正向场景、负向和边界场景、断言重点、测试数据策略,……(详情见主提示词)
  • 覆盖最低检查清单,或说明未覆盖项
  • 高风险项明确标注优先级
  • 未编造用户未提供的细节
  • 已标注假设和信息缺口

常见问题

  • 范围/背景缺失时,不要假装内容完整。
  • 不要把每一项都视为同等重要。
  • 不要遗漏假设和信息缺口。
  • 不要罗列与当前工具链无关的通用理论。

评论

支持 Markdown