用途:把 API 测试结果落到 Supertest 自动化结构中,适用于项目偏 Node.js 或已在用 Supertest/Jest 的场景。
主要能力:解析多格式 API 定义并生成可执行 Supertest 脚本;生成脚本只对已知字段做 smoke 断言。必须提供非空 endpoints 和明确 expected_statuses;可选 expected_json 与来源化 max_response_ms。缺数据、未解析参数/变量或 response_schema 待实现时,生成失败工件并以非零退出,不能运行成绿色。
使用方式:先读 references/generator-contract.md,目标与凭据必须显式配置。产出前必须阅读并遵循 prompts/api-test-supertest.md 的最低覆盖清单、输出结构与质量要求。需要模板时读 output-templates/ 中匹配模板;需要示例时读 examples/;需要深资料时只读 references/ 中相关文件;格式转换或辅助校验优先用 scripts/ 中已有脚本;评测/回归用 evals/ 并以 skill-up 校验运行。默认输出 Markdown,用户指定其他格式时再切换。
适用场景:Node.js 项目的 API 自动化测试、已有 Supertest/Jest 技术栈的测试补充、按风险优先级组织的接口 smoke 测试。
限制:鉴权与密钥一律用占位符或环境变量语义,禁止硬编码真实凭证;不得编造用户未提供的接口、字段、环境或根因细节;信息不全时先给可用初版并显式标出假设与信息缺口;按风险/业务影响排优先级,不平均摊铺;把已确认事实与当前假设分开写。