用途:该技能让 Claude 能够生成并验证 API 契约,确保 API 提供方与消费方之间的兼容性。它采用 Pact 进行消费方驱动的契约测试,并使用 OpenAPI 校验检查规范符合性。
主要能力:
- 生成契约测试:根据 API 使用情况创建 Pact 消费方测试,生成提供方验证测试,并构建 OpenAPI 契约校验器。
- 验证契约:检查 API 响应是否与已定义的契约一致。
- 兼容性检查:检查向后兼容性,识别 API 中的破坏性变更。
使用方式:当需要为 API 生成契约测试、依据现有契约验证 API 响应或识别 API 破坏性变更时,该技能会被激活。例如,用户提出“使用 Pact 为我的 API 生成契约测试”时,技能会分析 API 并生成 Pact 消费方契约,再基于契约创建提供方验证测试;用户提出“按 OpenAPI 规范验证我的 API”时,技能会依据提供的 OpenAPI 规范验证 API,并报告差异或违规之处。
适用场景:API 契约测试生成、OpenAPI 规范符合性验证、API 兼容性与破坏性变更检查。该技能可与其他测试和部署工具集成,在 CI/CD 流水线中自动执行契约验证。
使用建议:请求契约生成或验证时尽量具体,并提供相关 API 细节;确保 OpenAPI 规范保持最新以保证校验准确;使用 Pact 时说明消费方与提供方的角色背景。
限制:资料未提供具体安装命令、支持的编程语言或框架范围、收费与价格信息,暂未提供。