api-scenario-automation

name api-scenario-automation description 根据需求文档、测试用例、OpenAPI、Postman、Apipost、Swagger、Markdown 接口文档、后端文档或后端路由生成场景化接口自动化。适用于生成接口流程编排、scenarios.yaml/scenarios.json 场景文件、unittest/pytest 兼容的接口自动化测试，以及带数据依赖的端到端接口测试；不用于生成单元测试。 场景化接口自动化 使用本 skill 将接口资料和测试用例转换成场景化接口自动化。目标不是生成单接口冒烟用例，而是生成可执行的业务流程：包含请求顺序、变量提取、跨步骤数据依赖、业务断言和清晰的失败反馈。 工作流程 收集源材料： 接口资料：OpenAPI、Swagger、Postman 集合、Apipost 导出、Markdown 接口文档、后端路由文件。 可选上游测试用例，例如 test-case-xmind 生成的 cases.json 。 环境信息： base_url 、测试账号、鉴权方式、必要测试数据、数据清理要求。 编写场景 DSL 前，阅读 references/scenario_schema.md 。 导出测试代码前，阅读 references/pytest_export.md 。 如果接口资料是 Markdown，可以先运行 scripts/extract_api_inventory.py 提取接口清单。 生成 scenarios.yaml 。除非用户明确要求其他格式，否则保持 JSON 兼容 YAML。 运行 scripts/validate_scenarios.py scenarios.yaml 校验场景文件，并修复所有错误。 运行 scripts/export_pytest.py scenarios.yaml --output <项目目录>/api-automation 导出接口自动化测试代码。 如果目标应用可以在本地运行，执行生成的测试套件；如果无法运行，交付生成文件并说明未执行的原因。 场景设计规则 优先生成 3-8 条有价值的业务场景，而不是大量浅层接口检查。 使用 extract 和 {{ variable }} 模板串联步骤之间的数据。 同时断言传输结果和业务结果： HTTP 状态码。 响应字段。 创建后的资源能被查询。 数量、状态、归属关系或业务流转符合预期。 禁止访问路径返回正确失败结果。 在有价值的地方加入反向场景：缺少必填字段、非法 ID、错误鉴权、过期状态、重复提交、可注入的服务错误。 保持测试确定性。避免真实支付、真实邮件、真实 AI 调用或不可逆的生产操作。 如果没有清理接口，生成唯一测试数据，并避免依赖持久化全局状态。 输出结构 默认输出目录： api-automation/ ├── scenarios.yaml ├── tests/ │ └── test_api_scenarios.py └── README.generated.md scenarios.yaml 是接口自动化的源文件。生成的测试文件会内嵌场景定义，因此运行时不需要额外 YAML 解析依赖。导出的测试基于 unittest ，也可以被 pytest 收集执行。 脚本 可在任意工作目录运行： python3 <skill>/scripts/extract_api_inventory.py docs/接口文档.md --output api-inventory.json python3 <skill>/scripts/validate_scenarios.py scenarios.yaml python3 <skill>/scripts/export_pytest.py scenarios.yaml --output api-automation 脚本只使用 Python 标准库。生成的接口自动化测试也只使用 Python 标准库，可以通过 python3 -m unittest 运行；如果项目安装了 pytest，也可以被 pytest 收集执行。