关于 api-test-restassure
为使用 REST Assured 的团队提供 API 测试规划与产出指导,适合偏 Java 的项目。它依据已知信息生成 smoke 断言,并要求显式处理假设、缺口和凭据。
主要功能
- 01生成 REST Assured 自动化测试结构
- 02要求端点与预期状态码明确
- 03缺少必要数据时生成失败工件
- 04按风险优先安排测试场景
- 05使用占位符或环境变量处理凭据
适用场景
- 01为 Java 项目规划 API 测试
- 02为 REST Assured 项目生成 smoke 测试
- 03识别测试需求中的假设与信息缺口
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ naodeng/ awesome-qa-skills --skill api-test-restassure安装后在 Claude Code 中输入/api-test-restassure确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdagents/openai.yamlevals/eval.yamlevals/cases/basic-success.yamledge-bad-or-neighbor.yamledge-incomplete-input.yamlreview-repair-regression.yamlevals/graders/review-repair-regression.pyexamples/sample.curlsample.insomnia.jsonsample.openapi.yamlsample.opencollection.jsonsample.postman_collection.jsonsample.wsdlexamples/bruno/sample.bruexamples/ci/github-actions-restassure.ymlJenkinsfile.restassureoutput-templates/template-markdown.mdprompts/api-test-restassure.mdreferences/framework-spec.mdgenerator-contract.mdreport-schema.mdsetup-and-ci.mdreferences/local/api-testing.mdscripts/api_case_contract.pygenerate_restassured_tests.pyparse_api_sources.pyrun.shscripts/templates/restassured/pom.xmlscripts/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;明确配置目标和凭据。
工作流
- 阅读并遵循 Progressive disclosure 下列出的主提示词(覆盖范围、结构、质量标准)。
- 仅添加会影响结果的项目背景:范围、环境、约束、风险、依赖项、预期交付物。
- 如果输入不完整,请先提供可用的初稿,并明确标注假设和信息缺口。
- 默认使用 Markdown;仅在用户提出要求时切换格式。
核心约束
- 按风险/业务影响确定优先级,不要一视同仁。
- 区分已确认的事实和当前假设。
- 不要编造用户未提供的端点、字段、环境或根本原因。
- 对认证信息/密钥使用占位符或环境变量语义;切勿硬编码真实凭据。
- 确保输出可执行:场景具体、优先级明确、后续步骤清晰。
渐进式披露
- 生成输出前,请阅读并遵循
prompts/api-test-restassure.md(最低覆盖范围、输出结构、质量标准)。 - 有适用的现成模板时:使用
output-templates/下匹配的文件。 - 用户需要示例或与现有资源保持一致时:阅读相关的
examples/。 - 对于深入的框架/故障排查/架构说明:只阅读
references/下相关文件,不要加载整个目录。 - 对于格式转换或辅助检查:优先使用现有的
scripts/,而不是从头实现。 - 评估/回归此技能时:使用 skill-up 和
evals/。
交付前检查清单
- 遵循主提示词的输出结构
- 最低覆盖重点:测试套件结构、通用设置、认证处理、优先级端点、正向场景、负向和边界场景、断言重点、测试数据策略,……(详情见主提示词)
- 覆盖最低检查清单,或说明未覆盖项
- 高风险项明确标注优先级
- 未编造用户未提供的细节
- 已标注假设和信息缺口
常见问题
- 范围/背景缺失时,不要假装内容完整。
- 不要把每一项都视为同等重要。
- 不要遗漏假设和信息缺口。
- 不要罗列与当前工具链无关的通用理论。
评论
支持 Markdown