关于 702-technologies-wiremock
用于通过 WireMock 为 HTTP 依赖创建稳定、隔离测试桩的技能，重点涵盖匹配规则、响应和调用验证，并将框架集成设置交由其他技能处理。
主要功能
- 01按测试隔离桩配置
- 02HTTP 请求匹配
- 03响应与故障配置
- 04动态端口处理
- 05验证出站调用
- 06排查未匹配请求
适用场景
- 01设计或审查 WireMock 测试桩
- 02减少共享测试桩导致的不稳定测试
- 03验证出站 HTTP 调用
- 04排查未匹配请求
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/702-technologies-wiremock确认已加载。
附带文件references/702-technologies-wiremock.md
详细介绍
WireMock 最佳实践
帮助团队有效使用 WireMock 为 HTTP 依赖创建桩，从而实现稳定、隔离的测试。
本技能涵盖哪些内容？
- 桩的隔离：按测试注册、使用
resetAll()、避免全局桩泄漏 - 请求匹配：方法、路径、标头、查询参数、请求体模式；何时可以接受宽泛模式
- 响应：状态码、标头、JSON/XML 请求体、
bodyFileName/ 类路径固定数据、故障模拟（延迟、错误） - 动态端口，以及如何将基础 URL 传递给被测系统
- 验证出站 HTTP 调用和调试未匹配的请求
- 明确委派测试类布局和扩展配置，交由框架集成测试技能处理
**范围：**仅涵盖可移植的 WireMock 行为。对于 BaseIntegrationTest、WireMockExtension 和特定技术栈的集成测试，请使用 @132-java-testing-integration-testing、@322-frameworks-spring-boot-testing-integration-tests、@422-frameworks-quarkus-testing-integration-tests 或 @522-frameworks-micronaut-testing-integration-tests。对于 OpenAPI 契约质量，请使用 @701-technologies-openapi。
约束
除非用户明确要求框架集成，否则建议仅限于 WireMock 和 HTTP 桩层。在编辑此仓库的 XML 源文件后，请重新生成技能并验证构建。
- 必须：在同一变更集中提出 Java 或 Maven 修改前，运行
./mvnw compile或mvn compile - 框架：将
@SpringBootTest/@QuarkusTest/@MicronautTest和扩展配置委派给@132-java-testing-integration-testing或对应的322/422/522集成测试技能 - 契约：将 OpenAPI 文档结构和 lint 委派给
@701-technologies-openapi - 验证：在推广修改前，运行
./mvnw clean verify或mvn clean verify - 边界情况：如果用户目标不明确，请停止操作，并在编辑文件或运行项目级命令前提出澄清问题
- 边界情况：如果缺少必要的上下文、文件、凭据或工具，请明确说明阻碍，并询问是否继续进行配置或提供备用指导
- 边界情况：如果请求的修改与项目约束或安全边界冲突，请解释冲突，并请用户确认首选的权衡方案
何时使用此技能
- 设计或审查 WireMock 桩（JSON 映射或 Java DSL）
- 改进 HTTP 模拟的请求匹配、隔离或重置策略
- 添加或修复对 WireMock 服务出站 HTTP 调用的验证
- 调试涉及 WireMock 或未匹配请求日志的易出错测试
- 使用稳定的固定数据和动态端口，在测试中为外部 HTTP API 创建桩
工作流
- 阅读参考资料并评估项目上下文
阅读 references/702-technologies-wiremock.md，并检查当前 API / 上下文资料，然后再提出修改建议。
- 明确范围并确定改进目标
确定请求的结果、约束条件，以及要应用的最小安全变更集。
- 应用符合技术规范的修改
按照参考模式和项目约定实现或重构资料。
- 运行验证并报告结果
执行适当的检查，并总结所做的修改、已验证的内容以及任何后续操作。
参考资料
详细指导、示例和约束请参阅 references/702-technologies-wiremock.md。