用途:当需要把 API 输出落到基于 REST Assured 的自动化测试中,或项目本身是 Java、已使用 REST Assured 时,可使用该技能解析多格式 API 定义并生成 REST Assured Java 测试类。触发词包括 Rest Assured、RestAssured 等。
主要能力:生成器仅针对已知字段产出冒烟断言,要求端点非空并显式给出 expected_statuses;可选 expected_json 与带来源的 max_response_ms。若数据缺失、参数或变量未解析、或涉及 schema 断言,则只生成不完整脚手架并以非零状态退出。
使用方式:先阅读并遵循渐进式披露中列出的主提示(覆盖范围、结构、质量标准),即 prompts/api-test-restassure.md;需要模板时使用 output-templates/ 下匹配文件;需要示例时读取 examples/;深入框架、排错或 schema 说明时只读 references/ 下相关文件,不要加载整个目录;格式转换或辅助检查优先使用 scripts/;评估或回归该技能时使用 evals/ 配合 skill-up。需阅读 references/generator-contract.md,并显式配置目标与凭据。
适用场景:Java 项目、已有 REST Assured 技术栈的 API 自动化测试生成。
限制:不虚构端点、字段、环境或根因;认证与密钥使用占位符或环境变量语义,不得硬编码真实凭据;输入不完整时返回可用初稿并明确标注假设与缺口;默认输出 Markdown,仅在用户要求时切换格式;按风险与业务影响排优先级,区分已确认事实与当前假设。交付前需核对主提示的输出结构、最小覆盖清单(套件结构、公共设置、认证处理、优先端点、正向场景、负向与边界场景、断言重点、测试数据策略等),高风险项需明确优先级。常见陷阱:范围或上下文缺失时不要假装完整,不要平均对待所有项,不要跳过假设与信息缺口,不要堆砌与当前工具链无关的通用理论。