用途：从既有 API 实现、设计文档或数据库模式生成 OpenAPI 3.0/3.1 规范与消费者驱动契约测试，产出机器可读契约，作为代码生成、文档、测试与网关配置的单一事实来源。
主要能力：扫描路由处理器与控制器，提取路径、HTTP 方法、请求参数名与类型、响应体结构；生成含 info、servers、paths、components 的 OpenAPI 规范，定义字段级约束（type、format、required、min/max、pattern、enum、example）；按端点记录各响应状态码（200/201、400 含字段级错误数组、401/403、404/500）；添加安全方案（bearerAuth、apiKey、oauth2）；创建 Pact 消费者契约测试并设置提供者验证；输出规范文件、Postman 集合与 Pact JSON 契约。
使用方式：需 API 实现或设计需求文档，配合 OpenAPI 编写工具（Swagger Editor、Stoplight Studio 或 IDE 扩展）、契约框架（Pact、Spring Cloud Contract 或 Dredd）与 Spectral 校验工具，契约文件纳入版本控制并基于 diff 评审。产出包括 openapi.yaml、contracts/pact/、contracts/postman/、消费者与提供者测试目录及 generate-contract.sh 脚本。错误处理覆盖规范与代码偏离、Pact 验证失败、缺失 operationId、循环 schema 引用、示例与 schema 不匹配。
适用场景：代码优先自动生成规范、前后端消费者驱动契约测试防止破坏性变更、设计优先工作流生成服务端存根与客户端 SDK。
限制：具体安装命令、收费与价格资料暂未提供；实际生成结果依赖输入代码或文档的完整性。