一个强大的解析器，可将复杂的 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 相关技能
精选*
