一個用於管理 PactFlow 和開源 Pact 合約測試的專家助手，透過自動化相容性檢查確保安全部署。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install pactflow
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 pactflow。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 PactFlow & Pact 合約測試？
PactFlow & Pact skill 是一個強大的整合工具，旨在彌合服務消費者與提供者之間的鴻溝。透過利用 Openclaw Skills，開發人員可以管理整個合約測試生命週期——從使用 AI 生成初始測試，到在複雜的微服務架構中驗證相容性。它提供了通往 Pact Broker 和 PactFlow 的直接介面，能夠在分散式系統的不同部分之間實現無縫通訊，而無需依賴脆弱的端對端整合測試。
此 skill 自動化了開發工作流程中最關鍵的部分，包括發佈合約、觸發提供者驗證以及管理特定環境的部署記錄。無論您使用的是開源 Pact Broker 還是 PactFlow Cloud 的進階功能，這些 Openclaw Skills 都提供了維護健康且可靠的服務網格所需的技術深度。
PactFlow & Pact 合約測試 應用場景
- 根據 OpenAPI 規範或現有程式碼檔案自動建立 Pact 測試。
- 在部署到生產環境之前驗證微服務之間的 API 相容性，以防止破壞性變更。
- 透過檢查合約矩陣來調查失敗的提供者驗證或被封鎖的部署。
- 管理環境並記錄行動應用程式和後端服務的部署或發佈。
- 發現現有的提供者狀態，以簡化新的消費者驅動測試的開發。
PactFlow & Pact 合約測試 運作原理
- 消費者服務執行其本地測試套件，生成一份詳細記錄所有必需互動的 Pact 合約檔案。
- Openclaw Skills 工具將此合約及其關聯的分支版本發佈到 Pact Broker 或 PactFlow 工作區。
- 提供者服務在 CI/CD 流水線執行期間自動獲取待處理的 pacts 進行驗證。
- 驗證結果被發送回 broker，更新特定版本對的全局相容性矩陣。
- 系統使用 can-i-deploy 工具來檢查特定版本進入目標環境是否安全。
- 部署成功後，工具會記錄部署狀態，以確保未來的相容性檢查反映真實世界環境。
PactFlow & Pact 合約測試 設定指南
要開始使用，請使用您的 PactFlow 或 Pact Broker 實例所需的憑證設定環境。請按照以下步驟為您的專案啟用 Openclaw Skills：
- 將基礎 URL 和身份驗證 token 設定為環境變數：
export PACT_BROKER_BASE_URL="https://your-tenant.pactflow.io"
export PACT_BROKER_TOKEN="your_pactflow_api_token"
- 如果使用開源 broker，您可以使用基本身份驗證：
export PACT_BROKER_USERNAME="your_username"
export PACT_BROKER_PASSWORD="your_password"
- 透過列出您註冊的 pacticipants 來測試連線：
contract-testing_list_pacticipants
PactFlow & Pact 合約測試 資料結構與分類體系
該 skill 圍繞幾個核心實體組織資料，以保持合約測試生態系統的完整性：
| 實體 | 描述 | 關鍵元資料 |
|---|---|---|
| Pacticipant | 工作區中註冊的任何應用程式或服務 | 名稱、主分支、儲存庫 URL |
| Pact | 由消費者生成的合約檔案 | 消費者/提供者版本、互動、匹配器 |
| Environment | 諸如 Staging 或 Production 之類的命名部署目標 | UUID、名稱、生產狀態 |
| Matrix | 所有驗證的真值表 | 驗證狀態、版本時間戳記、環境標籤 |
| Provider State | 測試所需的命名先決條件 | 狀態名稱、Pacticipant 名稱 |
PactFlow & Pact 合約測試 進階特性
- AI 驅動的生成：透過 PactFlow Cloud 使用請求/回應對或 OpenAPI 文件，以多種語言建立完整的 Pact 測試。
- 雙向合約測試 (BDCT)：透過直接對比提供者 OpenAPI 規範與消費者 pacts，實現跨合約驗證。
- Can-I-Deploy 閘門：基於合約矩陣的目前狀態，以程式設計方式檢查任何部署的安全性。
- Webhook 管理：透過為合約變更或驗證結果等事件建立並執行 webhooks，實現 CI/CD 觸發器的自動化。
- 網路視覺化：使用 pacticipant 網路工具視覺化相依關係及潛在服務變更的影響範圍。
SKILL.md
加載中
Openclaw 相關技能
Drift Testing
一款功能強大的 API 驗證工具，可捕獲規範漂移，並支援使用 OpenAPI 規範進行雙向契約測試 (Bi-Directional Contract Testing)。
精選*
