用途:当用户提到 API 测试、api-testing,或需要按 Standard-version 产出该测试类型的交付物时使用,典型触发如“为以下内容生成/设计/编写 API 测试用例”。
主要能力:覆盖 REST、GraphQL、gRPC 接口的测试计划与用例设计;提供测试金字塔(单元、集成、端到端)、测试数据管理、断言策略(状态码、Schema、响应数据、响应时间)、错误处理(4xx/5xx、错误信息格式、边界条件)等最佳实践;附工具选型指南(Postman/Newman、REST Assured、Pytest + Requests、SuperTest、GraphQL Playground)与常见陷阱说明。
使用方式:打开本目录 prompts/ 下相关文件,复制虚线以下内容,追加需求与上下文(业务流程、环境、约束、验收标准);如需非 Markdown 输出,在末尾追加 output-formats.md 中的请求语句。示例:Postman + Newman REST API 测试位于 examples/postman-rest-api/,含 10 个用例的集合、环境变量配置、Newman 运行脚本与 README,快速开始为 cd examples/postman-rest-api、npm install -g newman、./newman-run.sh。REST Assured(Java)与 SuperTest(Node.js)示例标注为即将推出。
输出与脚本:output-templates/ 提供 Word、Excel、XMind、JSON、CSV、Markdown 模板;scripts/ 提供解析与转换脚本,如 python3 scripts/parse_json.py output-templates/template-json.json、python3 scripts/convert_output_formats.py output-templates/template-json.json --to csv、python3 scripts/batch_convert_templates.py --skip-same。
适用场景:QA 工程师与开发者在真实项目中执行该测试领域;需要结构化、可复现测试输出的团队负责人;需要快速、格式就绪交付物的 AI 用户。
限制:不适用于无测试范围/上下文的纯生产事故响应、需法律合规签字的决策、缺少最小输入(范围、环境、预期行为)的请求。生成前应提供清晰范围、环境与验收标准,执行前需对照真实系统约束验证输出。详细排障步骤见 references/troubleshooting.md,按需加载。相关技能:automation-testing-en、performance-testing-en、security-testing-en、functional-testing-en。