api-test-supertest

api-test-supertest（EN）

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

适用场景

• 需要将 API 输出用于基于 Supertest 的自动化测试。
• 项目基于 Node.js，或已使用 Supertest/Jest。

生成与执行边界

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

工作流

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

核心约束

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

渐进式披露

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

交付前检查清单

• 遵循了主提示词的输出结构
• 最低覆盖重点：测试套件结构、环境设置、身份验证处理、优先级端点、正向场景、负向和边界场景、断言重点、数据策略等（详见主提示词）
• 覆盖了最低检查清单，或说明了省略原因
• 明确标注了高风险事项的优先级
• 未编造用户未提供的细节
• 已标注假设和信息缺口

常见问题

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