القائمة
[UDS] 引導 API 和微服務的合約測試策略
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill contract-test-assistantيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
[UDS] 以 Claude 原生 Agent tool 编排多任务执行计划（DAG-based，无外部引擎）。 Use when: executing a plan.json file with parallel/sequential task dependencies. Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行.
[UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。 Use when: converting specifications into executable task plans for /orchestrate. Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.
[UDS] AI 辅助 git push 安全层：质量门禁 + 协作护栏。 Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches. Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.
عرض SKILL.md
استنادا إلى تصنيف SOC المهني
| name | contract-test-assistant |
| source | ../../../../skills/contract-test-assistant/SKILL.md |
| source_version | 1.0.0 |
| source_hash | f67623eb913a |
| translation_version | 1.0.0 |
| last_synced | "2026-06-01T00:00:00.000Z" |
| status | current |
| description | [UDS] 引導 API 和微服務的合約測試策略 |
語言: English | 繁體中文
引導 API 和微服務的合約測試策略選擇、設定和驗證。
合約測試透過測試消費者和提供者之間的協議（合約）來驗證服務間的通訊正確性，不需要所有服務同時運行。
| 策略 | 適用場景 | 工具 |
|---|---|---|
| 消費者驅動（Consumer-Driven） | 內部微服務，團隊同時擁有兩端 | Pact |
| 提供者驅動（Provider-Driven） | 公開 API，OpenAPI 優先設計 | OpenAPI + Prism |
| 雙向（Bi-Directional） | 混合所有權，漸進採用 | Pact + OpenAPI |
ASSESS ──► CHOOSE ──► DEFINE ──► IMPLEMENT ──► VERIFY
評估架構 選擇策略 定義合約 實作測試 驗證合約
| 指令 | 說明 |
|---|---|
/contract-test | 互動式策略選擇 |
/contract-test consumer | 引導消費者測試設定 |
/contract-test provider | 引導提供者測試設定 |
/contract-test verify | 檢查合約覆蓋率 |
## 合約覆蓋率報告
| 消費者 | 提供者 | 端點 | 狀態 |
|--------|--------|------|------|
| web-app | user-api | GET /users/:id | ✅ 已驗證 |
| web-app | user-api | POST /users | ✅ 已驗證 |
| mobile-app | auth-api | POST /login | ⚠️ 僅消費者端 |
| admin-ui | report-api | GET /reports | ❌ 無合約 |
**覆蓋率**：50%（2/4 個端點兩端皆驗證）
| 技能 | 整合方式 |
|---|---|
/api-design | 設計時定義 API 合約 |
/ci-cd | 管線中加入合約驗證 |
/testing | 合約測試作為測試策略一部分 |
/migrate | API 遷移時捕獲 legacy response fixture，驗證新實作保持結構性等價 |
當 API endpoint 從一個技術棧遷至另一個（PHP → .NET、Express → Spring 等），對 legacy 參考 fixture 的 contract test 可捕捉「缺漏欄位」「rename」「層級漂移」等新 DTO 單元測試無法覆蓋的缺陷。詳見 migration-assistant § API Migration Contract Tests 取得 fixture 捕獲協議與稽核檢查清單。
/contract-test 完成後：
合約測試引導完成。建議下一步：
- 執行
/ci-cd將合約驗證加入 CI 管線- 執行
/api-design完善 API 設計- 執行
/testing整合到整體測試策略
當 /contract-test 被呼叫時：
verify 子指令，掃描合約並回報覆蓋率