mcpField
A
api-test-bruno

api-test-bruno

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

关于 api-test-bruno

为使用 Bruno 的团队提供 API 测试规划与产出指导,强调依据已知信息生成可执行的 smoke 断言,并明确标注假设和缺口。

主要功能

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

适用场景

  1. 01为现有 Bruno 项目规划 API 测试
  2. 02根据已确认端点生成 smoke 测试
  3. 03识别测试需求中的假设与信息缺口

安装

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

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

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

包含的文件

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

README.md
agents/
openai.yaml
evals/
eval.yaml
trigger_queries.json
evals/cases/
basic-success.yaml
edge-bad-or-neighbor.yaml
edge-incomplete-input.yaml
review-repair-regression.yaml
evals/fixtures/
openapi-orders.yaml
sample-curls.sh
evals/fixtures/scripts/
check_bruno_output.sh
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-bruno.yml
Jenkinsfile.bruno
output-templates/
template-markdown.md
prompts/
api-test-bruno.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
check_bruno_report.py

详细介绍

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

api-test-bruno (EN)

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

使用场景

  • 需要生成适合放入 Bruno 结构或 Bruno 工作流的 API 输出。
  • 项目已在使用 Bruno,或希望采用适配 Bruno 的组织方式。

生成与执行边界

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

工作流

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

核心约束

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

渐进式披露

  • 生成输出前,阅读并遵循 prompts/api-test-bruno.md(最低覆盖要求、输出结构、质量标准)。
  • 适用现成模板时:使用 output-templates/ 下匹配的文件。
  • 用户需要示例或希望与现有资源保持一致时:阅读相关的 examples/。
  • 需要深入了解框架、故障排查或架构说明时:仅阅读 references/ 下相关文件,不要加载整个目录。
  • 进行格式转换或辅助检查时:优先使用现有 scripts/,不要重复造轮子。
  • 评估或回归测试此技能时:使用 evals/ 和 skill-up。

交付前检查清单

  • 遵循了主提示词的输出结构
  • 重点关注最低覆盖要求:集合结构、环境设置、身份验证处理、优先级端点、正向场景、负向和边界场景、数据或变量策略、断言重点等(详情见主提示词)
  • 覆盖了最低检查清单,或说明了未覆盖项
  • 高风险项已明确标注优先级
  • 未编造用户未提供的细节
  • 已标注假设和缺漏

常见陷阱

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

评论

支持 Markdown