contract-test
/contract-test
[UDS] Guide contract testing strategy for APIs and microservices. Use when: API contracts, microservices, consumer-driven testing, provider verification. Not for: designing the API surface in the first place — use /api-design; user-visible flows through a UI — use /e2e. Keywords: contract test, Pact, OpenAPI, consumer-driven, provider.
- Author
- AsiaOstrich ↗
- Repository
- universal-dev-standards ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
[UDS] Guide contract testing strategy for APIs and microservices. Use when: API contracts, microservices, consumer-driven testing, provider verification. Not for: designing the API surface in the first place — use /api-design; user-visible flows through a UI — use /e2e. Keywords: contract test, Pact, OpenAPI, consumer-driven, provider.
Arguments
/contract-test [verify | consumer | provider | 策略選擇]
Original author description
[UDS] Guide contract testing strategy for APIs and microservices. Use when: API contracts, microservices, consumer-driven testing, provider verification. Not for: designing the API surface in the first place — use /api-design; user-visible flows through a UI — use /e2e. Keywords: contract test, Pact, OpenAPI, consumer-driven, provider.
How it works
- What is Contract Testing? | 什麼是合約測試?
- Strategy Selection | 策略選擇
- Workflow | 工作流程
- Commands | 指令
- Contract Coverage Report | 合約覆蓋率報告
- Integration | 與其他技能的整合
- Next Steps Guidance | 下一步引導
- Reference | 參考
- AI Agent Behavior | AI 代理行為
SKILL.md preview
--- name: contract-test scope: universal description: | [UDS] Guide contract testing strategy for APIs and microservices. Use when: API contracts, microservices, consumer-driven testing, provider verification. Not for: designing the API surface in the first place — use /api-design; user-visible flows through a UI — use /e2e. Keywords: contract test, Pact, OpenAPI, consumer-driven, provider. allowed-tools: Read, Write, Glob, Grep argument-hint: "[verify | consumer | provider | 策略選擇]" --- # Contract Test Assistant | 合約測試助手 > **Language**: English | [繁體中文](../../locales/zh-TW/skills/contract-test-assistant/SKILL.md) Guide contract testing strategy selection, setup, and verification for APIs and microservices. 引導 API 和微服務的合約測試策略選擇、設定和驗證。 ## What is Contract Testing? | 什麼是合約測試? Contract testing verifies that services can communicate correctly by testing the agreements (contracts) between consumers and providers — without requiring all services to be running. 合約測試透過測試消費者和提供者之間的協議(合約)來驗證服務間的通訊正確性,不需要所有服務同時運行。 ## Strategy Selection | 策略選擇 | Strategy | Best For | Tool | 適用場景 | |----------|---------|------|---------| | **Consumer-Driven** | Internal microservices, team owns both sides | Pact | 內部微服務,團隊同時擁有兩端 | | **Provider-Driven** | Public APIs, OpenAPI-first design | OpenAPI + Prism | 公開 API,OpenAPI 優先設計 | | **Bi-Directional** | Mixed ownership, gradual adoption | Pact + OpenAPI | 混合所有權,漸進採用 | ## Workflow | 工作流程 ``` ASSESS ──► CHOOSE ──► DEFINE ──► IMPLEMENT ──► VERIFY 評估架構 選擇策略 定義合約 實作測試 驗證合約 ``` ### 1. ASSESS — Evaluate Architecture | 評估架構 - How many services communicate? - Who owns consumer vs provider? - 有多少服務互相通訊?誰擁有消費者/提供者? ### 2. CHOOSE — Select Strategy | 選擇策略 - Consumer-Driven (Pact) vs Provider-Driven (OpenAPI) - 消費者驅動 (Pact) vs 提供者驅動 (OpenAPI) ### 3. DEFINE — Create Contract | 定義合約 - Write consumer expectations or OpenAPI spec - 撰寫消費者期望或 OpenAPI 規格 ### 4. IMPLEMENT — Write Tests | 實作測試 - Consumer tests generate contracts - Provider tests verify against contracts - 消費者測試產生合約;提供者測試驗證合約 ### 5. VERIFY — Run Verification | 驗證 - CI pipeline verifies contracts on every PR - CI 管線在每個 PR 上驗證合約 ## Commands | 指令 | Command | Action | 說明 | |---------|--------|------| | `/contract-test` | Interactive strategy selection | 互動式策略選擇 | | `/contract-test consumer` | Guide consumer test setup | 引導消費者測試設定 | | `/contract-test provider` | Guide provider test setup | 引導提供者測試設定 | | `/contract-test verify` | Check contract coverage | 檢查合約覆蓋率 | ## Contract Coverage Report | 合約覆蓋率報告 ```markdown ## Contract Coverage Report | Consumer | Provider | Endpoint | Status | |----------|----------|----------|--------| | web-app | user-api | GET /users/:id | ✅ Verified | | web-app | user-api | POST /users | ✅ Verified | | mobile-app | auth-api | POST /login | ⚠️ Consumer only | | admin-ui | report-api | GET /reports | ❌ No contract | **Coverage**: 50% (2/4 endpoints verified both sides) ``` ## Integration | 與其他技能的整合 | Skill | Integration | 整合方式 | |-------|-------------|---------| | `/api-design` | Define API contracts during design | 設計時定義 API 合約 | | `/ci-cd` | Add contract verification to pipeline | 管線中加入合約驗證 | | `/testing` | Contract tests as part of test strategy | 合約測試作為測試策略一部分 | | `/migrate` | Capture legacy response fixtures during API migration; verify new impl preserves structural equivalence | API 遷移時捕獲 legacy response fixture,驗證新實作保持結構性等價 | ### Migration Contract Tests — When Replacing an Implementation | 遷移合約測試(替換實作時) When migrating an API endpoint from one tech stack to another (PHP → .NET, Express → Spring, etc.), a contract test against a **legacy reference fixture** catches missing fields, renamed fields, and placement drift that unit tests on the new DTO cannot. See [migration-assistant § API Migration Contract Tests](../migration-assistant/SKILL.md#api-migration-contract-tests--api-遷移合約測試) for the fixture capture protocol and audit checklist. 當 API endpoint 從一個技術棧遷至另一個(PHP → .NET、Express → Spring 等),對 **legacy 參考 fixture** 的 contract test 可捕捉「缺漏欄位」「rename」「層級漂移」等新 DTO 單元測試無法覆蓋的缺陷。詳見 [migration-assistant § API Migration Contract Tests](../migration-assistant/SKILL.md#api-migration-contract-tests--api-遷移合約測試)。 ## Next Steps Guidance | 下一步引導 After `/contract-test` completes: > **合約測試引導完成。建議下一步:** > - 執行 `/ci-cd` 將合約驗證加入 CI 管線 > - 執行 `/api-design` 完善 API 設計 > - 執行 `/testing` 整合到整體測試策略 ## Reference | 參考 - Detailed guide: [guide.md](./guide.md) — contract testing strategy and setup. Read it when configuring Pact/OpenAPI or wiring contract tests into CI. - Detailed guide: [contract-testing.md](../../options/testing/contract-testing.md) - Related: [api-design-assistant](../api-design-assistant/SKILL.md) ## AI Agent Behavior | AI 代理行為 When `/contract-test` is invoked: 1. **Assess** — Ask about architecture (monolith, microservices, number of APIs) 2. **Recommend** — Suggest strategy based on architecture 3. **Guide** — Walk through setup for chosen strategy 4. **Generate** — Create example contract test files 5. **Verify** — If `verify` subcommand, scan for contracts and report coverage
Files in this package (2)
- SKILL.md 6 KB
- guide.md 2 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · AsiaOstrich/universal-dev-standards | 95 | MIT |
| scalus3/scalus | 100 | Apache-2.0 |
| tmj-90/gaffer | 100 | Apache-2.0 |
| AsiaOstrich/universal-dev-standards | 95 | MIT |
Database snapshot: 13.11.2026 · package version efcb4eaff0ff (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 84contract-test-assistant
[UDS] 引导 API 与微服务的契约测试策略。 Use when: API 契约、微服务、消费者驱动测试、提供者验证。 Not for: 一开始的 API 接口设计——请用 /api-design;经由 UI 的用户可见流程——请用 /e2e。 Keywords: contract test, Pact, OpenAPI, consumer-driven, provider, 契约测试, 消费者驱动, 提供者验证. - 90contract-testing
Contract testing: Pact consumer-driven contracts (provider states, interaction definitions), provider verification with state handlers, OpenAPI validation middleware, breaking change detection. Use when microservices need integration confidence without full e2e tests. - 90quality-contract-testing
Use this skill when setting up contract testing, Pact, consumer-driven contracts, provider contract verification, API compatibility, or integration testing between services. This skill enforces: consumer-driven contracts with Pact, provider-side verification, contract publishing… - 90backend-contract-testing
Use this skill when the user says 'contract testing', 'Pact', 'consumer-driven contracts', 'CDC', 'provider verification', 'pact test', 'pactflow', 'contract test', 'consumer test', 'provider test'. This skill implements consumer-driven contract testing using Pact to ensure… - 100validating-api-contracts
Validate API contracts using consumer-driven contract testing (Pact, Spring Cloud Contract). Use when performing specialized testing. Trigger with phrases like "validate API contract", "run contract tests", or "check consumer contracts". - 100validating-api-contracts
Validate API contracts using consumer-driven contract testing (Pact, Spring Cloud Contract). Use when performing specialized testing. Trigger with phrases like "validate API contract", "run contract tests", or "check consumer contracts".