一個強大的解析器，可將複雜的 OpenAPI 3.x 規格轉換為具有完整模式覆蓋率的綜合 Drift 測試用例。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install openapi-parser
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 openapi-parser。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 OpenAPI Parser？
OpenAPI Parser 是一項專為 AI 代理設計的專業工具，旨在解析複雜的 API 規格並構建穩健的測試套件。它擅長解構多態、繼承和深度嵌套參照等複雜模式，而這些模式往往會導致標準產生器失效。透過整合此技能，開發人員可以確保其 Openclaw Skills 工作流程自動覆蓋文件中定義的每一個可能的回應變體和邊界情況。
該技能不僅提供基本的腳手架功能，還為解析 $ref 鏈以及將枚舉模式變體直接對應到 Drift YAML 提供了邏輯框架。它確保產生的測試不僅語法正確，而且經過策略性設計，在不產生冗餘測試用例組合爆炸的情況下最大化測試覆蓋率。
OpenAPI Parser 應用場景
- 為新建或現有的 REST API 產生綜合的 Drift 測試套件。
- 在自動化測試中覆蓋所有多態回應變體 (anyOf/oneOf)。
- 透過負面測試驗證複雜的 regex 模式和枚舉約束。
- 為帶有 discriminators 和繼承的端點構建有狀態測試用例。
- 將 OpenAPI 的 path、query 和 header 參數對應到動態的 Drift 資料集。
OpenAPI Parser 運作原理
- 該技能在提供的 spec.yaml 檔案中定位特定的端點和相關的組件模式。
- 它遞迴解析所有 $ref 鏈，追蹤定義回到原始類型，同時處理繼承 (allOf)。
- 它枚舉每個回應狀態碼的可行組合，識別不同的結構變體，如 discriminator 值或可選欄位簇。
- 它產生 Drift 操作區塊，並使用清晰的 operationId 後綴命名，同時為它們標記以便於篩選。
- 該技能輸出一個最終包，包含結構分析、Drift 操作 YAML 以及任何必要的資料集定義。
OpenAPI Parser 設定指南
要在您的環境中使用 OpenAPI Parser，請確保您可以存取 spec 檔案和相關的參考指南。
# 在 spec 檔案中定位端點
grep -n "^ /path/to/endpoint" spec.yaml
# 遞迴解析特定模式定義
grep -n "SchemaName:" spec.yaml
確保您的專案包含必要的參考檔案：references/schema-patterns.md 和 references/drift-mapping.md，以指導 AI 對複雜物件的理解。
OpenAPI Parser 資料結構與分類體系
該技能透過將 OpenAPI 結構對應到 Drift 特定結構來組織資料：
| OpenAPI 元素 | Drift 對應 | 備註 |
|---|---|---|
operationId |
target |
將測試連結到原始 OAS 端點。 |
anyOf / oneOf |
多項操作 | 每個分支產生一個測試，以實現完全覆蓋。 |
parameters |
parameters 區塊 |
對應到 path, query 或 headers。 |
requestBody |
body / dataset |
使用資料集進行動態測試資料注入。 |
responses |
expected 區塊 |
自動驗證狀態碼和 body 模式。 |
OpenAPI Parser 進階特性
- 多態分支：自動將 anyOf 和 oneOf 模式拆分為不同的測試操作。
- 智慧繼承：合併 allOf 模式組件以建立統一且有效的請求 payload。
- Regex 邊界測試：為受 pattern 屬性約束的欄位產生有效和無效的測試用例。
- 自動模式驗證：透過忽略預期的 body，利用 Drift 的原生驗證功能，允許工具根據原始 OAS 規格驗證回應。
- 身分驗證剝離：專門針對 401 Unauthorized 測試的邏輯，透過顯式排除全域 auth 標籤。
SKILL.md
加載中
Openclaw 相關技能
精選*
